當(dāng)我們按照一定的結(jié)構(gòu)創(chuàng)建了一系列的 Markdown 文件后,即可以工作區(qū)為單位進(jìn)行整體編譯了。
雖然我們?cè)诰庉嬆硞€(gè) Markdown 文件時(shí),隨時(shí)可以按下“F5”鍵來將正在編輯的 Markdown 文件編譯為 Html 文件,并在右工具欄中預(yù)覽。但這樣編譯出來的 Html 文件缺少一些文件間的鏈接。
當(dāng)對(duì)整個(gè)工作區(qū)進(jìn)行編譯時(shí),會(huì)自動(dòng)添加一個(gè)索引文件。此索引文件也是一個(gè) Html 網(wǎng)頁文件,其中包含指向每一個(gè)由 Markdown 文件編譯而來的 Html 頁面的鏈接。
整體編譯的工作區(qū),生成的網(wǎng)頁間的鏈接一般是以相對(duì)引用的形式存在的,所以可以方便地移植到其它目錄。
這樣,要做一個(gè)靜態(tài)的小網(wǎng)站就沒什么難度了。
在編譯好整個(gè)工作區(qū)之后,可以向一個(gè)空白目錄“導(dǎo)出網(wǎng)站”,也可以創(chuàng)建 CHM 工程文件并調(diào)用 Html Help Workshop 來打包為 CHM 幫助文檔的形式。
Html Help Workshop 是微軟公司的軟件,官方提供了免費(fèi)版本,用戶可以自行下載安裝。
普通文檔不太復(fù)雜的情況下,有兩到三級(jí)已經(jīng)夠用了。
當(dāng)然,如果用戶不需要編譯的 Html 網(wǎng)頁中的標(biāo)題支持折疊/展開功能,也可以在編譯時(shí)關(guān)閉此一選項(xiàng)。
此功能包括三種選項(xiàng),只能選擇其中之一:
自動(dòng)折疊選項(xiàng):編譯后生成的 Html 網(wǎng)頁中每個(gè)標(biāo)題都是處于折疊狀態(tài)的。直到用戶用鼠標(biāo)左鍵點(diǎn)擊某個(gè)標(biāo)題者會(huì)顯示其下屬的子標(biāo)題和其它內(nèi)容。
手動(dòng)折疊選項(xiàng):編譯后生成的 Html 網(wǎng)頁中每個(gè)標(biāo)題都支持折疊/展開功能,但默認(rèn)是處于“展開”狀態(tài)。直到用戶用鼠標(biāo)左鍵點(diǎn)擊某個(gè)標(biāo)題,它者會(huì)折疊起來。
不折疊:編譯后生成的 Html 網(wǎng)頁中的所有標(biāo)題都不支持“折疊/展開”功能,與普通靜態(tài)頁面無異。
在編譯六級(jí)標(biāo)題時(shí),LME 還可以自動(dòng)添加編號(hào)。點(diǎn)擊此菜單可以切換開關(guān)。
<code>塊如果在一行普通文本內(nèi)部,在 Markdown 可以使用一對(duì)反引號(hào)來包圍(例如:`ABC`),這樣編譯好的 Html 中就會(huì)用一對(duì) Html 的 <code></code>標(biāo)簽來包圍(形如:<code>ABC</code>)。
打開這個(gè)選項(xiàng)時(shí),編譯出來的 Html 文檔中,默認(rèn)不顯示 ABC,而是只顯示一個(gè)線框。當(dāng)用戶用鼠標(biāo)左鍵單擊此線框所在的段落時(shí),才會(huì)顯示線框中的文本。
這個(gè)功能是給老師們制作填空題用的。開啟此選項(xiàng)就是填空題;關(guān)閉此選項(xiàng)就是表示強(qiáng)調(diào)。通常我用它來表示快捷鍵組合等。
當(dāng) Markdown 文檔比較復(fù)雜,其中包括的標(biāo)題比較多時(shí),編譯出來的 Html 文檔的尺寸也會(huì)比較大,當(dāng)用戶需要在頁面內(nèi)快速跳轉(zhuǎn)時(shí),使用左邊欄菜單就比較方便了。
LME 編譯生成的 Html 文檔可以為每個(gè)標(biāo)題都生成一個(gè)定位錨,并在左邊欄菜單中添加指向這些錨的鏈接。用戶瀏覽時(shí)可以實(shí)現(xiàn)向某個(gè)標(biāo)題的快速跳轉(zhuǎn)。
如果我們需要某個(gè) Markdown 文檔編譯后的 Html 文件帶左邊欄菜單,可以手動(dòng)在 Markdown 文件內(nèi)添加一行注釋:
;[Menu]:xxx
這行注釋告訴編譯器,要編譯出一個(gè)左邊欄菜單。其中“xxx”可以是任意文本。注意:如果當(dāng)前 Markdown 文件中一個(gè)標(biāo)題都沒有,此行注釋不起作用。
當(dāng)我們需要每個(gè)文件都盡可能編譯出左邊欄菜單,又懶得每個(gè)文件都去寫這行注釋時(shí),可以打開此選項(xiàng)。
此時(shí),無論 Markdown 文件中是否有上面這行注釋文本,都會(huì)強(qiáng)制嘗試編譯出左邊欄菜單。
LME 還支持輸入一些試題文本并在編譯 Html 文件時(shí)作特定處理。打開此選項(xiàng)可以出卷,此時(shí)不顯示試題答案與解析;關(guān)閉此選項(xiàng)可以用來做教案,此時(shí)會(huì)直接顯示答案與解析。
開啟時(shí):
關(guān)閉時(shí):
只支持兩種編碼方式,編譯 Html 文檔時(shí)可任選一種:
這種格式支持更多的字符,制作靜態(tài)小網(wǎng)站時(shí)建議使用、特殊字符較多時(shí)建議使用。
這種格式適合用來打包 CHM 文件,因?yàn)?CHM 是種比較老的文件格式,它對(duì) Unocode 字符的支持比較差。
默認(rèn)情況下,編譯出來的 Html 文件末尾會(huì)自帶編譯時(shí)間字樣。如果不需要,可以關(guān)閉此選項(xiàng)。
無論是否格式化編譯好的 Html 文檔,對(duì)瀏覽器的呈現(xiàn)都沒有影響。
當(dāng)需要閱讀編譯生成的 Html 源文件時(shí),建議開啟此選項(xiàng)。缺點(diǎn)是編譯速度較慢。
LME 支持對(duì) Markdown 文件進(jìn)行簡單的加密。在編譯被加密且未被順利打開的 Markdown 文件時(shí),需要輸入密碼。當(dāng)編譯工作區(qū)時(shí),如果每編譯一個(gè)加密文件就輸入一次密碼會(huì)十分繁瑣。此時(shí)打開此選項(xiàng)——于是世界清凈了。
更多建議: