docbook使用心得

  最近开始用docbook写文档, 这里有一篇前人的<docbook写作入门>的文章, 本来是繁体的, 我试着用docbook改写了一下, 以备参考.
  学用DocBook，要改变写作方式，把精力放在文章的撰写和结构的设计上，而不在字体、格式上修修补补。
  如果文章长的话, 就采用book作为根目录, 这样生成的文档会带有目录, 否则采用article作为根目录
如果要加上作者的话, 这样写:

<author>
	<surname>xxx</surname>
</author>

  主要中国人姓名跟first name, last name有些区别
  一般使用orderedlist的时候不会缩进, 那么外面再嵌套一层blockquote标签就好了
如果是程序代码, 最好这样写:

<programlisting>
		<![CDATA[
		code
		]]>
</programlisting>

这样里面的什么<, >, &之类的不用转义, 在编辑的时候比较清晰.
参考资料条目这样写:

<biblioentry>
	<title>
		<ulink
			url="xxx">xxxx</ulink>
	</title>
	<subtitle>xxx</subtitle>
</biblioentry>

  让图片以合适的大小显示:

<inlinemediaobject>
				<imageobject>
					<imagedata fileref="images/uic_domain.jpg" align="center"
						width="100%" scalefit="1" />
				</imageobject>
			</inlinemediaobject>