3.2. Элементы, метки и атрибуты

Все DTD, написанные на SGML, имеют общие характеристики. Этому трудно удивиться, так как это дает о себе знать подход SGML. Одним из очевидных проявлений этого является разделение на содержание и элементы.

Ваша документация (вне зависимости от того, представляет ли она собой одну веб-страницу или большую книгу) состоит из содержимого. Это содержимое затем разбивается (а потом разбивается еще) на элементы. Назначением добавления разметки является именование и идентификация границ этих элементов для дальнейшей обработки.

Например, рассмотрим типичную книгу. На самом верхнем уровне книга сама по себе является элементом. Этот элемент ''book'', естественно, содержит главы, которые будут элементами в своем смысле. Каждая глава будет содержать большее количество элементов, таких, как параграфы, цитаты и примечания. Каждый параграф может содержать дополнительные элементы, идентифицирующие содержимое, которое может являться прямой речью или именем героя в рассказе.

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

Заметьте, как вы можете провести такое разделение между разными элементами содержимого без обращения к терминам SGML. Это на самом деле удивительно понятно. Вы можете сделать это разноцветной ручкой и печатной книгой, используя разные цвета для выделения разных частей содержимого.

Конечно, у нас нет цветной электронной ручки, так что нам нужен какой-то другой способ выделения того, к какому элементу принадлежит каждая часть содержимого. В языках, написанных на SGML (например, HTML и DocBook) это делается в терминах меток.

Метка используется для указания того, где начинается некоторый элемент, и где он кончается. Метка не является частью самого элемента. Так как каждый DTD был написан для разметки специфичного типа информации, каждый может распознавать различные элементы, и поэтому имеет разные названия для меток.

Для элемента с именем element-name начальная метка обычно будет выглядеть как <element-name>. Соответствующей закрывающей меткой для этого элемента будет </element-name>.

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

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

Не все элементы требуют конечной метки. Некоторые элементы не имеют содержимого. К примеру, в HTML вы можете указать, что хотите включить в документ горизонтальную линию. Очевидно, что у этой строки нет содержимого, так что для этого элемента требуется только начальная метка.

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

<hr>

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

Хотя это сейчас не очевидно, но элементы могут включать другие элементы. В примере с книгой ранее, элемент книга содержал все элементы главы, которые, в свою очередь, содержали все элементы параграфы и так далее.

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

DTD задает правила, подробно описывающие, какие элементы могут содержать другие элементы, и в точности то, что они могут содержать.

У элементов могут иметься атрибуты. У атрибута имеется название и значение, и он используется для добавления дополнительной информации к элементу. Это может быть информация о том, как должно быть преобразовано содержимое для вывода на печать, или это может быть что-то, уникальным образом идентифицирующее элемент, или что-то еще.

Атрибуты элемента пишутся внутри начальной метки этого элемента и принимают форму название-атрибута="значение атрибута".

В последних версиях HTML элемент <p> имеет атрибут, под названием align, который задает выравнивание (по отношению к границам) для параграфа программе вывода HTML.

Атрибут align может принимать одно из четырех предопределенных значений, left, center, right и justify. Если атрибут не указан, то по умолчанию используется left.

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

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

Некоторые атрибуты будут воспринимать только конкретные значения, такие, как left или justify. Другие позволят вам задать все, что угодно. Если вам нужно включить двойные кавычки (") в атрибут, то заключите значение атрибута в одинарные кавычки.

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

Иногда вам не нужно вообще заключать значения атрибута в кавычки. Однако условия для этого достаточно тонки, и гораздо проще просто всегда заключать значения атрибутов в кавычки.

Информация об аттрибутах, элементах, и тэгах хранится в SGML каталогах. Различные инструменты Проекта используют эти каталоги для проверки Вашей работы. Утилиты из порта textproc/docproj включают множество различных SGML каталогов. Проект Документирования FreeBSD также имеет свой набор каталогов. И ваши утилиты должны знать об обоих видах SGML каталогов.