第04節(jié) Markdown編譯整個工作區(qū)

2018-08-09 15:16 更新

  當我們按照一定的結(jié)構(gòu)創(chuàng)建了一系列的 Markdown 文件后,即可以工作區(qū)為單位進行整體編譯了。

  雖然我們在編輯某個 Markdown 文件時,隨時可以按下“F5”鍵來將正在編輯的 Markdown 文件編譯為 Html 文件,并在右工具欄中預覽。但這樣編譯出來的 Html 文件缺少一些文件間的鏈接。
  當對整個工作區(qū)進行編譯時,會自動添加一個索引文件。此索引文件也是一個 Html 網(wǎng)頁文件,其中包含指向每一個由 Markdown 文件編譯而來的 Html 頁面的鏈接。

  整體編譯的工作區(qū),生成的網(wǎng)頁間的鏈接一般是以相對引用的形式存在的,所以可以方便地移植到其它目錄。

  這樣,要做一個靜態(tài)的小網(wǎng)站就沒什么難度了。

  在編譯好整個工作區(qū)之后,可以向一個空白目錄“導出網(wǎng)站”,也可以創(chuàng)建 CHM 工程文件并調(diào)用 Html Help Workshop 來打包為 CHM 幫助文檔的形式。

  Html Help Workshop 是微軟公司的軟件,官方提供了免費版本,用戶可以自行下載安裝。


編譯選項說明

<H1>-<H6>折疊

  Markdown 中以“#”開頭的行被視為標題行。以兩個“##”開頭的就是二級標題,依此類推。它們會被分別編譯為 Html 中的<H1>-<H6>這六級標題。
  普通文檔不太復雜的情況下,有兩到三級已經(jīng)夠用了。
  LME 對標題進行了專門的優(yōu)化,不但在編輯 Markdown 時可以按照標題層級折疊/展開,也可以支持編譯后的 Html 網(wǎng)頁中折疊/展開標題。
  當然,如果用戶不需要編譯的 Html 網(wǎng)頁中的標題支持折疊/展開功能,也可以在編譯時關閉此一選項。

  此功能包括三種選項,只能選擇其中之一:


  • 自動折疊

  自動折疊選項:編譯后生成的 Html 網(wǎng)頁中每個標題都是處于折疊狀態(tài)的。直到用戶用鼠標左鍵點擊某個標題者會顯示其下屬的子標題和其它內(nèi)容。


  • 手動折疊

  手動折疊選項:編譯后生成的 Html 網(wǎng)頁中每個標題都支持折疊/展開功能,但默認是處于“展開”狀態(tài)。直到用戶用鼠標左鍵點擊某個標題,它者會折疊起來。


  • 不折疊

  不折疊:編譯后生成的 Html 網(wǎng)頁中的所有標題都不支持“折疊/展開”功能,與普通靜態(tài)頁面無異。


<H1>-<H6>自動編號

  在編譯六級標題時,LME 還可以自動添加編號。點擊此菜單可以切換開關。



<code>編譯為填空

  <code>塊如果在一行普通文本內(nèi)部,在 Markdown 可以使用一對反引號來包圍(例如:`ABC`),這樣編譯好的 Html 中就會用一對 Html 的 <code></code>標簽來包圍(形如:<code>ABC</code>)。

  打開這個選項時,編譯出來的 Html 文檔中,默認不顯示 ABC,而是只顯示一個線框。當用戶用鼠標左鍵單擊此線框所在的段落時,才會顯示線框中的文本。


  這個功能是給老師們制作填空題用的。開啟此選項就是填空題;關閉此選項就是表示強調(diào)。通常我用它來表示快捷鍵組合等。

強制編譯左邊欄頁面菜

  當 Markdown 文檔比較復雜,其中包括的標題比較多時,編譯出來的 Html 文檔的尺寸也會比較大,當用戶需要在頁面內(nèi)快速跳轉(zhuǎn)時,使用左邊欄菜單就比較方便了。

  LME 編譯生成的 Html 文檔可以為每個標題都生成一個定位錨,并在左邊欄菜單中添加指向這些錨的鏈接。用戶瀏覽時可以實現(xiàn)向某個標題的快速跳轉(zhuǎn)。

  如果我們需要某個 Markdown 文檔編譯后的 Html 文件帶左邊欄菜單,可以手動在 Markdown 文件內(nèi)添加一行注釋:

;[Menu]:xxx
  這行注釋告訴編譯器,要編譯出一個左邊欄菜單。其中“xxx”可以是任意文本。

  注意:如果當前 Markdown 文件中一個標題都沒有,此行注釋不起作用。

  當我們需要每個文件都盡可能編譯出左邊欄菜單,又懶得每個文件都去寫這行注釋時,可以打開此選項。


  此時,無論 Markdown 文件中是否有上面這行注釋文本,都會強制嘗試編譯出左邊欄菜單。


隱藏試題答案與解析

  LME 還支持輸入一些試題文本并在編譯 Html 文件時作特定處理。打開此選項可以出卷,此時不顯示試題答案與解析;關閉此選項可以用來做教案,此時會直接顯示答案與解析。

  開啟時:


  關閉時:



編碼方式

  只支持兩種編碼方式,編譯 Html 文檔時可任選一種:

  • UTF-8

  這種格式支持更多的字符,制作靜態(tài)小網(wǎng)站時建議使用、特殊字符較多時建議使用。

  • GB2312

  這種格式適合用來打包 CHM 文件,因為 CHM 是種比較老的文件格式,它對 Unocode 字符的支持比較差。


在 Html 末尾附加編譯時間

  默認情況下,編譯出來的 Html 文件末尾會自帶編譯時間字樣。如果不需要,可以關閉此選項。


格式化編譯的 Html 文檔

  無論是否格式化編譯好的 Html 文檔,對瀏覽器的呈現(xiàn)都沒有影響。

  當需要閱讀編譯生成的 Html 源文件時,建議開啟此選項。缺點是編譯速度較慢。


忽略加密文件

  LME 支持對 Markdown 文件進行簡單的加密。在編譯被加密且未被順利打開的 Markdown 文件時,需要輸入密碼。當編譯工作區(qū)時,如果每編譯一個加密文件就輸入一次密碼會十分繁瑣。此時打開此選項——于是世界清凈了。










以上內(nèi)容是否對您有幫助:
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號