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

lang

*
doc/
doc/
lang.encoding/
sgml-mode
<book>
<article>

.profile
.cshrc
INCLUDE
IGNORE
<h1>
<h2>
<hn>

<blockquote>
<ul>
<ol>
<dl>
<pre>
<table>
rowspan
colspan
rowspan
colspan




<tt>
<big>


<a
href="...">
<a
name="...">
<book>
<bookinfo>
<article>
<articleinfo>
<para>
<blockquote>
<warning>
<itemizedlist>
<orderedlist>
<procedure>
<programlisting>
<co>
<calloutlist>
<informaltable>
frame="none"
<screen>
<prompt>
<userinput>
<emphasis>
<filename>
<filename>
role
<devicename>
<hostid>
<username>
<maketarget>
<makevar>
<literal>
<replaceable>
<errorname>
id в главах и разделах
<anchor>
<xref>
<link>
<ulink>
<book>
<article>
root
.login
ls -a
You have mail.

% su
Password:

root
rm filename
$HOME
textproc/docproj
# cd /usr/ports/textproc/docproj
# make JADETEX=no install

doc
checkout
doc/share
doc/en_US.ISO8859-1/share
% cvs checkout doc/share
% cvs checkout doc/en_US.ISO8859-1/share

% cvs checkout doc

articles
% cvs checkout doc/en_US.ISO8859-1/articles

vpn-w2k
% cd doc/en_US.ISO8859-1/articles
% cp -R committers-guide vpn-w2k

doc/en_US.ISO8859-1/books/faq
% cvs checkout doc/en_US.ISO8859-1/books/faq

.sgml
lint
% make lint

html
html-split
txt
ps
pdf
rtf
doc/share/mk/doc.docbook.mk
html
% make FORMATS=html

html
txt
% make FORMATS=html
% make FORMATS=txt

% make FORMATS="html txt"

textproc/docproj
textproc/docproj
# make JADETEX=yes install

# make JADETEX=no install

textproc/docproj-jadetex
textproc/docproj-nojadetex
JADETEX
textproc/docproj
textproc/sp
textproc/jade
www/tidy
www/links
graphics/peps
textproc/html
textproc/docbook
textproc/iso8879
textproc/dsssl-docbook-modular
print/jadetex
print/teTeX
print/jadetex/pkg-message
editors/emacs
editors/emacs
/tmp/foo
% rm /tmp/foo

<para>Для удаления <filename>/tmp/foo</filename>, воспользуйтесь командой
  &man.rm.1;.</para>

<screen>&prompt.user; <userinput>rm /tmp/foo</userinput></screen>

element-name
<element-name>
</element-name>
p
Это параграф. Он начинается с начальной
 метки для элемента 'p' и заканчивается конечной меткой для элемента
 'p'.

Это другой параграф. Но он гораздо короче.

hr
<p>Это параграф.</p>

<hr>

Это другой параграф. Горизонтальная линия отделяет его от предыдущего
 параграфа.

<em>
<p>Это простой <em>параграф</em>, в котором
  некоторые <em>слова</em> были <em>выделены</em>.</p>

<
p
>
название-атрибута="значение
атрибута"
<p>
align
align
left
center
right
justify
left
<p align="left">Включение атрибута
  выравнивания для этого параграфа было излишним, так как по умолчанию
  используется выравнивание по левой границе.</p>

<p align="center">Это может появиться по центру.</p>

left
justify
"
<p align='right'>Я справа!</p>

textproc/docproj
textproc/docproj
SGML_CATALOG_FILES
.profile
SGML_ROOT=/usr/local/share/sgml    
SGML_CATALOG_FILES=${SGML_ROOT}/jade/catalog
SGML_CATALOG_FILES=${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
SGML_CATALOG_FILES=${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
SGML_CATALOG_FILES=${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
SGML_CATALOG_FILES=/usr/doc/share/sgml/catalog:$SGML_CATALOG_FILES
SGML_CATALOG_FILES=/usr/doc/en_US.ISO8859-1/share/sgml/catalog:$SGML_CATALOG_FILES
export SGML_CATALOG_FILES

.cshrc
setenv SGML_ROOT /usr/local/share/sgml
setenv SGML_CATALOG_FILES ${SGML_ROOT}/jade/catalog
setenv SGML_CATALOG_FILES ${SGML_ROOT}/iso8879/catalog:$SGML_CATALOG_FILES
setenv SGML_CATALOG_FILES ${SGML_ROOT}/html/catalog:$SGML_CATALOG_FILES
setenv SGML_CATALOG_FILES ${SGML_ROOT}/docbook/4.1/catalog:$SGML_CATALOG_FILES
setenv SGML_CATALOG_FILES /usr/doc/share/sgml/catalog:$SGML_CATALOG_FILES
setenv SGML_CATALOG_FILES /usr/doc/en_US.ISO8859-1/share/sgml/catalog:$SGML_CATALOG_FILES

example.sgml
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN">

<html>
  <head>    
    <title>Пример файла HTML</title>
  </head>

  <body>    
    <p>Это параграф, содержащий некоторый текст.</p>

    <p>В этом параграфе содержится дополнительный текст.</p>

    <p align="right">Этот параграф может быть выровнен по правому краю.</p>
  </body>
</html>

textproc/docproj
nsgmls
nsgmls
nsgmls
nsgmls
nsgmls
% nsgmls -s example.sgml

nsgmls
<title>
</title>
% nsgmls -s example.sgml
nsgmls:example.sgml:5:4:E: character data is not allowed here
nsgmls:example.sgml:6:8:E: end tag for "HEAD" which is not finished

nsgmls
nsgmls
I
W
E
X
nsgmls -sv
nsgmls:I: SP version
"1.3"
<title>
<head>
<title>
<head>
<title>
nsgmls
title
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN">

<!
DOCTYPE
html
PUBLIC "-//W3C//DTD HTML 4.0//EN"
PUBLIC
>
"Владелец//Ключевое слово Описание//Язык"

Владелец
"ISO 8879:1986//ENTITIES Greek Symbols//EN"
ISO 8879:1986
-//Владелец
+//Владелец
+
-
-
+
-//FreeBSD
Ключевое слово
DTD
ELEMENT
ENTITIES
TEXT
DTD
ELEMENT
TEXT
Описание
Язык
EN
catalog
catalog
PUBLIC "-//W3C//DTD HTML 4.0//EN"             "4.0/strict.dtd"

strict.dtd
4.0
catalog
/usr/local/share/sgml/html/catalog
textproc/docproj
SGML_CATALOG_FILES
catalog
SGML_CATALOG_FILES
/usr/local/share/sgml/docbook/4.1/catalog
/usr/local/share/sgml/html/catalog
/usr/local/share/sgml/iso8879/catalog
/usr/local/share/sgml/jade/catalog
<!DOCTYPE html SYSTEM "/path/to/file.dtd">

SYSTEM
SYSTEM
<! ...
>
--
<!-- Тестовый комментарий -->

<!-- Это находится внутри комментария -->

<!-- Это еще один комментарий    -->

<!-- Это один из способов
     создания многострочных комментариев -->

<!-- Это другой способ   --
  -- создания многострочных комментариев -->

<!--
-->
<!-- Это находится внутри комментария --

     ЭТО ВНЕ КОММЕНТАРИЯ!

  -- снова внутри комментария -->

<!ЭТО ВНЕ КОММЕНТАРИЯ>

<!--------------- Это очень плохая идея --------------->

<!--===================================================-->

example.sgml
nsgmls
example.sgml
nsgmls
&имя-сущности;
current.version
<para>Текущей версией нашего продукта является
  &current.version;.</para>

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY current.version    "3.0-RELEASE">
<!ENTITY last.version       "2.2.7-RELEASE">
]>

&имени-сущности;
%имя-сущности;
%
ENTITY
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY % param.some "some">
<!ENTITY % param.text "text">
<!ENTITY % param.new  "%param.some more %param.text">

<!-- %param.new теперь содержит "some more text" -->
]>

example.sgml
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN" [
<!ENTITY version "1.1">
]>  

<html>
  <head>    
    <title>Пример файла HTML</title>
  </head>

  <!-- Вы можете также поместить здесь комментарии -->

  <body>    
    <p>Этот параграф содержит некоторый текст.</p>

    <p>Этот параграф содержит некоторый дополнительный текст.</p>

    <p align="right">Этот параграф может быть выравнен по правому краю.</p>

    <p>Текущая версия этого документа: &version;</p>
  </body>
</html>

nsgmls
example.sgml
example.html
&version;
sgmlnorm
% sgmlnorm example.sgml > example.html

example.html
sgmlnorm
% sgmlnorm -d example.sgml > example.html

chapter1.sgml
chapter2.sgml
book.sgml
SYSTEM
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY chapter.1 SYSTEM "chapter1.sgml">
<!ENTITY chapter.2 SYSTEM "chapter2.sgml">
<!ENTITY chapter.3 SYSTEM "chapter3.sgml">
<!-- И так далее -->
]>

<html>
  <!-- Используем сущности для подгрузки глав -->

  &chapter.1;
  &chapter.2;
  &chapter.3;
</html>

chapter1.sgml
chapter2.sgml
chapters.ent
<!ENTITY chapter.1 SYSTEM "chapter1.sgml">
<!ENTITY chapter.2 SYSTEM "chapter2.sgml">
<!ENTITY chapter.3 SYSTEM "chapter3.sgml">

<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!-- Определение параметризованной сущности для подгрузки сущностей общего
     назначения -->
<!ENTITY % chapters SYSTEM "chapters.ent">

<!-- А теперь используем параметризованную сущность для загрузки их в файл -->
%chapters;
]>

<html>
  &chapter.1;
  &chapter.2;
  &chapter.3;
</html>

para1.sgml
para2.sgml
para3.sgml
<p>Это первый параграф.</p>

example.sgml
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY version "1.1">
<!ENTITY para1 SYSTEM "para1.sgml">
<!ENTITY para2 SYSTEM "para2.sgml">
<!ENTITY para3 SYSTEM "para3.sgml">
]>

<html>
  <head>
    <title>Пример файла HTML</title>
  </head>

  <body>
    <p>Текущая версия этого документа: &version;</p>

    &para1;
    &para2;
    &para3;
  </body>
</html>

example.html
example.sgml
% sgmlnorm -d example.sgml > example.html

example.html
paran.sgml
example.html
example.sgml
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY % entities SYSTEM "entities.sgml"> %entities;
]>

<html>
  <head>
    <title>Пример файла HTML</title>
  </head>

  <body>
    <p>Текущая версия этого документа: &version;</p>

    &para1;
    &para2;
    &para3;
  </body>
</html>

entities.sgml
<!ENTITY version "1.1">
<!ENTITY para1 SYSTEM "para1.sgml">
<!ENTITY para2 SYSTEM "para2.sgml">
<!ENTITY para3 SYSTEM "para3.sgml">

example.html
example.sgml
% sgmlnorm -d example.sgml > example.html

example.html
paran.sgml
example.html
<![ KEYWORD [
  Содержимое отмеченного раздела
]]>

<!
KEYWORD
>
CDATA
RCDATA
CDATA
RCDATA
CDATA
RCDATA
CDATA
RCDATA
CDATA
CDATA
<para>Вот пример того, как вы должны включать
  некоторый текст, содержащий множество символов &lt; и &amp;.  Текст
  в примере является фрагментом HTML.  Окружающие текст (<para> и
  <programlisting>) из DocBook.</para>

<programlisting>
  <![ CDATA [  
    <p>Это пример, показывающий вам некоторые элементы HTML.  Так как угловые
      скобки используются так часто, то проще всего указать, что весь пример
      является разделом, помеченным как CDATA, чем использовать имена сущностей
      для левых и правых угловых скобок по всему тексту.</p>

    <ul>
      <li>Это элемент списка</li>
      <li>Это второй элемент списка</li>
      <li>Это третий элемент списка</li>
    </ul>

    <p>Это конец примера.</p>
  ]]>
</programlisting>

INCLUDE
IGNORE
INCLUDE
IGNORE
INCLUDE
IGNORE
<![ INCLUDE [
 Этот текст будет обработан и включен.
]]>

<![ IGNORE [
 Этот текст не будет обработан и включен.
]]>

INCLUDE
IGNORE
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY % electronic.copy "INCLUDE">    
]]>

...

<![ %electronic.copy [
 Этот текст должен появиться только в электронной
 версии документа.
]]>

<!ENTITY % electronic.copy "IGNORE">

%electronic.copy
section.sgml
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.0//EN" [
<!ENTITY % text.output "INCLUDE">
]>

<html>
  <head>
    <title>Пример использования помеченных разделов</title>
  </head>

  <body> 
    <p>Этот параграф <![ CDATA [содержит много символов <
      (< < < < <), так что проще заключить его в раздел,
      помеченный как CDATA ]]></p>

    <![ IGNORE [
    <p>Этот параграф определенно не будет включен в выходной
      документ.</p>
    ]]>

    <![ %text.output [
    <p>Этот параграф может быть включен в выходной документ, а может там и
      не оказаться.</p>

    <p>Его появление контролируется параметризованной сущностью
      %text.output.</p>  
    ]]>
  </body>
</html>

text.output
INCLUDE
IGNORE
textproc/html
textproc/docproj
PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"

<head>
<body>
<html>
<html>
  <head>
      <title>Заголовок документа</title>
  </head>

  <body>

    ...

  </body>
</html>

<h1>
<h2>
<h6>
<h1>
<h2>
<h1>First section</h1>

<!-- Здесь помещается введение документа -->

<h2>Это заголовок первого раздела</h2>

<!-- Здесь размещается содержимое первого раздела -->

<h3>Это заголовок первого подраздела</h3>

<!-- Здесь размещается содержимое первого подраздела -->

<h2>Это заголовок второго раздела</h2>

<!-- Здесь размещается содержимое второго раздела -->

<h1>
<h2>
<hn>
<hn>
<h1>Первый раздел</h1>

<!-- Введение документа -->

<h3>Подраздел</h3>

<!-- Это плохо, пропущен <h2> -->

Это параграф. Он может содержать
практически любой другой элемент.

<blockquote>
<p>Короткий отрывок из Конституции США:</p>

<blockquote>We the People of the United States, in Order to form
  a more perfect Union, establish Justice, insure domestic
  Tranquility, provide for the common defence, promote the general
  Welfare, and secure the Blessings of Liberty to ourselves and our
  Posterity, do ordain and establish this Constitution for the
  United States of America.</blockquote>

<ol>
<ul>
<dl>
<li>
<p>
<dt>
<dd>
<ul>
<ol>
<p>Неупорядоченный список.  Элементам
списка должны предшествовать маркеры.</p>

<ul>
  <li>Первый элемент</li>

  <li>Второй элемент</li>

  <li>Третий элемент</li>
</ul>

Упорядоченный список, с элементами, состоящими из нескольких параграфов.
 Каждый элемент (замечание: но не каждый параграф) будет пронумерован.

<ol>
 <li>Это первый элемент. В нем только один параграф.</li>

  <li><p>Это первый параграф второго элемента.</p>

    <p>Это второй параграф второго элемента.</p></li>

  <li><p>Это первый и единственный параграф третьего элемента списка.</p></li>
</ol>

<dl>
<dl>
  <dt>Термин 1</dt>

  <dd><p>Параграф 1 определения 1.</p>

    <p>Параграф 2 определения 1.</p></dd>

  <dt>Термин 2</dt>

  <dd><p>Параграф 1 определения 2.</p></dd>

  <dt>Термин 3</dt>

  <dd>Параграф 1 определения 3.  Заметьте, что элемент &lt;p&gt;
    в случае единственного параграфа не нужен.</dd>
</dl>

<pre>
<pre>
<pre>
<pre>  From: nik@FreeBSD.org
  To: freebsd-doc@FreeBSD.org
  Subject: New documentation available

  There's a new copy of my primer for contributers to the FreeBSD
  Documentation Project available at

    <URL:http://people.FreeBSD.org/~nik/primer/index.html>

  Comments appreciated.

  N</pre>

<table>
<tr>
<td>
<p>
<table>
<p>Это простая таблица 2x2.</p>

<table>
  <tr>
    <td>Верхняя левая ячейка</td>

    <td>Верхняя правая ячейка</td>
  </tr>

  <tr>
    <td>Нижняя левая ячейка</td>

    <td>Нижняя правая ячейка</td>
  </tr>
</table>

rowspan
colspan
rowspan
<p>Одна высокая тонкая ячейка слева,
  две низкие ячейки за ней справа.</p>

<table>
  <tr>
    <td rowspan="2">Длинная и высокая</td>
  </tr>

  <tr>
    <td>Верхняя ячейка</td>

    <td>Нижняя ячейка</td>
  </tr>
</table>

colspan
<p>Одна длинная ячейка сверху, две
  короткие ячейки под ней.</p>

<table>
  <tr>
    <td colspan="2">Верхняя ячейка</td>
  </tr>

  <tr>
    <td>Нижняя левая ячейка</td>

    <td>Нижняя правая ячейка</td>
  </tr>
</table>

rowspan
colspan
На сетке 3x3 верхний левый блок является
 набором клеток 2x2, объединенных в одну ячейку.
 Остальные клетки нормальные.

<table>
  <tr>
    <td colspan="2" rowspan="2">Верхняя левая большая ячейка</td>

    <td>Верхняя правая клетка</td>
  </tr>

  <tr>
    <!-- Из-за того, что большая ячейка слева объединяется в
     эту строку, первый <td> появится справа -->

    <td>Средняя правая ячейка</td>
  </tr>

  <tr>
    <td>Нижняя левая ячейка</td>

    <td>Нижняя средняя ячейка</td>

    <td>Нижняя правая ячейка</td>
  </tr>
</table>

<em>
<strong>
<em>
<strong>
<em>
<strong>
<em>
<strong>
<p><em>Этот текст</em> выделен, а
  <strong>этот текст</strong> выделен сильно.</p>

<b>
<i>
<b>
<i>
<p><b>Этот текст</b> выводится жирным, а
  <i>этот текст</i> выводится наклонным шрифтами.</p>

<tt>
<tt>
<p>Этот документ первоначально создал
  Ник Клэйтон (Nik Clayton), которому можно написать по электронной почте
на адрес <tt>nik@FreeBSD.org</tt>.</p>

<big>
<small>
<big><big>этот текст гораздо
крупнее</big></big>
<font>
size
+1
-1
<big>
<small>
<font>
size
3
<big>
<small>
<font>
<p>Этот текст <small>немного меньше</small>.  А
  этот текст <big>немножко больше</big>.</p>

Этот текст несколько меньше. А
 этот текст немного крупнее</font.

Этот текст немного мельче. А
 этот текст немного крупнее.

<a>
href
<a href="...">
<p>Дополнительная информация находится на
  <a href="http://www.FreeBSD.org/">веб-сайте FreeBSD</a>.</p>

<a>
name
href
<a name="...">
<p><a name="para1">На</a> этот параграф
  можно сослаться из других мест
  по имени <tt>para1</tt>.</p>

#
para1
foo.html
<p>Дополнительная информация может быть
  найдена в <a href="foo.html#para1">первом абзаце</a> из
  <tt>foo.html</tt>.</p>

#
para1
<p>Дополнительная информация может быть
  найдена в <a href="#para1">первом абзаце</a> этого
  документа.</p>

Формально
неформально
textproc/docbook
textproc/docproj
PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN"

<chapter>
<part>
<sect1>
<sect2>
<sect5>
<sect1>
<sect2>
<book>
<bookinfo>
<book>
<bookinfo>
<book>
  <bookinfo>
    <title>Здесь ваш заголовок</title>

    <author>
      <firstname>Ваше имя</firstname>
      <surname>Ваша фамилия</surname>
      <affiliation>
    <address><email>Ваш адрес электронной почты</email></address>
      </affiliation>
    </author>

    <copyright>
      <year>1998</year>
      <holder role="mailto:Ваш e-mail">Ваше имя</holder>
    </copyright>

    <releaseinfo>$FreeBSD$</releaseinfo>

    <abstract>
      <para>Сюда включите обзор содержимого книги.</para>
    </abstract>
  </bookinfo>

  ...

</book>

<article>
<articleinfo>
<article>
<articleinfo>
<article>
  <articleinfo>
    <title>Здесь ваш заголовок</title>

    <author>
      <firstname>Ваше имя</firstname>
      <surname>Ваша фамилия</surname>
      <affiliation>
    <address><email>Ваш e-mail</email></address>
      </affiliation>
    </author>

    <copyright>
      <year>1998</year>
      <holder role="mailto:Ваш e-mail">Ваше имя</holder>
    </copyright>

    <releaseinfo>$FreeBSD$</releaseinfo>

    <abstract>
      <para>Сюда включите обзор содержимого статьи.</para>
    </abstract>
  </articleinfo>

  ...

</article>

<chapter>
<title>
<chapter>
  <title>Заголовок главы</title>

  ...
</chapter>

<title>
<chapter>
  <title>Это пустая глава</title>

  <para></para>
</chapter>

<sectn>
n
<sectn>
<sect1>
<sect2>
<sect5>
<chapter>
  <title>Примерная глава</title>

  <para>Некоторый текст в главе.</para>

  <sect1>
    <title>Первый раздел (1.1)</title>

    ...
  </sect1>

  <sect1>
    <title>Второй раздел (1.2)</title>

    <sect2>
      <title>Первый подраздел (1.2.1)</title>

      <sect3>
    <title>Второй подподраздел (1.2.1.1)</title>

    ...
      </sect3>
    </sect2>

    <sect2>
      <title>Второй подраздел (1.2.2)</title>

      ...
    </sect2>
  </sect1>
</chapter>

<part>
<book>
<chapter>
<part>
<article>
<part>
  <title>Введение</title>

  <chapter>
    <title>Обзор</title>

    ...
  </chapter>

  <chapter>
    <title>Что такое FreeBSD?</title>

    ...
  </chapter>

  <chapter>
    <title>История</title>

    ...
  </chapter>
</part>

<formalpara>
<para>
<simpara>
<para>
<formalpara>
<title>
<simpara>
<para>
<para>
<para>
<para>Это параграф. Он может содержать
 практически любой другой элемент.</para>

<blockquote>
<para>Короткий отрывок из Конституции США;</para>

<blockquote>
  <title>Preamble to the Constitution of the United States</title>

  <attribution>Copied from a web site somewhere</attribution>

  <para>We the People of the United States, in Order to form a more perfect
    Union, establish Justice, insure domestic Tranquility, provide for the
    common defence, promote the general Welfare, and secure the Blessings
    of Liberty to ourselves and our Posterity, do ordain and establish this
    Constitution for the United States of America.</para>
</blockquote>

<tip>
<note>
<warning>
<caution>
<important>
<sidebar>
<warning>
<warning>
  <para>Установка FreeBSD может привести к желанию удалить Windows с вашего
    винчестера.</para>
</warning>

<itemizedlist>
<orderedlist>
<procedure>
<itemizedlist>
<orderedlist>
<ul>
<ol>
<listitem>
<listitem>
<listitem>
<li>
<procedure>
<step>
<step>
<substep>
<step>
<itemizedlist>
<orderedlist>
<procedure>
<itemizedlist>
  <listitem>
    <para>Это первый списочный элемент.</para>
  </listitem>

  <listitem>
    <para>Это второй списочный элемент.</para>
  </listitem>
</itemizedlist>

<orderedlist>
  <listitem>
    <para>Это первый упорядоченный элемент.</para>
  </listitem>

  <listitem>
    <para>Это второй упорядоченный элемент.</para>
  </listitem>
</orderedlist>

<procedure>
  <step>
    <para>Сделайте это.</para>
  </step>

  <step>
    <para>Затем сделайте то.</para>
  </step>

  <step>
    <para>А теперь сделайте вот так.</para>
  </step>
</procedure>

<programlisting>
<programlisting>
<programlisting>
<para>Когда вы закончите, ваша программа должна
  иметь примерно такой вид:</para>

<programlisting>#include &lt;stdio.h&gt;

int
main(void)
{
    printf("hello, world\n");
}</programlisting>

#include
#include <stdio.h>

int
main(void)
{
    printf("hello, world\n");
}

<programlisting>
<literallayout>
<co>
id
<calloutlist>
<co>
<calloutlist>
<para>Когда вы закончите, ваша программа
  должна иметь примерно такой вид;</para>

<programlisting>#include &lt;stdio.h&gt; <co id="co-ex-include">

int <co id="co-ex-return">
main(void)
{
    printf("hello, world\n"); <co id="co-ex-printf">
}</programlisting>

<calloutlist>
  <callout arearefs="co-ex-include">
    <para>Включение стандартного файла объявлений IO.</para>
  </callout>

  <callout arearefs="co-ex-return">
    <para>Указывает на то, что <function>main()</function> возвращает
      int.</para>
  </callout>

  <callout arearefs="co-ex-printf">
    <para>Вызов <function>printf()</function>, который выдает
      <literal>hello, world</literal> на стандартный вывод.</para>
  </callout>
</calloutlist>

#include <stdio.h> 

int 
main(void)
{
    printf("hello, world\n"); 
}

hello, world
<table>
<tgroup>
<thead>
<tbody>
<tgroup>
<thead>
<row>
<entry>
<entry>
<informaltable>
<informaltable frame="none" pgwide="1">
  <tgroup cols="2">
    <thead>
      <row>
    <entry>Это заголовок столбца 1</entry>
    <entry>Это заголовок столбца 2</entry>
      </row>
    </thead>

    <tbody>
      <row>
    <entry>Строка 1, столбец 1</entry>
    <entry>Строка 1, столбец 2</entry>
      </row>

      <row>
    <entry>Строка 2, столбец 1</entry>
    <entry>Строка 2, столбец 2</entry>
      </row>
    </tbody>
  </tgroup>
</informaltable>

<informaltable>
pgwide
1
<informaltable>
frame
none
<informaltable frame="none">
frame="none"
<screen>
<screen>
<screen>
<prompt>
&prompt.root;
&prompt.user;
<prompt>
&prompt.root;
&prompt.user;
<prompt>
&prompt.root;
&prompt.user;
<userinput>
<userinput>
<screen>
<prompt>
<userinput>
<screen>&prompt.user; <userinput>ls -1</userinput>
foo1
foo2
foo3
&prompt.user; <userinput>ls -1 | grep foo2</userinput>
foo2
&prompt.user; <userinput>su</userinput>
<prompt>Password: </prompt>
&prompt.root; <userinput>cat foo2</userinput>
This is the file called 'foo2'</screen>

% ls -1
foo1
foo2
foo3
% ls -1 | grep foo2
foo2
% su
Password: 
# cat foo2
This is the file called 'foo2'

foo2
<programlisting>
<programlisting>
<emphasis>
<b>
<i>
<important>
<emphasis>
<emphasis>
<para>FreeBSD, без сомнения, является
  <emphasis>наилучшей</emphasis> операционной Unix-подобной системой для
  архитектуры Intel.</para>

<quote>
<quote>
<para>Несмотря на это убедитесь, что поиск не выходит за
  <quote>пределы между локальным и публичным администрированием</quote>,
  как RFC 1535 описывает это.</para>

<keycap>
<mousebutton>
<keycombo>
<keycombo>
action
click
double-click
other
press
seq
simul
+
<keycombo>
<para>Чтобы переключиться во второй
    виртуальный терминал, нажмите <keycombo action="simul"><keycap>Alt</keycap>
    <keycap>F1</keycap></keycombo>.</para>

<para>Чтобы выйти из редактора <command>vi</command> без сохранения вашей
  работы, наберите
  <keycombo action="seq"><keycap>Esc</keycap><keycap>:</keycap>
  <keycap>q</keycap><keycap>!</keycap></keycombo>.</para>

<para>Мой оконный менеджер настроен так, что
  <keycombo action="simul"><keycap>Alt</keycap>
    <mousebutton>right</mousebutton>
  </keycombo> кнопка мыши используется для передвижения
  окон.</para>

vi
<application>
<citerefentry>
<refentrytitle>
<manvolnum>
<refentrytitle>
<manvolnum>
&man.manual-page.manual-section;
doc/share/sgml/man-refs.ent
PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN"

<!DOCTYPE book PUBLIC "-//FreeBSD//DTD DocBook V4.1-Based Extension//EN" [

<!ENTITY % man PUBLIC "-//FreeBSD//ENTITIES DocBook Manual Page Entities//EN">
%man;

...

]>

<command>
<option>
&man.command.sec
tion;
<command>
<para><application>Sendmail</application>
  является наиболее часто используемым почтовым приложением Unix.</para>

<para><application>Sendmail</application> включает программы
  <citerefentry>
    <refentrytitle>sendmail</refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>, &man.mailq.8; и &man.newaliases.8;.</para>

<para>Один из параметров командной строки для
  <citerefentry>
    <refentrytitle>sendmail</refentrytitle>
    <manvolnum>8</manvolnum>
  </citerefentry>, <option>-bp</option>, будет выводить текущее состояние
  сообщений в почтовой очереди.  Проверьте это, запустив из командной строки
  <command>sendmail -bp</command>.</para>

sendmail -bp
&man.command.section;
<filename>
<filename>
<para>Исходный код SGML для Руководства на
 английском языке можно найти в каталоге
 <filename>/usr/doc/en/handbook/</filename>. В этом каталоге первый файл
 называется <filename>handbook.sgml</filename>. Вы также должны посмотреть на
 <filename>Makefile</filename> и некоторое количество файлов с расширением
 <filename>.ent</filename>.</para>

/usr/doc/en/handbook/
handbook.sgml
Makefile
.ent
<filename>
role
/usr/ports
<filename>
role
<para>Установите <filename role="package">net/ethereal</filename> для просмотра сетевого трафика.</para>

net/ethereal
/dev
<devicename>
/dev
<devicename>
<para><devicename>sio</devicename> используется
 для коммуникаций по последовательным каналам по FreeBSD.
 <devicename>sio</devicename> доступно через несколько файлов устройств из
 <filename>/dev</filename>, включая <filename>/dev/ttyd0</filename>
 и <filename>/dev/cuaa0</filename>.</para>

<para>В отличие от него, сетевые устройства, такие, как
  <devicename>ed0</devicename>, не присутствуют в <filename>/dev</filename>.</para>

<para>В MS-DOS первый дисковод обозначается как
 <devicename>a:</devicename>. Во FreeBSD это
 <filename>/dev/fd0</filename>.</para>

sio
sio
/dev
/dev/ttyd0
/dev/cuaa0
ed0
/dev
a:
/dev/fd0
</hostid>
role
role="hostname"
<hostid>
<hostid>
freefall
wcarchive
role="hostname"
role="domainname"
FreeBSD.org
ngo.org.uk
role="fqdn"
role="ipaddr"
role="ip6addr"
role="netmask"
/
role="mac"
<hostid>
<para>Собственно машину всегда можно
  обозначить по имени <hostid>localhost</hostid> с IP-адресом <hostid
  role="ipaddr">127.0.0.1</hostid>.</para>

<para>Домен <hostid role="domainname">FreeBSD.org</hostid> содержит несколько
  различных хостов, включая <hostid role="fqdn">freefall.FreeBSD.org</hostid>
  и <hostid role="fqdn">bento.FreeBSD.org</hostid>.</para>

<para>При добавлении алиаса IP к интерфейсу (при помощи
  <command>ifconfig</command>) <emphasis>всегда</emphasis> используйте сетевую
  маску <hostid role="netmask">255.255.255.255</hostid> (что может быть
  записано также как <hostid
  role="netmask">0xffffffff</hostid>.</para>

<para>MAC-адрес однозначно идентифицирует любую существующий сетевой адаптер.
 Типичный MAC-адрес выглядит как <hostid
 role="mac">08:00:20:87:ef:d0</hostid>.</para>

localhost
127.0.0.1
FreeBSD.org
freefall.FreeBSD.org
bento.FreeBSD.org
ifconfig
255.255.255.255
0xffffffff
08:00:20:87:ef:d0
root
bin
<username>
<username>
<para>Для выполнения большинства функций
  системного администрирования вам нужно быть пользователем
  <username>root</username>.</para>

root
Makefile
Makefile
<maketarget>
<makevar>
<maketarget>
Makefile
make
<makevar>
make
Makefile
<maketarget>
<makevar>
<para>Двумя распространенными целями в
  <filename>Makefile</filename> являются <maketarget>all</maketarget> и
  <maketarget>clean</maketarget>.</para>

<para>Обычно вызов <maketarget>all</maketarget> приводит к перестроению
  приложения, а вызов <maketarget>clean</maketarget> удаляет временные файлы
  (к примеру, <filename>.o</filename>), созданные в процессе построения.</para>

<para><maketarget>clean</maketarget> может контролироваться несколькими
  переменными, среди которых <makevar>CLOBBER</makevar> и
  <makevar>RECURSE</makevar>.</para>

Makefile
all
clean
all
clean
.o
clean
CLOBBER
RECURSE
<programlisting>
<programlisting>
<literal>
<literal>
<para>Строка <literal>maxusers
  10</literal> в файле конфигурации ядра определяет размер многих системных
  таблиц, и примерно задает количество одновременных входов, которые может
  поддерживать система.</para>

maxusers 10
<replaceable>
<replaceable>
<informalexample>
  <screen>&prompt.user; <userinput>man <replaceable>команда</replaceable></userinput></screen>
</informalexample>

% man команда

<replaceable>
<literal>
<replaceable>
<para>Строка <literal>maxusers <replaceable>n</replaceable></literal>
  в файле конфигурации ядра определяет размер многих системных таблиц, и
  примерно задает количество одновременных входов, которое поддерживает
  система.</para>

<para>Для настольной рабочей станции в качестве <replaceable>n</replaceable>
  подойдет значение <literal>32</literal>.</para>

maxusers n
n
32
<errorname>
<errorname>
<screen><errorname>Panic: cannot mount root</errorname></screen>

“Panic: cannot mount root”

graphics/ImageMagick
Makefile
textproc/docproj
doc/en_US.ISO8859-1/articles/vm-design/
.eps
.png
Makefile
<mediaobject>
<mediaobject>
<imageobject>
<textobject>
<imageobject>
<textobject>
<imageobject>
<textobject>
fig1
<mediaobject>
  <imageobject>
    <imagedata fileref="fig1"> 
  </imageobject>

  <textobject>
    <literallayout class="monospaced">+---------------+ 
|       A       |
+---------------+</literallayout>
  </textobject>

  <textobject>
    <phrase>Рисунок</phrase> 
  </textobject>
</mediaobject>

<imagedata>
<imageobject>
fileref
<textobject>
<literallayout>
class
monospaced
<literallayout>
<textobject>
<phrase>
alt
Makefile
Makefile
IMAGES
fig1.eps
fig2.png
fig3.png
Makefile
...
IMAGES= fig1.eps fig2.png fig3.png
...

...
IMAGES=  fig1.eps
IMAGES+= fig2.png
IMAGES+= fig3.png
...

Makefile
chapter1/chapter.sgml
chapter2/chapter.sgml
chapter3/chapter.sgml
chapter1/
chapter2/
chapter3/
IMAGES
Makefile
<imagedata>
chapter1/fig1.png
chapter1/chapter.sgml
<mediaobject>
  <imageobject>
    <imagedata fileref="chapter1/fig1"> 
  </imageobject>

  ...

</mediaobject>

fileref
Makefile
...
IMAGES=  chapter1/fig1.png
...

id
id
id в главах и разделах
<chapter id="chapter1">
  <title>Введение</title>

<para>Это введение. Оно содержит подраздел, который идентифицируется.</para>

  <sect1 id="chapter1-sect1">
    <title>Подраздел 1</title>

    <para>Это подраздел.</para>
  </sect1>
</chapter>

id
id
<anchor>
id
<anchor>
<para>В этом параграфе имеется встроенная
 <anchor id="para1">ссылка на него. Она не будет показываться в
 документе.</para>

id
<xref>
<link>
linkend
id
<xref>
<xref>
id
<para>Дополнительная информация может
  быть найдена в <xref linkend="chapter1">.</para>

<para>Более конкретная информация находится в
  <xref linkend="chapter1-sect1">.</para>

<xref>
id
<anchor>
<anchor>
<xref>
<link>
<link>
id
<para>Дополнительная информация может быть
  найдена в <link linkend="chapter1">первой главе</link>.</para>

<para>Более конкретная информация находится в <link
  linkend="chapter1-sect1">этом</link> разделе.</para>

<link>
id
<anchor>
<link>
<ulink>
url
<ulink>
<para>Конечно, вы можете прекратить чтение
  этого документа и перейти на <ulink url="&url.base;/ru/index.html">домашнюю
  страницу FreeBSD</ulink>.</para>

textproc/dsssl-docbook-modular
doc/share/sgml/freebsd.dsl
docbook.css
doc/share/misc/docbook.css
doc/
doc/
doc/
doc/
share/
share/mk
share/sgml
lang.encoding/
en_US.ISO8859-1/
zh_TW.Big5/
lang.encoding/
articles
<article>
books
<book>
man
mann
lang.encoding
books/handbook/
<book>
<part>
<chapter>
<sect1>
<sect2>
<sect3>
handbook
Makefile
Makefile
doc.project.mk
book.sgml
book.sgml
.ent
directory/chapter.sgml
chapter.sgml
id
<chapter>
<chapter id="kernelconfiguration">
...
</chapter>

chapter.sgml
kernelconfiguration
kernelconfiguration.html
id
book.sgml
id
<chapter>
chapter.sgml
basics/chapter.sgml
introduction/chapter.sgml
printing/chapter.sgml
chapter.sgml
Makefile
doc.project.mk
Makefile
Makefile
Makefile
doc.xxx.mk
Makefile
SUBDIR =articles
SUBDIR+=books

COMPAT_SYMLINK = en

DOC_PREFIX?= ${.CURDIR}/..
.include "${DOC_PREFIX}/share/mk/doc.project.mk"

SUBDIR
COMPAT_SYMLINK
DOC_PREFIX
SUBDIR
COMPAT_SYMLINK
SUBDIR
SUBDIR
articles books
DOC_PREFIX
DOC_PREFIX
Makefile
SUBDIR
COMPAT_SYMLINK
doc/en
en_US.ISO-8859-1
DOC_PREFIX
.CURDIR
doc.project.mk
make
MAINTAINER=nik@FreeBSD.org

DOC?= book

FORMATS?= html-split html

INSTALL_COMPRESSED?= gz
INSTALL_ONLY_COMPRESSED?=

# SGML content
SRCS=  book.sgml

DOC_PREFIX?= ${.CURDIR}/../../..

.include "$(DOC_PREFIX)/share/mk/docproj.docbook.mk"

MAINTAINER
DOC
.sgml
SRCS
FORMATS
INSTALL_COMPRESSED
INSTALL_ONLY_COMPRESS
DOC_PREFIX
doc.project.mk
doc.subdir.mk
doc.install.mk
doc.docbook.mk
DOCFORMAT
docbook
DOC
DOCFORMAT?=    docbook
MAINTAINER?=    doc@FreeBSD.org

PREFIX?=    /usr/local
PRI_LANG?=  en_US.ISO8859-1

.if defined(DOC)
.if ${DOCFORMAT} == "docbook"
.include "doc.docbook.mk"
.endif
.endif

.include "doc.subdir.mk"
.include "doc.install.mk"

DOCFORMAT
MAINTAINER
PREFIX
/usr/local
PRI_LANG
PRI_LANG
.if defined(DOC)
defined
.if ${DOCFORMAT} == "docbook"
DOCFORMAT
"docbook"
doc.docbook.mk
.endif
SUBDIR
ROOT_SYMLINKS
PRI_LANG
COMPAT_SYMLINK
target: dependency1
dependency2 ...
target
.USE
_SUBDIRUSE: .USE
.for entry in ${SUBDIR}
    @${ECHO} "===> ${DIRPRFX}${entry}"
    @(cd ${.CURDIR}/${entry} && \
    ${MAKE} ${.TARGET:S/realpackage/package/:S/realinstall/install/} DIRPRFX=${DIRPRFX}${entry}/ )
.endfor

_SUBDIRUSE
.TARGET
clean: _SUBDIRUSE
    rm -f ${CLEANFILES}

clean
_SUBDIRUSE
rm -f ${CLEANFILES}
clean
install
package
realinstall
realpackage
clean
cleandir
exists
empty
target
.for
_SUBDIRUSE: .USE
.for entry in ${SUBDIR}
    @${ECHO} "===> ${DIRPRFX}${entry}"
    @(cd ${.CURDIR}/${entry} && \
    ${MAKE} ${.TARGET:S/realpackage/package/:S/realinstall/install/} DIRPRFX=${DIRPRFX}${entry}/ )
.endfor

SUBDIR
.for
.endfor
entry
# pkg_delete jade-1.1

www
doc-all
cvs-base
ports-base
src
doc
www
ports
# mkdir /var/tmp/webbuild
# cd /var/tmp/webbuild

# cvs -R co www doc

www/en
all
# cd en
# make all

en
# cd path/www/en

install
DESTDIR
# make DESTDIR=/usr/local/www install

# find /usr/local/www -ctime 3 -print0 | xargs -0 rm

CVSROOT
# CVSROOT=/home/ncvs; export CVSROOT

ENGLISH_ONLY
# make ENGLISH_ONLY=YES all install

ENGLISH_ONLY
ENGLISH_ONLY
# make ENGLISH_ONLY="" all install clean

WEB_ONLY
# make WEB_ONLY=YES all install

NOPORTSCVS
/usr/ports
PORTSBASE
CVSROOT
WEB_ONLY
ENGLISH_ONLY
NOPORTSCVS
/etc/make.conf
Makefile.inc
ваш
язык
doc/
/usr/share/misc/iso639
doc/
    sv_SE.ISO8859-1/
                 Makefile
                 books/
                       faq/
                           Makefile
                           book.sgml

sv_SE.ISO8859-1
язык.кодировка
% cd doc
% tar cf swedish-docs.tar sv
% gzip -9 swedish-docs.tar

swedish-docs.tar.gz
make all
sv_SE.ISO8859-1
make install
textproc/iso8879
/usr/local/share/sgml/iso8879
<!--
     The FreeBSD Documentation Project

     $FreeBSD: doc/en_US.ISO8859-1/books/fdp-primer/translations/chapter.sgml,v 1.5 2000/07/07 18:38:38 dannyboy Exp $
-->

The FreeBSD Documentation Project
$FreeBSD$
FreeBSD Documentation Project
The
FreeBSD язык Documentation Project
<!--
     The FreeBSD Spanish Documentation Project

     $FreeBSD: doc/es_ES.ISO8859-1/books/fdp-primer/translations/chapter.sgml,v 1.3 1999/06/24 19:12:32 jesusr Exp $
     Original revision: 1.11
-->

cvsup
cvsup
/etc/rc.local
/etc/rc.local
<citerefentry>
man csh
H
<para>
<PARA>
<!ENTITY...>
<!DOCTYPE...>
<!entity...>
<!doctype...>
role
+--- This is column 0
V
<chapter>
  <title>...</title>

  <sect1>
    <title>...</title>

    <sect2>
      <title>Отступы</title>

      <para>Каждый файл начинается с отступа в колонке 0,
    <emphasis>независимо</emphasis> от отступа файла, который может
    включать этот файл.</para>

      <para>Каждая открывающая метка увеличивает отступ на 2 пробела, а каждая
    закрывающая метка уменьшает его на 2 пробела.  Заменяйте начальные
    пробелы символами табуляции, насколько это возможно.  Не используйте
    пробелы перед символами табуляции, и не добавляйте дополнительных
    пробелов в конце строки.  Содержимое элементов должно иметь отступ в
    два пробела, если содержимое превышает по размеру одну строку.</para>

      ...   
    </sect2>
  </sect1>
</chapter>

sgml-mode
augroup sgmledit
  autocmd FileType sgml set formatoptions=cq2l " Special formatting options
  autocmd FileType sgml set textwidth=70       " Wrap lines at 70 columns
  autocmd FileType sgml set shiftwidth=2       " Automatically indent
  autocmd FileType sgml set softtabstop=2      " Tab key indents 2 spaces
  autocmd FileType sgml set tabstop=8          " Replace 8 spaces with a tab
  autocmd FileType sgml set autoindent         " Automatic indentation
augroup END

<article>
  <articleinfo>
    <title>NIS</title>

    <pubdate>Октябрь 1999</pubdate>

    <abstract>
      <para>...
    ...
    ...</para>
    </abstract>
  </articleinfo>

  <sect1>
    <title>...</title>

    <para>...</para>
  </sect1>

  <sect1>
    <title>...</title>

    <para>...</para>
  </sect1>
</article>

<itemizedlist>
<para>
<term>
Data capacity ranges from 40 MB to 15GB. Hardware compression ...

&nbsp;
57600&nbsp;bps

FreeBSD&nbsp;4.7

Sun&nbsp;Microsystems

sgml-mode
.sgml
M-x sgml-mode
C-c C-e
sgml-insert-element
C-c =
sgml-change-element-name
C-c C-r
sgml-tag-region
C-c -
sgml-untag-element
C-c C-q
sgml-fill-element
<programlisting>
C-c C-a
sgml-edit-attributes
C-k
C-c
C-c C-v
sgml-validate
.emacs
    (setq sgml-mode-hook
      '(lambda ()
     (setq fill-column 70
           indent-tabs-mode nil
           next-line-add-newlines nil
           standard-indent 2)
     (auto-fill-mode t)))

doc
<book>
<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>

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

<article>
  <articleinfo>
    <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>
  </articleinfo>

  <sect1>
    <title>Мой первый раздел</title>

    <para>Это первый раздел моей статьи.</para>

    <sect2>
      <title>Мой первый подраздел</title>

      <para>Это первый подраздел моей статьи.</para>
    </sect2>
  </sect1>
</article>

textproc/docproj
/usr/local/
PATH
% jade -V nochunks \  
    -c /usr/local/share/sgml/docbook/dsssl/modular/catalog \ 
    -c /usr/local/share/sgml/docbook/catalog \
    -c /usr/local/share/sgml/jade/catalog \
    -d /usr/local/share/sgml/docbook/dsssl/modular/html/docbook.dsl \
    -t sgml  file.sgml > file.html 

nochunks
.html
% jade \
    -c /usr/local/share/sgml/docbook/dsssl/modular/catalog \ 
    -c /usr/local/share/sgml/docbook/catalog \
    -c /usr/local/share/sgml/jade/catalog \
    -d /usr/local/share/sgml/docbook/dsssl/modular/html/docbook.dsl \
    -t sgml  file.sgml 

% jade -Vtex-backend \ 
    -c /usr/local/share/sgml/docbook/dsssl/modular/catalog \ 
    -c /usr/local/share/sgml/docbook/catalog \
    -c /usr/local/share/sgml/jade/catalog \
    -d /usr/local/share/sgml/docbook/dsssl/modular/print/docbook.dsl \
    -t tex  file.sgml

.tex
tex
&jadetex
% tex "&jadetex" file.tex

tex
LaTeX Warning: Reference `136' on page 5 undefined on input line
728.
file.dvi
dvips
.dvi
% dvips -o file.ps file.dvi

jade
.tex
% pdftex "&pdfjadetex" file.tex

file.pdf

Пользователь	Приглашение
Обычный пользователь	`%`
`root`	`#`

Значение	Примеры
Названия команд, имена файлов и каталогов. Выдача на экран.	Отредактируйте ваш файл `.login`. Используйте команду `ls -a` для выдачи списка всех файлов. You have mail.
То, что набираете вы, когда это отличается от экранной выдачи компьютером.	`%` `su` Password:
Ссылки на страницы справочной системы.	Воспользуйтесь командой su(1) для смены имени пользователя.
Имена пользователей и групп	Только `root` может это делать.
Выделение	Вы должны это сделать.
Переменные параметры командной строки; заменяйте их реальными названиями или значениями.	Для удаления файла наберите `rm filename`
Переменные окружения	`$HOME` является вашим домашним каталогом.

Столбец	Значение
1	Название программы, обнаружившей ошибку. Это всегда будет `nsgmls`.
2	Имя файла, содержащего ошибку.
3	Номер строки, в которой появилась ошибка.
4	Номер колонки, в которой появилась ошибка.
5	Однобуквенный код, обозначающий природу сообщения. `I` обозначает информационное сообщение, `W` для предупреждений и `E` для ошибок [a] и `X` для перекрестных ссылок. Как видите, это сообщения об ошибках.
6	Текст диагностического сообщения.
Примечания: a. Пятая колонка выводится не всегда. `nsgmls -sv` выдает `nsgmls:I: SP version "1.3"` (это зависит от установленной версии). Как вы можете видеть, это информационное сообщение.

[1]	P - Параметризированные сущности используют символ P - процента.
[2]	Это позор. Представьте все проблемы и хэки (такие, как Server Side Includes), которых можно было бы избежать, если бы это было сделано.
[3]	Краткая история находится по адресу http://www.oasis-open.org/committees/docbook/intro.shtml.
[4]	В DocBook есть и другие типы элементов списка, но пока мы их не рассматриваем.

Это заголовок столбца 1	Это заголовок столбца 2
Строка 1, столбец 1	Строка 1, столбец 2
Строка 2, столбец 1	Строка 2, столбец 2

The FreeBSD Documentation Project

Используемые сокращения

Глава 1. Обзор

Глава 2. Инструменты

Глава 3. Учебник SGML

Глава 4. Разметка SGML

Глава 5. * Таблицы стилей

Глава 6. Структурирование документов в doc/

Глава 7. Процесс построения документации

Глава 8. Web-сервер

Глава 9. Переводы

Глава 10. Стиль написания

Глава 6. Структурирование документов в `doc/`