Markdown To CHM(LME)v0.0.6.66 預覽版

Markdown To CHM是一款重型的markdown編輯器。它不是用來編寫單個的 Markdown 文件的，而是用來編寫一係列 Markdown 文件並對它們之間的關係進行輔助處理。

【功能特點】

      1. 自動管理鏈接

      2. 支持非實時預覽(按 F5)

      3. 支持正則表達式

      4. 支持自定義腳本增強編輯功能(通過 IronPython)

      5. 支持自定義 CSS 文件

      6. 支持諸多輔助編輯功能

      7. 支持 Markdown 高亮顯示

      8. 支持引入第三方 javascript 庫

      9. 支持樹型文字表和二維文字表等自定義元素

      10. 支持任務列表

【工具局限】

      1. 由於需要實現一些特定的功能，LME 自行擴展(或屏蔽)了 Markdown 語法——這種差異雖然不大，但為一些 Markdown  用戶不喜。

      > Markdown 的發明者認為 Markdown 不應該被標準化。

      2. LME 對理工科的支持不夠完善，要錄入公式，高亮顯示代碼等需要引入第三方 Javascript 庫。

      > LME 不直接嵌入對這些第三方開源庫的支持，一方麵是因為版權問題不便解決;另一方麵是因為這些庫對 CHM  文檔的兼容性往往很成問題。——CHM 是種很老的文件格式，對新 Javascript 庫的適應性很差。

【軟件特色】

　　Markdown 的語法高亮顯示不是太好做——各語法元素很容易相互衝突——所以這個功能不是很完善。

　　有時會發現語法高亮顯示不是太準確，這對編譯 Html 文檔不會產生影響。隻要保證沒寫錯，編譯出來就不會有問題。

　　Markdown 使用一些簡單的字符表示某種需要轉譯為 html 標簽的格式定義。這些格式標誌字符通常都是英文的。

　　文本格式化

　　由於支持中文格式字符，為便於在其它Markdown編輯器中查看和編輯，還提供了文本格式化功能，大部分中文格式字符會被標準Markdown英文格式字符替換。

　　但為了文字表的整齊，不會將全角的豎線、冒號等進行對齊替換。

　　點擊格式→格式化文本→保存前自動格式化菜單項，使此菜單項被勾選，即可在保存前自動進行文本格式化；再點擊一下，去除此菜單項前的對勾，保存前不會自動格式化。

　　需要再次強調的是：無論是否對 Markdown 文本格式化，都不影響最終編譯生成 Html的效果。

　　試題編輯、演示功能

　　可以編輯一些選擇（含判斷）、填空、材料解析題來演示，也可以轉譯為 Html。

　　演示時，試題不會直接顯示答案，可以向學生提問。而轉譯成 Html 時則會直接將答案、解析都標示出來。

　　試題的每個組成部分都有些格式字符，這些格式字符大多是由漢字和特殊符號組成的——但不需要手工輸入漢字——程序提供了自動完成功能，並且支持漢字拚音首字母快速輸入。

　　無論是在編輯時還是轉譯為 Html 後，都支持折疊功能。但編輯時支持所有6級標題的折疊，轉換為 Html 文檔後隻支持對一級標題的折疊。

　　可以在文件中定義編譯左邊欄菜單，菜單中每個鏈接指向編譯後的 Html 中的某個標題。

【適用場景】

      1. 編寫靜態微型網站

      LME 可以將用戶編寫的 Markdown 文檔編譯為 Html 文件。

      2. 創建 CHM 工程文件，並調用 Html Help Workshop 編譯

      通過調用微軟 Html Help Workshop 自帶的編譯器，LME 可以創建 CHM 工程文件，並將工作區中所有 Html  文件及其相關資源文件打包為標準的 CHM 文檔。

【官方教程】

　　1.1.創建目錄元文件的方式

　　對於目錄元文件，不需要用戶進行特殊的操作——需要的時候，直接用鼠標左鍵雙擊工作區管理器中的普通目錄條目（包括工作區根目錄）即可。

　　1.2.創建 Markdown 文件的方式

　　在工作區管理器上選擇任意一個普通子目錄，然後單擊鼠標右鍵，在彈出的快捷菜單中用鼠標左鍵點擊新建文件條目，即可在該目錄下創建一個 Markdown 文件。

　　打開目錄元文件

　　每個子目錄（包括工作區目錄本身）都可以有一個對應的元文件。

　　元文件也是 Markdown 文件，但其行為與普通文件稍有區別。

　　支持元文件的目的是將整個工作區編譯為 CHM 文件時，每個目錄也能支持一個對應的網頁。

　　元文件自動命名，命名規則是：

　　_目錄名.md

　　要打開一個目錄的對應元文件，隻須在工作區管理器中找到這個目錄的對應條目，用鼠標左鍵雙擊就可以了。

　　如果該子目錄還沒有元文件，會自動創建一個。

　　目錄元文件在創建 CHM 工程文件時會將編譯好的 Html 頁麵文件指向該目錄條目。

　　它與 CHM 條目的對應關係如下：

　　生成CHM工程文件

　　1.創建 CHM 工程文件

　　1.1.創建 CHM 工程文件後需要 Html Help Workshop 來進行下一步工作

　　2.避免編譯好的 CHM 目錄中出現序號的辦法

　　當所有子目錄、目錄元文件與其它 Markdown 文件都編輯完成後，就可以創建 CHM 工程文件了。

　　創建好的 CHM 工程文件可以直接用微軟公司的 Html Help Workshop 打開並編譯為 CHM 幫助文檔。

　　新版本的 LME 中，CHM 工程文件、目錄文件、索引文件的創建工作以及調用 HHC 來編譯 CHM 文件的操作已經整個傻瓜化了——點一次菜單即可。

　　但是還是要先安裝微軟公司的 Html Help Workshop 的。

　　以下內容已廢棄！

　　1.創建 CHM 工程文件手工編寫 CHM 工程文件是個很繁瑣的工作，現在隻需要點點鼠標、然後稍加修改就成了。

　　創建CHM工程文件

　　如果你之前已經創建過 CHM 工程文件，會彈出：

　　創建-CHM-工程的警告框

　　除非你不打算再保留上次創建的 CHM 工程文件（包括目錄、索引文件），否則應該堅決地選擇否(n)。

　　由於微軟公司的 Html Help Workshop 實際上對 Unicode 編碼支持很差，所以要編譯為 CHM 文檔還是應該使用 GB2312 編碼來把工作區中的 Markdown 文件編譯為 Html 頁麵文件。

　　在創建 CHM 工程時，會自動編譯整個工作區中所有 Markdown 文檔。

　　提示編譯整個工作區

　　一般來說應該選擇是(y)。

　　1.1.創建 CHM 工程文件後需要 Html Help Workshop 來進行下一步工作

　　如果你已經安裝了 Html Help Workshop，並且已經在本程序中指定了 Html Help Workshop 可執行文件的路徑，那麼就會像下麵這樣：

　　HtmlHelpWorkshop啟動界麵

　　如果你已經安裝了 Html Help Workshop，並且還是微軟公司的官方英文版。一般來說 LME 會自動找到它。

　　Html Help Workshop 應用程序的微軟公司官方下載地址在這裏。

　　但如果你下載的是網上流傳的修改版（例如一些很好用的漢化版，上麵這張圖就是漢化版），通常需要手工指定 Html Help Workshop 應用程序到底安裝在磁盤的哪個位置。

　　如果還沒有告訴 Markdown To CHM(LME) 它在哪兒，那麼根據提示找到 Html Help Workshop 可執行程序即可。

　　安裝後的 Html Help Workshop 的可執行文件有較大的概率出現在這個路徑：

　　“C:Program FilesHTML Help Workshophhw.exe”

　　實際上它出現在哪裏取決於用戶的操作。

　　工作區目錄決定CHM目錄

　　2.避免編譯好的 CHM 目錄中出現序號的辦法避免目錄序號

　　從上圖我們可以看到，可以手工在 Markdown 文件內部為文檔設置一個標題，這個標題可以與文件短名不同，且編譯為 CHM 文檔時，條目名優先使用文檔內部設置的標題。

　　所以，可以放心地在工作區管理器中各文件、文件夾名稱頭部使用大量的數字來進行排序。

【更新日誌】

      v0.0.6.18

      + 為用戶自定義語法提供幾種高亮顯示效果。

      + 實現“複製當前工作區目錄結構並創建新工作區”功能。

      + 修正某些情況下根據樹型文字表批量創建目錄時層級錯亂的問題。

      + 修正 Win10 某些特殊企業版本下主菜單位置偏移的問題。

      v0.0.6.19

      + 添加 “設置‘封裝字符串’” 功能。

      v0.0.6.20

      + 允許自定義腳本設置了`工具欄按鈕文本`的情況下，也出現在主菜單中——這樣可以提供一些額外的、不重複的快捷鍵。

      v0.0.6.22

      + 自動向 CHM 工程文件登記用戶手工添加到工作區下`Images~`目錄中的圖像文件。這樣可以保證用戶僅在 CSS  樣式表中引用這些圖像文件的情況下，它們在打包的 CHM 文件中仍然有效。

      v0.0.6.28

      + 添加對 NPOI 的引用。 目的是方便用戶編寫腳本直接生成 Word 文檔。項目附件中有示例腳本(可以用來生成簡單的公文)。

      + 修正粘貼圖像為單行鏈接時不能預覽的問題。

      + 修正演講模式下，雙擊單行圖像鏈接不能預覽的問題。

      v0.0.6.29

      + 在調用腳本引擎時，將程序安裝路徑添加到腳本引擎搜索路徑列表中。解決程序發布後無法引用安裝目錄下的 DLL  庫的問題。(默認的搜索路徑不足以保證順利執行腳本。)

      v0.0.6.31

      + 在“編譯”菜單中添加一個菜單項，提供“檢索未被引用的圖像文件”的功能。

      + 微調兩個全屏透視圖的界麵行為。

      + 添加了幾個公用方法，以便支持腳本調用。

      v0.0.6.34

      + 更新 AvalonEdit 為最新的 v6.1.0.0 版本。

      + 默認情況下關閉編輯器的`折疊`功能——這玩意太耗費資源了，對計算機性能要求較高，會導致打字時延遲。

      v0.0.6.37

      +  微調啟動邏輯。當使用命令行(包括使用指定工作路徑的快捷方式)來啟動程序，並且指定的路徑事實上並不存在時，程序會崩潰。現改為自動嚐試創建目錄，如果創建失敗，則自動打開程序初始工作區。

      【緊急修複】解決因引用 QuickImageLink 帶來的“雙擊文本程序崩潰”的問題。

      2019年11月10日更新日誌：

      【1】將自定義 IronPython  腳本區分為工作區腳本和全局腳本。這是為了避免某些僅適用於特定工作區的腳本“汙染”其它工作區——而且這樣便於轉移工作區位置(例如換一台電腦繼續編輯工作區中的文件時，不再需要到全局腳本文件夾下去挑選腳本文件再複製)。

      【2】調整主工具欄位置，優化 IronPython 腳本調用工具條的顯示位置。

      【3】允許添加自定義Div，這樣可以對文檔中的部分進行更精細的控製。

      【4】為防止在向編輯器粘貼圖像數據塊(會自動保存文件並創建鏈接)時誤覆蓋同名的、已存在的文件，添加了一個對話框讓用戶預覽(這比一個消息框要直觀得多)。

      【5】使“方塊區域”除了支持轉換為 Html DIV 元素標簽以外，也支持其它成對的元素標簽。請參見：。這個功能沒多大用處——因為一般隻需要 Div  ——其它元素標簽很少有用處甚至幫倒忙。加上這個功能是為了添加某些 Html5 元素標簽對——但一般做文檔時(考慮到 CHM 格式的兼容性要求)很少有機會使用  Html5!!!

      【6】解決方塊區域添加自定義 ID 或 CLASS 時不能使用兩個及以上的 _ 字符的問題。(原因是 MarkdownSharp 會將成對的 _  處理成 。)

      【7】給編譯的 Html 網頁底部的導航麵板添加 id 和 class ，以便使用 CSS  重新定義其樣式(固定在瀏覽器可視區底部才是更好的辦法)。

      【8】嚐試解決被加密的文檔在多次錯誤輸入密碼後再輸入正確的密碼無法載入內容的問題。(注意用舊版如發現異常千萬不要保存!)

      【9】優化左側工具欄布局，解決向上拖動分隔條會越界的問題並添加窗口尺寸改變時向上或向下“吸附”效果。

      【10】修複左邊欄在某些情況下會縮小的問題。

      【11】為腳本編輯器封裝了一些方便調用的文本處理方法。

      【12】添加了使用 Enter  鍵調用腳本的方式——這樣，可以在自定義腳本中編寫一些驗證方法來方便對當前行輸入的文本進行檢測(例如銀行卡號、身份證號等)。

      【13】在 Globals 類中添加了 ValidateSavingCard() 和 ValidateIdCard() 這兩個方法，以便 Python  腳本調用來對身份證號和銀行卡號進行不那麼嚴格的驗證——一般用來防止輸入錯誤是夠用了。

      【14】實現 Quick Image Link  功能。請參見：https://gitee.com/lunarsf/Lunar-Markdown-Editor/issues/I14OF