Einführung

In diesem Artikel möchte ich die Fähigkeiten von Asciidoc berücksichtigen, um sicherzustellen, dass die Anforderungen der Dokumente den Anforderungen eines einheitlichen Systems für die Konstruktionsdokumentation (ESKD) entsprechen, insbesondere GOST R 2.105-9 (im Folgenden: GOST ESKD). Warum genau Asciidoc, schrieb ich hier .

Ich werde sofort klären. Die Formatierung von Dokumenten wird hier nicht behandelt. Der Ersteller der Dokumentation sollte sich nicht um die Formatierung kümmern müssen. Als Systemanalytiker erstelle ich Inhalte und kontrolliere deren Struktur. Um ein Dokument zu erhalten, das GOST ESKD oder einem ähnlichen Standard entspricht, muss ich auf die Schaltfläche drücken und ein korrekt formatiertes Dokument mit den erforderlichen Optionen erhalten: PDF, Dokument öffnen (Libre

Office / Open Office), Open XML (Microsoft Word) und Andere.

Nach der Arbeit an https://github.com/CourseOrchestra/asciidoctor-open-document bin ich sicher,

dass alle Formatierungsprobleme mit angemessenem Aufwand gelöst werden.

Betrachten Sie die Struktur eines Asciidoc-Dokuments, das die Anforderungen von

GOST ESKD erfüllt.

Erstellen eines Dokuments

6.1.1 , Asciidoc .

=  
[preface]
== 
==   
==   
==     (, «  »)
[appendix]
==  (, « »)
==   
==  
[bibliography]
== 
==   
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

: « », . , , , : , (), () .. .

:mesto-sostavleniya: 
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

, 7.79-2000 ( ). , , , .

, =



.

( 6.2 ) .

«» ( 6.3 ), «» ( 6.4. ) «» :

• preface
  
  
  
  Asciidoctor ,
  
  ;

  
  
  
  
  
  
  

• appendix
  
  
  
  ;

  
  
  
  
  
  
  

• bibliography
  
  
  
  
  
  .

  
  
  
  
  
  
  

, [asciidoctor-bibtex] https://github.com/asciidoctor/asciidoctor-bibtex).

BibTeX.

@Book{viz,
 author    = {, . .},
 title     = {  },
 publisher = {},
 year      = 1921,
 address   = ,
 lang=ru
}
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

.

:bibtex-file:      BibTeX

    ,    cite:[viz(24)].

[bibliography]
==   
bibliography::[]
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

6.5 . // :

== 
=== 
==== 
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

secnums



.

Asciidoc (, ) , [.punkt]. .

[.punkt]
==== 
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

6.7 . Asciidoc :

. 
.  
.  
..   
+
    
.  
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

: . , Asciidoc . .

, . +



.

. .

. 
*  
*  
.   
+
    
*  
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

Asciidoc .

, 1 ( 6.8.1).

. 
[cols="2,1,1,1,1", hrows=2]
|====
.2+|
2+|  1
2+|  2

|  1.1
|  1.2
|  2.1
|  2.2

|  1
|
|
|
|

|  2
|
|
|
|

|  3
|
|
|
|

|====
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

. .

, , «». .

cols



(cols = "2,1,1,1,1"



) , 5 , .

hrows



. , .

hrows



Asciidoctor , https://github.com/CourseOrchestra/asciidoctor-plugins. options="header"



, ,

.

« » () , . 6.8.7 .

(|



). , .

, .2+|



. , , : 2+|



.

( 6.9 ) :

. 
image::  [ ]
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

, .

, .

, , . .

, . , . , . , , , , .

Open Document, , . . , . MS Word, .

Asciidoctor Asciidoctor Diagram , .

.

[plantuml, png]
....
@startuml
rectangle " 1" as c1
rectangle " 2" as c2
rectangle " 3" as c3
c1 <-> c2
c1 .. c3
c2 == c3
@enduml
....
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

:

, .

( 6.10 ) : . LaTeX/Mathematics:

[latexmath]
++++
\begin{bmatrix}
a & b \\
c & d
\end{bmatrix}\binom{n}{k}
++++
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

. Asciidoc, , - , .

[formula-poyasnenie]
 stem:[a] --    ; +
stem:[b] --    ; +
 ..
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

stem



, .

+



. .

: , .. , .

( 6.11 ) Asciidoc : , , . , :

[[moya-diagramma]]
. 
image::moya-diagramma.jpg[]
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

.

     (<<moya-diagramma>>).
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

:

     ( 1).
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

html- (, ) « 1» .

, «» . , ,  —  .

( 6.13 ) Asciidoc .

  footnote:f1[ ]
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
    

f1  —  , , .

1. Asciidoc .

   
   
   
   
   
   
   

2. Asciidoc 2.105—9.

   
   
   
   
   
   
   

3. Sie können MS Word-Stile vergessen und sich auf den Inhalt der von
   
   Ihnen erstellten Dokumente konzentrieren .