第09节 Markdown文档标题
可以为每个文档设置一个标题。格式如下:
%标题文本
以半角英文的百分号开头,后面的文本会被当作文档标题。
注意:百分号须顶格书写,而且不支持使用全角百分号%
。
考虑到软件启动时如果读取每个文件中的所有文本来查找一个标题是个极为恐怖的事情,所以标题被限制在文件的前十行,且最多支持 30 个字符(不含百分号)。
如果文档中出现多个标题,则以第一个为准,其余会被当成普通文本处理。
例如:
如果没有提供上述格式的标题,下面的标题也会起作用:
<<<信息>
类型>><<类型
标题>>这是标题3<<标题
日期>><<日期
辑录>><<辑录
电邮>><<电邮
备注>><<备注
<信息>>>
文档标题主要用在:
- 浏览器中
浏览器在显示编译后的 Html 页面时,将之作为页面标题显示在浏览器的标题栏上。
- 编译后的 Html 页面上
- 创建的 CHM 工程文件的目录上
本程序的工作区管理器需要依靠文件名来排序,所以在对文件命名时必须注意顺序问题。
由于必须考虑在将来插入新文件、目录的可能性,而原有目录由于可能已经被其它文件引用又不能更改名称——所以较好的办法就是给文件夹、文件取带数字的名称(而且数字最好不连续)。
这种不连续的名称编译到 CHM 目录中会很丑陋!
而文档标题可以与文件目录名不一致,这个特性正好可以解决这个问题。
请参考下图: