文档工程

优质
小牛编辑
133浏览
2023-12-01

实体可以用来作这件事情

有两个文件一个是主文件docbook.xml,包含文件头和文档信息;另一个文件file.xml是文档内容,主文件如下:

<?xml version='1.0' encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5/zh_cn"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" 
[
<!ENTITY file SYSTEM "file.xml">“分子元素”一节

如果把引用文件的列表放在外部文件中,则更加容易管理。但是 XML 不允许在 DTD 中引用普通实体[56],这就要定义参数实体:

<?xml version='1.0' encoding="UTF-8"?>
<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.5/zh_cn"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" 
[
<!ENTITY %1 list SYSTEM "list.xml">
%list;2
]>  

1

在定义参数实体时,这里多了一个%

2

引用参数实体时使用%而不是&

list.xml文件内容如下:

<!ENTITY file SYSTEM "file.xml">  
<!ENTITY file1 SYSTEM "file1.xml">
<!ENTITY file2 SYSTEM "file2.xml">

这样就可以在正文引用list.xml文件中定义的普通实体了



[55] 即便文档规模不是很大,把内容独立出来也有好处,比如:
    每部分单独发布,修改,节省时间
    如果出错便于排查

[56] 在 DTD 中能够定义外部文件作为普通实体,但是只能在正文中引用,不能在 DTD 中引用