Appendix A. 範例

Table of Contents
A.1 DocBook <book>
A.2 DocBook <article>
A.3 Producing formatted output

本附錄收錄一些 SGML 檔範例,以及用來轉換格式的相關指令。 若已成功安裝文件計畫工具包的話,那麼就可以直接照下面範例來使用。

這些例子並不是很詳細 —— 並未包括你可能想用的元件, 尤其像是你文件的前頁(正文前的書頁,包括扉頁、序言、目錄等) 若需參考更多 DocBook 標記語言文件的話,那麼可以透過 CSupCVSup 程式來抓 doc tree 部分,以察看本文件或其他文件的 SGML 原稿。 或者,也可以線上瀏覽 http://www.FreeBSD.org/cgi/cvsweb.cgi/doc/

為了避免不必要的困擾,這些例子採用標準的 DocBook 4.1 DTD 而非 FreeBSD 額外的 DTD。 同時並採用 Norm Walsh 氏的樣式表(stylesheets),而非 FreeBSD 文件計劃有自行改過的樣式表。 在一般使用 DocBook 的例子,這樣子會比較簡化環境,而不會造成額外困擾。

A.1 DocBook <book>

Example A-1. DocBook <book>

<!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook V4.1//EN">

<book>
  <bookinfo>
    <title>樣本書的例子</title>
    
    <author>
      <firstname>名(first name)</firstname>
      <surname>姓(surname)</surname>
      <affiliation>
        <address><email>foo@example.com</email></address>
      </affiliation>
    </author>

    <copyright>
      <year>2000</year>
      <holder>相關版權字樣</holder>
    </copyright>

    <abstract>
      <para>該書若有摘要,就寫在這邊。</para>
    </abstract>
  </bookinfo>

  <preface>
    <title>序言</title>

    <para>該書若有序言,就放在這邊。</para>
  </preface>
      
  <chapter>
    <title>第一章</title>

    <para>這是這本書的第一章。</para>

    <sect1>
      <title>第一節</title>

      <para>這本書的第一節。</para>
    </sect1>
  </chapter>
</book>

本文及其他文件,可由此下載:ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/

若有 FreeBSD 方面疑問,請先閱讀 FreeBSD 相關文件,如不能解決的話,再洽詢 <questions@FreeBSD.org>。
關於本文件的問題,請洽詢 <doc@FreeBSD.org>。