下一页 上一页 目录

7. 错误和错误信息

7.1 不会产生错误信息的错误

一个主要的错误是在节标题后忘记添加 <p> 标签。 这样节标题就没有结束,所有后续的段落都会变成节标题的一部分并进入目录。 应该改进 Linuxdoc 以检测这个错误。 要手动发现它,请查看 html 或文本格式的目录。 修复它只需要添加缺失的 p 标签。

7.2 实际的错误信息

当您运行 linuxdoc 程序(例如 sgml2html 或 sgml2txt)时,您可能会看到一些错误信息。 您需要编辑您的文档并修复这些错误。

遗漏闭合引号是一个常见的错误。 如果您收到一条没有意义的错误消息,并注意到错误位置的一些引号(" ")是正常的,那么很可能是您之前输入了一个开始引号但没有闭合引号。 例如: <.... id="my home page > 这样 linuxdoc 认为下一个引号(可能在缺失引号位置之后的许多段落)是闭合引号。 然后在错误的闭合引号之后,它期望找到一个 > 来完成标签,但没有找到。 要查找和修复缺失的引号,只需向后搜索 " 即可。

一个错误可能会导致大量的错误信息。 在上面的示例中,许多标签可能位于错误的引号内,而这些引号本不应该存在。 因此 linuxdoc 将找不到这些标签。 结果,它将不知道某个标签是打开的,如果它找到一个闭合标签,它会告诉您该标签未打开。 例如,如果遗漏了 <itemize> 标签,那么 <item> 标签对于 linuxdoc 来说可能没有任何意义,并且它会为在错误闭合引号之后找到的每个此类标签报告错误。

您应该知道的一件事是,标签名称不区分大小写,因此即使您以小写形式输入标签名称,错误消息也会以大写(大写字母)显示标签名称。

要更好地理解错误消息,需要了解 sgml 上的术语,除非您遇到无法修复且不理解错误消息的错误,否则您实际上不需要学习这些术语。 以下部分是关于这些术语的。


下一页 上一页 目录