Практикум

Листинги

Листингом называется блок программного кода на каком-либо языке программирования или разметки, формула, математическое выражение и т. д. Листиг может быть многострочный, либо находящийся на отдельной строке. Фрагменты кода или формул, находящиеся внутри текста (например, внутри абзаца), листингом не считаются (см. ниже). Для выделения листинга существует тег <example>:

<example [number="1.1"] [title="название"] [visible="yes|no]
      [type="example|listing"]>
...
</example>

Если задан атрибут number, на данный листинг будут разрешены ссылки из других лекций курса. Номер отображается сразу после листинга. В зависимости от значения атрибута type, листинг помечается словом "Листинг" (type="listing") или "Пример" (type="example"). Если задан атрибут title, его значение отображается там же. Текст листинга записывается "как есть", т.е. в теле листинга учитываются все пробелы и переводы строк.

Пример:

<example number="1.1" title="Простейшая программа на C"
       type=" listing">
int main()
{
  printf("Hello, world!\n");
}
</example>

Данный текст может быть отображен в виде:

int main()
  {
    printf("Hello, world!\n");
  }
 

Атрибут visible отвечает за отображение листинга на странице лекции. Если visible="no", листинг на странице не отображается, выводится только его название и ссылка, позволяющая открыть текст листинга в отдельном окне.

Списки

Для обозначения упорядоченных и неупорядоченных списков используется контейнер list:

<list [type="none|number"]>
<li>...</li>
<li>...</li>
...
</list>

Внутри контейнера находятся только теги <li>...</li>, в которые заключается для каждая позиция списка.

В зависимости от значения атрибута type список является упорядоченным (type="number") или неупорядоченным (type="none", необязательно). Позиции упорядоченных списков нумеруются, в неупорядоченных списках каждая позиция помечается пулькой (точкой).

Пример 1:

<list type="number">
<li>perl</li>
<li>java</li>
</list>

Данный текст может быть отображен в виде:

1. perl
2. java

Пример 2:

<list>
<li>perl</li>
<li>java</li>
</list>

Данный текст может быть отображен в виде:

• perl
• java

Цитаты

Блок текста отмечается как цитата при помощи тега <quote>. Если цитата содержит несколько абзацев текста, все абзацы выделяются в 1 тег <quote>. Примеры:

<quote>Было бы ошибкой думать...</quote>

<quote>
<p>Первый абзац цитаты</p>
<p>Второй абзац цитаты</p>
</quote>

Цитаты также можно использовать для отображения эпиграфа.

<quote author="Стендаль, &quot;Жизнь Анри Брюлара&quot;">
Мсье Дюпюи [учитель математики] произносил напыщенные фразы об этом предмете, 
но ни разу не сказал этих простых слов: это разделение труда, которое, 
как и всякое другое разделение труда производит чудеса и позволяет уму 
сконцентрировать все свои силы только на одной стороне объектов, только на одном из их качеств.
</quote>

Вставки

Блок текста отмечается как вставка при помощи тега <inset>. У вставки может быть необязательный атрибут icon (предполагается картинка в левом верхнем углу вставки для акцентирования внимания). Значение атрибута icon – URL картинки. Примеры:

<inset>Было бы ошибкой думать...</inset>

<inset icon="impotant.gif">
<p>Первый абзац вставки</p>
<p>Второй абзац вставки</p>
</inset>

Таблицы

Как и в HTML, таблица заключается в тег <table>:

<table [number="1.1"]>
[<caption>Название таблицы</caption>]
<tr>
<th [colspan="1"] [rowspan="1"]>Шапка таблицы</th>
<th [colspan="1"] [rowspan="1"]>Шапка таблицы</th>
</tr>
<tr>
<td [colspan="1"] [rowspan="1"]>Содержимое ячеек</td>
<td [colspan="1"] [rowspan="1"]>Содержимое ячеек</td>
</tr>
</table>

Если задан атрибут number, на таблицу можно будет ссылаться по этому номеру из других лекций. Кроме того, рядом с названием таблицы будет отображен ее номер. Название таблицы размещается в необязательном теге <caption>.

Каждая строка таблицы размещается между тегами <tr>. Ячейки таблицы представлены тегами <th> (ячейка помечается как содержащая заголовок колонки/строки) и <td> (обычная ячейка). Ячейка может быть растянута на несколько ячеек по вертикали (при помощи атрибута rowspan) или по горизонтали (атрибут colspan).

Пример:

<table number="1.1">
  <caption>Тестовая таблица</caption>
  <tr>
<th>Заголовок 1</th>
<th>Заголовок 2</th>
<th>Заголовок 3</th>
  </tr>
  <tr>
<td rowspan="2">высокая ячейка</td>
<td colspan="2">широкая ячейка</td>
  </tr>
  <tr>
<td>просто ячейка 1</td>
<td>просто ячейка 2 </td>
  </tr>
</table>

Данный пример может быть отображен следующим образом: