Markdown To CHM(LME)

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