從 2.0.0 版本起,GitBook 也能支持 AsciiDoc 作為輸入的格式。
關(guān)于這個(gè)格式的更多信息請(qǐng)參考 AsciiDoc Syntax Quick Reference。
和 markdown 一樣,GitBook 也使用了一些特殊的文件來(lái)提取書(shū)本的結(jié)構(gòu):README.adoc,SUMMARY.adoc 和 GLOSSARY.adoc。
這是書(shū)本的最重要項(xiàng)目:介紹。這個(gè)文件是必須的。
這個(gè)文件定義了章節(jié)和子章節(jié)的列表。和 markdown 文件一樣,SUMMARY.adoc 的格式是簡(jiǎn)單的鏈接列表,鏈接的名字是章節(jié)的名字,鏈接的目標(biāo)是章節(jié)文件的路徑。
子章節(jié)被簡(jiǎn)單的定義成添加到父章節(jié)的內(nèi)嵌列表。
= Summary
. link:chapter-1/README.adoc[Chapter 1]
.. link:chapter-1/ARTICLE1.adoc[Article 1]
.. link:chapter-1/ARTICLE2.adoc[Article 2]
... link:chapter-1/ARTICLE-1-2-1.adoc[Article 1.2.1]
. link:chapter-2/README.adoc[Chapter 2]
. link:chapter-3/README.adoc[Chapter 3]
. link:chapter-4/README.adoc[Chapter 4]
.. Unfinished article
. Unfinished Chapter
對(duì)于 多語(yǔ)言 書(shū),這個(gè)文件是用來(lái)定義支持的語(yǔ)言和翻譯。
這個(gè)文件遵循 SUMMARY.adoc 一樣的語(yǔ)法:
= Languages
. link:en/[English]
. link:fr/[French]
這個(gè)文件是用來(lái)定義術(shù)語(yǔ)的。請(qǐng)查看 術(shù)語(yǔ)表 那章節(jié)。
= Glossary
== Magic
Sufficiently advanced technology, beyond the understanding of the observer producing a sense of wonder.
== PHP
+A popular web programming language, used by many large websites such as Facebook. Rasmus Lerdorf originally created PHP in 1994 to power his personal homepage (PHP originally stood for "Personal Home Page" but now stands for "PHP: Hypertext Preprocessor").
更多建議: