AsciiDoc：如何指定HTML輸出字體？

Question

在AsciiDoc輸入.txt文件中尋求一種簡單的指令，用於指定默認輸出字體（即將字體族更改爲Calibri;但也希望控制粗體，斜體和其他樣式）以更改HTML輸出。

可選：想爲文檔的特定部分（例如內容中的一行或兩行）製作自定義字體更改標註。

如果需要css控件，我可以處理它，但需要在過程/設置中列出每個功能步驟。

Answer 1

我是AsciiDoc自己的新手，但這可能足以讓你走。不幸的是，在你的AsciiDoc輸入文件中似乎沒有一種簡單的方法來用簡單的指令設置自定義樣式。最終，AsciiDoc只是include s樣式表文件到您的輸出（經過一些相當複雜的邏輯，取決於後端）。

最簡單的選擇似乎是創建自己的主題。該AsciiDoc用戶手冊裏有關於如何做到這一點（八九不離十）的說明，但本質：

1. 查找下無論AsciiDoc是一個安裝
2. 複製現有主題themes目錄（「燒瓶」似乎是默認） 。在版本8.6.6之前，它只是一組CSS文件。 8.6.6及以上版本，它是一組目錄。
3. 編輯主題以符合您的喜好。
4. 使用theme文檔屬性或--theme <name>命令行選項（8.6.6和更高版本）或--attribute theme=<name>（8.6.6之前）指定樣式表。

這種方法的缺點是您的主題必須與其他主題一起存在。似乎沒有辦法改變它，或者我只是不知道它。符號鏈接可以工作，如果這是你的情況的選擇。

另一種可能性是更極端的一點，但如果您願意的話，可以讓您保留自己的風格和數據。有一點免責聲明：我通過查看AsciiDoc源代碼來了解它，但沒有記錄，所以它可能在以後的版本中發生變化。我懷疑它，但值得注意。我也只做了一個快速測試，但它似乎工作。

1. 如果您還沒有配置文件，請創建一個配置文件。
2. 其中創建一個[header]部分（這不是一個記錄的配置文件部分，但我已經注意到它在後端的.conf文件中）。
3. 我不知道你使用的後端是哪一個，找到它的.conf文件，找到[header]部分，複製整個部分並粘貼到你的配置文件中。可能有多個，所以尋找任何「看起來不錯」。

4. 編輯配置文件的[header]部分。您的目標是提取任何決策代碼。例如，對於html後端（這只是xhtml11的別名），我會刪除ifdef宏，並用一個include1宏替換它們以包含我的CSS文件。所以我最終得到的是這樣的：

   [header] 
   <DOCTYPE html ... yadda yadda 
   <!-- snip: a bunch of meta elements and such --> 
   <title>{title}</title> 
   <style type="text/css"> 
   include1::style.css[] 
   </style> 
   

5. 告訴AsciiDoc使用您的配置文件，使用命令行選項或文檔屬性。

嘗試了這種後一種方法，從我嘗試過的樣本中「刪除」XHTML頭，但我並沒有超出這個範圍。如果第一種方法不符合你的喜好，希望第二種方法可行。

至於自定義字體變化呼出，我可能會使用一個直通塊：

++++++++++++++ 
<span id="foo">content goes here</span> 
++++++++++++++ 

但是請注意，它的後端特有的，這個例子是HTML，如果我是正確的（我有點生疏）。我對AsciiDoc不太熟悉，建議更好。

Answer 2

我剛開始我看Asciidoc和被激怒沒有找到

1. 鏈接自定義CSS樣式表
2. 排除在輸出文件的標頭中的CSS部分中的記錄方式。

如果不採取所有這些在Write your own AsciiDoc theme for HTML5 backend with SASS中描述的步驟，我發現至少爲命令行以下操作：

asciidoc -b html5 -a linkcss -a stylesdir=$PWD myfile.txt 

在這種情況下，樣式表的名稱必須是默認，即asciidoc.css 這符合上述要求。