pengantar
Pada artikel ini, saya ingin mempertimbangkan kemampuan Asciidoc dalam hal memastikan persyaratan kepatuhan dokumen dengan persyaratan sistem terpadu untuk dokumentasi desain (ESKD), khususnya GOST R 2.105-9 (selanjutnya disebut GOST ESKD). Kenapa tepatnya Asciidoc, saya tulis di sini .
Saya akan segera mengklarifikasi. Pemformatan dokumen tidak tercakup di sini. Pembuat dokumentasi tidak perlu khawatir tentang pemformatan. Sebagai analis sistem, saya membuat konten dan mengontrol strukturnya. Untuk mendapatkan dokumen yang sesuai dengan GOST ESKD atau standar serupa lainnya, saya harus menekan tombol dan mendapatkan dokumen yang diformat dengan benar dalam opsi yang diperlukan: pdf, Open Document (Libre
Office / Open Office), Open XML (Microsoft Word) dan orang lain.
Setelah mengerjakan https://github.com/CourseOrchestra/asciidoctor-open-document, saya yakin
bahwa semua masalah pemformatan diselesaikan dengan upaya yang memadai.
Pertimbangkan struktur dokumen Asciidoc yang memenuhi persyaratan
GOST ESKD.
Membangun dokumen
6.1.1 , Asciidoc .
= [preface] == == == == (, « ») [appendix] == (, « ») == == [bibliography] == ==
: « », . , , , : , (), () .. .
:mesto-sostavleniya:
, =
.
( 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 — , , .
Asciidoc .
Asciidoc 2.105—9.
Anda dapat melupakan gaya MS Word dan berkonsentrasi pada konten
dokumen yang Anda buat.