附錄 A. 範例

內容目錄
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

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

<book lang='zh_tw'>
  <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>

All FreeBSD documents are available for download at http://ftp.FreeBSD.org/pub/FreeBSD/doc/

Questions that are not answered by the documentation may be sent to <freebsd-questions@FreeBSD.org>.
Send questions about this document to <freebsd-doc@FreeBSD.org>.