asciidoc

我在一個月的午餐中編寫“ 學習Linux”時發現了AsciiDoc 。 AsciiDoc是一種用于編寫書籍的非常詳盡的標記語言-想想Markdown ，但是具有更多選項，例如邊欄，注釋和表格。 AsciiDoc允許您通過簡單的語法來控制格式鍵入。

剛開始寫書時，我在LibreOffice中使用Word樣式表。 我的出版商曼寧（Manning）為OpenOffice提供了.odt版本，但是我無法使樣式起作用。 具有諷刺意味的是，我最后使用了Word .docx模板，該模板最適合LibreOffice。 但是最大的問題是圖像，無法正確嵌入。 當我需要寫作時，我花費了大量時間格式化。

評論也很難解析。 吉姆·懷特赫斯特（Jim Whitehurst）在寫《開放組織》一書時實際上為LibreOffice 打補丁以處理評論 。 經過幾章的模板工作之后，我的編輯建議我們改用AsciiDoc，我的生活立即變得更輕松。

使用LibreOffice，我必須插入圖像，對其進行編號，為其添加標題，對其進行樣式設置，然后希望所有內容都結合在一起，而對于AsciiDoc，我需要編寫以下內容：

.Mint的軟件管理器外觀與Ubuntu軟件中心類似。

AsciiDoc會為我處理其他所有事情，包括為字幕中的圖像編號。 上面的代碼就是這樣呈現的：

^{AsciiDoc轉換為PDF。}

側邊欄或注釋就像這樣簡單：

^{注釋的AsciiDoc語法。}

變成這樣：

^{呈現為PDF的注釋的AsciiDoc語法。}

AsciiDoc具有標題和副標題的格式，甚至可以基于它們自動生成目錄：

^{AsciiDoc自動生成一個目錄。}

由于AsciiDoc是文本，因此您可以在任何文本編輯器中編寫代碼，但是我想預覽代碼以確保一切正常。 有一個Gedit插件，但是使用它會需要一些努力，而我正趕上最后期限。 我決定使用GitHub創建的文本編輯器Atom 。 Atom有一個渲染AsciiDoc的插件，我在編寫幾章時曾嘗試過，但是預覽有時很特殊。 注釋和側欄將擴展到整個文檔。 另外，我無法直接用它打開AsciiDoc格式的文檔。 相反，我必須先打開Atom，然后通過Atom打開菜單打開文檔。

Atom很好，但很煩人，我決定嘗試使用Adobe開源文本編輯器Brackets 。 括號使AsciiDoc變得更好，盡管打開AsciiDoc文件仍然不是無縫的，但它比Atom更好。 我希望Brackets具有運行中的拼寫檢查功能，而不是能夠在完成后運行拼寫檢查功能，但是它可以預覽我需要查看的內容并為我提供運行中的字數統計功能，所以我很高興。

^{括號文本編輯器。}

^{由Brackets呈現的AsciiDoc。}

括號和Atom使用HTML渲染，但是a2x命令是AsciiDoc軟件包的一部分，使將.adoc文件轉換為PDF變得容易（盡管當圖像文件名稱中帶有句點時，錯誤會導致轉換失敗）。 輸出看起來像是專業格式化的書章。

AsciiDoc一直是我的救星，我很幸運能與使用它的發行商合作。 我認為AsciiDoc可以為需要美觀PDF或對自發布感興趣的任何人提供應用程序。 同樣，AsciiDoc對開放式教育資源也具有巨大的影響，因為它允許某人編寫課本而不必格式化它。 他們將輕松準備好PDF，并且可以將基礎AsciiDoc提供給想要修改原始文檔的人員。

對于像我這樣不想處理格式的人來說，像AsciiDoc這樣的標記語言非常適合。 移至AsciiDoc后，我們可以使用私有git存儲庫來回提交草稿。 AsciiDoc還具有注釋掉文本的功能，這使我們可以共享文本中的注釋。 AsciiDoc節省了我編寫本書的時間，因為它使我可以專注于編寫而不是樣式和格式。 如果您還沒有嘗試過AsciiDoc，請嘗試一下，讓我們知道您在評論中的想法。

最初發布在MyLinuxRig.com上 。 經許可重新發布。

文件
碟

本文是Rikki Endsley協調的Doc Dish專欄的一部分。 要撰寫本專欄文章，請提交您的故事創意或與我們聯系 。

翻譯自: https://opensource.com/life/15/10/asciidoc

asciidoc

總結

以上是生活随笔為你收集整理的asciidoc_使用AsciiDoc编写文档的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。