Asciidoc角色和gitbook

我想使用Gitbook和AsciiDoc（運行Win10x64，NodeJS 6.9.1和Gitbook v3.2.2） - 我是他們倆的新手。因爲V2.0.0和鏈接AsciiDoctor documentation Asciidoc角色和gitbook

The Gitbook documentation says AsciiDoc是一個支持 - 我已經檢查了節點程序包，gitbook取決於gitbook-asciidoc而這又取決於asciidoctor.js。

根據文檔，AsciiDoc角色可用於樣式圖像和表格。它們引用應用於HTML元素的類，這些類在默認的AsciiDoctor對象表中定義。

但無論我如何嘗試應用角色，例如對於圖像（[.text-center]速記或[role="text-center"]，我都沒有得到預期的輸出（即圖像水平居中）。我唯一能做到的方式通過設置屬性align =「center」，它甚至沒有記錄

通過檢查我的瀏覽器中的輸出，我可以看到類被應用到HTML元素，但沒有匹配的CSS規則 - 對於表格樣式，我也嘗試過。

我在這裏錯過了關於AsciiDoctor角色和樣式表的內容嗎？

編輯：asciidoctor.js是gitbook的開發依賴並且實際上沒有與gitbook一起安裝。在AsciiDoc documentation中記錄了align="center"，但其他功能（如表格樣式（至少frame="none"和grid="none"）似乎不適用於gitbook。

我還是不明白爲什麼Gitbook文檔鏈接回AsciiDoctor的一個，如果不是支持它...

來源

2017-06-16 sclarckone

當您在使用GitBook語法AsciiDoc，AsciiDoctor用於將AsciiDoc語法轉換成HTML。 HTML然後使用GitBook CSS，因爲您使用的是GitBook主題而不是AsciiDoctor主題。這意味着你不會得到默認的AsciiDoctor樣式。

在GitBook中添加自己的樣式很容易。在你book.json，指定一個額外的樣式表：

"styles": { 
    "website": "styles/mystyles.css" 
},

然後，創建styles/mystyles.css，使其包含您要使用的CSS樣式：

.text-center { 
    text-align: center; 
}

您可以從AsciiDoctor樣式複製樣式到styles/mystyles.css ，但要準備好調整樣式和類以在您正在使用的GitBook主題中工作。

來源

2017-08-09 15:17:03 eskwayrd

Asciidoc角色和gitbook

回答

相關問題