BoostBook library documentation is contained entirely within a <library> XML element. To create a skeletal library, we need to create a new XML document (call it any.xml) that contains basic information about the library. The following BoostBook XML example describes basic information about the Boost.Any library:
BoostBook 的庫文檔被包含在一個 <library> XML 元素中。要創建一個框架庫，我們需要創建一個新的 XML 文檔(稱之為 any.xml)來包含該庫的基本信息。以下 BoostBook XML 示例 描述了關於 Boost.Any 庫的基本信息：

<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE library PUBLIC "-//Boost//DTD BoostBook XML V1.0//EN"
  "http://www.boost.org/tools/boostbook/dtd/boostbook.dtd">
<library name="Any" dirname="any" xmlns:xi="http://www.w3.org/2001/XInclude"
  id="any" last-revision="$Date: 2008-07-12 15:30:45 -0400 (Sat, 12 Jul 2008) $">
  <libraryinfo>
    <author>
      <firstname>Kevlin</firstname>
      <surname>Henney</surname>
    </author>
    <librarypurpose>
      Safe, generic container for single values of different value types
    </librarypurpose> 
    <librarycategory name="category:data-structures"/>
  </libraryinfo>
</library>

The first three lines identify this document as a BoostBook XML document. The DOCTYPE line states that the document conforms to the BoostBook DTD, and that the top-level element is a BoostBook <library>.
頭三行表示這個文檔是一個 BoostBook XML 文檔。DOCTYPE 行表示該文檔符合 BoostBook DTD，並且頂層元素為 BoostBook <library>。

The <library> element actually describes the aspects of BoostBook library documentation. The attributes for the <library> element are:
<library> 元素實際描述 BoostBook 庫文檔的外表。<library> 元素的屬性有：

Inside the <library> element we have the <libraryinfo> element, which gives information about the library itself. It contains the author's name (there may be more than one <author> element), followed by the purpose of the library and the list of categorizations. The <librarypurpose> element should always contain a very short (single sentence) description of the library's purpose, and should not terminate with a period.
在 <library> 元素內部，我們有 <libraryinfo> 元素，它給出關於庫本身的信息。它包含作者的姓名(可能有一個以上的 <author> 元素)，接著是庫的用途和分類列表。 <librarypurpose> 元素應包含一個關於庫的用途的非常短的(單個句子)說明，且不應以句號結束。

The list of categories is specified by a set of <librarycategory> elements. Each <librarycategory> element has a name element that identifies one of the categories. The actual list of categories is in the file doc/src/boost.xml.
分類列表由一組 <librarycategory> 元素指定。每個 <librarycategory> 元素有一個標識一種類別的 name 元素。現行的分類列表在文件 doc/src/boost.xml 中。

At this point, we can apply the BoostBook XSL stylesheets to any.xml (to DocBook) followed by a DocBook XSL stylesheet to generate HTML output, as described in the section called 「Getting Started」.
到此為止，我們可以將 BoostBook XSL stylesheets 應用於 any.xml (至 DocBook)後跟 DocBook XSL stylesheet 以生成 HTML 輸出，正如 「入門」一節 中所描述的。

Most library authors are comfortable with writing HTML documentation. Writing DocBook documentation (and, by extension, BoostBook documentation) is quite similar to writing HTML, except that BoostBook uses different element names from HTML (see Table 26.2, 「Converting HTML elements to BoostBook」) and BoostBook XML is a much more rigid format than HTML.
多數的庫作者都樂於編寫 HTML 文檔。編寫 DocBook 文檔(以及作為其擴展的 BoostBook 文檔)與編寫 HTML 非常相似，除了 BoostBook 使用了與 HTML 不同的元素名(請見 表 26.2, 「將 HTML 元素轉換至 BoostBook」)，以及 BoostBook XML 具有比 HTML 更為嚴格的格式。

One of the easiest ways to convert HTML documentation into BoostBook documentation is to use HTML Tidy to transform your HTML into valid XHTML, which will make sure that all elements are properly closed, then apply the transformations in Table 26.2, 「Converting HTML elements to BoostBook」 to the body of the XHTML document. The following command uses HTML Tidy to transform HTML into valid XHTML:
將 HTML 文檔轉換為 BoostBook 文檔的一個最容易的方法是使用 HTML Tidy 來將你的 HTML 轉換為有效的 XHTML，以確保所有元素被正確關閉，然後將 表 26.2, 「將 HTML 元素轉換至 BoostBook」 中的轉換應用於 XHTML 文檔的 body。以下命令使用 HTML Tidy 來將 HTML 轉換為 XHTML：

  tidy -asxhtml input.html > output.xhtml

When converting documentation from HTML to BoostBook, note that some redundant information that has to be manually maintained in HTML is automatically generated in BoostBook: for instance, the library categorizations, purpose, and author list described in the section called 「Defining a BoostBook library」 are used both in the documentation for the library and to build alphabetical and categorized lists of known libraries; similarly, tables of contents are built automatically from the titles of sections in the BoostBook document.
在將文檔從 HTML 轉換為 BoostBook 時，注意有些在 HTML 中必須手工維護的冗余信息在 BoostBook 中是自動生成的：例如，在 「定義一個 BoostBook 庫」一節 中所描述的庫類別、用途和作者，這些信息即用在庫的文檔中，也用於構建已知庫的字母序列表和分類列表；同樣，目錄也是由 BoostBook 文檔中各章節的題目自動構建。

"Sectioning" refers to organization of a document into separate sections, each with a title, some text, and possibly subsections. Each section is described in BoostBook via a <section> element. An introduction section may look like this:
"分節" 是指將一個文檔組織成各個獨立的章節，每個章節有一個題目、一些文本，還可能有子章節。每一個章節在 BoostBook 中以一個 <section> 元素表示。例如，一個"簡介"章節可能如下：

<section id="any.intro">
  <title>Introduction</title>
 
  <para>Introduction to a library...</para>

  <section>
    <title>A Subsection</title>
    <para>Subsection information...</para>
  </section>
</section>

The <section> element contains all information that should logically be grouped within that section. The title of the section is placed within the <title> element, and any paragraphs, programs, lists, tables, or subsections can occur within the section. The id attribute of the <section> element gives a unique ID to each section, so that it may later be identified for linking. It is suggested that all IDs start with the short name of a library followed by a period, so that IDs do not conflict between libraries.
<section> 元素包含了邏輯上組成某個章節的所有信息。章節的題目放在 <title> 元素中，章節的內部可以有段落、程序、列表、表格或子章節。<section> 元素的 id 屬性為每個章節給定一個唯一的 ID，這樣以後可以作為鏈接的標識。建議所有的 IDs 都以庫的短名加一個句號作為起始，這樣不同庫之間的 IDs 就不會衝突。