【已解决】Docbook中，将section从chapter中独立出去，放到单独的xml文件中

【问题】

docbook中，已经对各个chapter实现了分割为单独的xml了。

但是现在个别chapter中内容太多，所以希望将各个section部分的内容，也都再次分割独立出去，这样利于内容编辑和管理。

【解决过程】

1.打算参考chapter的做法：

<?xml version='1.0' encoding="utf-8"?>

<!DOCTYPE chapter
[

<!ENTITY % crl_ent PUBLIC "crl.ent" 'null'>%crl_ent;

]>

<chapter
    xmlns="http://docbook.org/ns/docbook"
    xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:xl="http://www.w3.org/1999/xlink"
    
    xml:id="ch03_uppper_lan">
<title>上层语言</title>
<abstract></abstract>
    <sect1><title>上层语言综述</title>
...
    </sect1>
    
    <sect1 xml:id="lan.cpp"><title>C++</title>
...
    </sect1>

</chapter>

然后主xml中再包含进去：

<xi:include href="ch03_uppper_lan.xml" />

然后去弄出个sect1的xml文件，然后再在chapter中xi:include此sect1的xml。

2.然后弄成了这样子的：

子文件ch02s1_python.xml：

<?xml version='1.0' encoding="utf-8"?>

<!DOCTYPE sect1
[

<!ENTITY % crl_ent PUBLIC "crl.ent" 'null'>%crl_ent;

]>

<sect1
    xmlns="http://docbook.org/ns/docbook"
    xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:xl="http://www.w3.org/1999/xlink"
    
    xml:id="lan.python">
<title>Python</title>
    <sect2><title>Python特点</title>
......
    </sect2>
    
    <sect2><title>如何在Windows环境下使用Python脚本</title>
......
    </sect2>
    
    <sect2 xml:id="lan.python.crifanlib"><title>crifan的Python库：crifanLib.py</title>
......
    </sect2>
</sect1>

而上一级文件ch02_script_lan.xml是这样的：

<?xml version='1.0' encoding="utf-8"?>

<!DOCTYPE chapter
[

<!ENTITY % crl_ent PUBLIC "crl.ent" 'null'>%crl_ent;

]>

<chapter
    xmlns="http://docbook.org/ns/docbook"
    xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:xl="http://www.w3.org/1999/xlink"
    
    xml:id="ch02_script_lan">
<title>脚本语言</title>
<abstract></abstract>
    <sect1><title>脚本语言综述</title>
......
    </sect1>
    
    <xi:include href="ch02s1_python.xml" />
    ......
</chapter>

这样就成功实现了将sect1从chapter中分离出来，放到一个单独的xml文件中了。

【总结】

将sect1/section从chapter中分离出来，和把chapter从主xml文件中分离出来，方法是类似的，

都是主文件中包含子文件：

<xi:include href="sub_file.xml" />

然后子文件sub_file.xml中根元素是sect1，即可：

<?xml version='1.0' encoding="utf-8"?>

<!DOCTYPE sect1
[

<!ENTITY % crl_ent PUBLIC "crl.ent" 'null'>%crl_ent;

]>

<sect1
    xmlns="http://docbook.org/ns/docbook"
    xmlns:xi="http://www.w3.org/2001/XInclude"
    xmlns:xl="http://www.w3.org/1999/xlink"
    
    xml:id="lan.python">
<title>Python</title>
    <sect2><title>Python特点</title>
......
    </sect2>
    
    <sect2><title>如何在Windows环境下使用Python脚本</title>
......
    </sect2>
    
    <sect2 xml:id="lan.python.crifanlib"><title>crifan的Python库：crifanLib.py</title>
......
    </sect2>
</sect1>

转载请注明：在路上 » 【已解决】Docbook中，将section从chapter中独立出去，放到单独的xml文件中