Учебник по Проекту Документирования FreeBSD для новых участников
Пред. След.

Приложение A. Примеры

Содержание
A.1. DocBook <book>
A.2. DocBook <article>
A.3. Получение форматированного вывода

В этом приложении находятся примеры файлов SGML и команд, которые вы можете использовать для преобразования их от одного формата к другому. Если вы успешно установили инструменты Проекта Документирования, то вы должны суметь непосредственно использовать эти примеры.

Эти примеры не исчерпывающи--в них содержатся не все элементы, которые вам могут понадобиться, в частности, те, что понадобятся в первую очередь. Примеры разметки DocBook вы можете найти в исходных текстах SGML для этого и других документов, которые находятся в наборе CVSup doc, или в сети с начальной страницей http://www.FreeBSD.org/cgi/cvsweb.cgi/doc/.

Во избежание путаницы в этих примерах используется стандартный DocBook 4.1 DTD, а не расширение FreeBSD. В них также используются стандартные таблицы стилей, которые распространяет Норм Уолш (Norm Walsh), а не те, что содержат дополнительные настройки, относящиеся к Проекту Документирования FreeBSD. Это делает их более полезными в качестве общих примеров для DocBook.

A.1. DocBook <book>

Пример A-1. DocBook <book>

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

<book>
  <bookinfo>
    <title>Пример книги</title>

    <author>
      <firstname>Ваше имя</firstname>
      <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>
Пред. Начало След.
Проект Документирования Linux   DocBook <article>

Этот, и другие документы, могут быть скачаны с ftp://ftp.FreeBSD.org/pub/FreeBSD/doc/.

По вопросам, связанным с FreeBSD, прочитайте документацию прежде чем писать в <questions@FreeBSD.org>.
По вопросам, связанным с этой документацией, пишите <doc@FreeBSD.org>.
По вопросам, связанным с русским переводом документации, пишите в рассылку <frdp@FreeBSD.org.ua>.
Информация по подписке на эту рассылку находится на сайте проекта перевода.