Сноски

Начало

• Блог
• Интеграция разметки
• Модуль вики
  • Адресация в ссылках
  • Выравнивание текста
  • Горизонтальные черты
  • Действия
  • Заголовки
  • Комментарии
  • Маркеры
  • Мнемоники
  • Модуль вики
  • Отмена элементов разметки
  • Отступы
  • Параметры для форметтеров и действий
  • Простое форматирование
  • Разрывы строк
  • Синтаксис вики-разметки
  • Сноски
  • Списки
  • Ссылки
  • Стили абзацев
  • Сцепление форматтеров и действий
  • Термины (определения)
  • Форматтеры
  • Цитаты
  • Якоря
• Начало
• Файлы конфигурации
• Форматтеры

Сноски очень удобны для отделения документа от какой-то важной, но дополнительной информации — например, в списках, куда не поместится объёмный листинг программы.
Сноски могут быть заданы внутри строки (строчные) — очень удобно для быстрых комментариев (к тому же, их внешний вид настраивается) или на отдельном месте — после абзаца, в конце раздела, документа или где угодно (в пределах этого документа, конечно). ¶

Строчные сноски¶

Задаются прямо в тексте и могут содержать любое строчное вики-форматирование. ¶

<[
  Я говорил ему [[*автору - //прим. перев.//]],
  что основное действо будет происходить в
  одном из городков И. ((*как потом и случилось))...
]>

Как видно из примера, сноски задаются похожим на ссылки образом — круглыми или квадратными скобками, первый символ внутри которых — звёздочка.
После звёздочки (или звёздочек) могут идти пробелы, которые игнорируются как для блочных, так и для строчных сносок: ¶

Первая ((*сноска)), и ((* тот же эффект)).

В зависимости от настройки UWikiSettings->$inlineFootnotesAs можно задавать 3 вида отображения: ¶

tooltip

как подсказка под [?] — режим по умолчанию, виден в примере выше;

expanded

раскрытие в строке внутри скобок: Текст ((*сноска)) текст => Текст (сноска) текст *;

• в зависимости от темы оформления такие развёрнутые строчные сноски могут внешне отличаться от основного текста.

block

полностью повторять поведение обычной блочной сноски.

• если UWikiSettings->$footnotesAtTheEnd включено, то она будет перемещена в конец докумета вместе с прочими сносками, если выключена, то появится после абзаца, где она задана.

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

<[
  Я говорил ему [[*автору - //прим. перев.//]],
  что основное действо будет происходить в
  одном из городков И. ((*как потом и случилось))...
]>

Возможно, что квадратными скобками сноски задавать лучше для смыслового отделения их от обычных ссылок. К тому же, в квадратных скобках в книгах обычно и пишут добавленный текст. ¶

Отменить создание сноски можно тильдой: ¶

Это ~((*не сноска)).

Блочные сноски¶

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

Блочные сноски состоят из двух частей: ¶

1. Ссылающегося фрагмента (обозначается как ссылка со звёздочками внутри);
   • например: предложение... ((*)) или предложение... [[*]].
   • по поводу нескольких звёздочек см. раздел сноски по номеру ниже.
2. Собственно определения сноски.
   • внутри могут быть переводы строк.

Определение сноски задаётся так же, как задаются строчные сноски, но ((* должно быть в начале, а )) — в конце строки (а могут быть и на одной). Перед ((*, как обычно, могут быть пробелы.
Квадратные скобки в определении (типа [[*) работать не будут. ¶

Предложение со ссылкой на сноску [[*]].
((*Определение сноски*))

Либо так [[*]]:
((*
  Определение
  сноски.
))

И всевозможные вариации [[*]]:
((*
  Определение
  сноски.      ))

**Строчная** сноски: [[* квадратные скобки]]

Не указывайте ссылок на сноску на отдельной строке без текста вокруг — она будет скрыта. Также блочная сноска может содержать любое форматирование. ¶

Нормальная сноска ((*)). **Неправильная:**
((*))

Сноска((*)).
((*
  Любое форматирование:
    * списки;
      * ещё.
    * ещё.

  <[
    Цитата:, со списком:
      1. Первый;
      2. Второй.

    И с %%(php) "кодом";%%
  ]>

  %%(html)
    <title>Код прямо в сноске</title>
  %%
))

<title>Код прямо в сноске</title>

Сноски по номеру¶

Выше были описаны ненумерованные сноски с одной звёздочкой — то есть ссылкой по порядку их определения: ¶

Первая сноска((*)),
вторая[[*]], третья((*)).

((* Первая))
((*Вторая))
((*Третья))

Однако можно ещё ссылаться по порядку, ставя несколько звёздочек подряд — до 9 штук, но т. к. одна звёздочка используется для ссылки по порядку определения, то номеров остаётся 8.
Кстати, сноски по номеру — единственный способ сослаться на одно определение несколько раз. ¶

Связь между сноской и её определением устанавливается, если у них одинаковое количество звёздочек — поэтому определения можно делать в любом порядке, так же как и ссылки на них. ¶

Вторая сноска((***)),
третья[[****]], первая((**)),
четвёртая - [[*****]].

((****Третья))
((** Первая))
((***Вторая))
((***** Четвёртая))

Это полезно, когда сноски часто добавляются, удаляются или передвигаются. ¶

Главное, не смешивать ненумеровнные сноски (по одной звёздочке) и по номеру — иначе связь сносок и определений нарушится: ¶

Сноска 2((**)), 1((*)) и 3((***)).
((* №1))
((** №2))
((*** №3?))

Естественно, что 8 номерных сносок даются не на целый документ — их можно использовать повторно, как только все сноски и определения связаны между собой: ¶

Вторая сноска((***)),
третья[[****]], первая((**)),

  ((**** Третья))
  ((** Первая))
  ((*** Вторая))

Теперь **уже другая** первая((**)),
третья((****)) и вторая[[***]].

  ((** Первая))
  ((*** Вторая))
  ((**** Третья))

Таким образом, где определять сноски, решает автор — если используются ненумерованные сноски, то их размещение влияет только на место их отображения в конечном документе (до тех пор пока все сноски в документе и ссылки на них не передвигаются и не удаляются).
Если же это сноски по номеру, то их можно определять, скажем, в конце раздела, либо если сноски используются активно, то удобнее их все определять после использующего их абзаца или нескольких абзацев. ¶

Можно использовать даже смешанную адресацию, пока разные типы ссылки на сноску не пересекается друг с другом: ¶

Правильное((*)) использование
смешанной((*)) адресации((*)).
((* сноска))
((* ещё одна))
((* всё, на сноски больше ссылок нет))

Начался новый абзац((***)) - уже с другой
адресацией((**)), т. к. теперь нечему путаться.
((** сноска))
((*** ещё))

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

Если на сноску не была найдена ссылка, то она будет выведена как есть. Потерянная же ссылка останется звёздочкой. Если же определённая сноска №2-9 была переопределена по номеру, то будет оставлена первая с этим номером, а последующие будут считаться без ссылок на себя. ¶

Сноска №3 ((***)) - но для неё нет
определения - потерянная сноска.

А это - потерянное определение
без ссылок на себя:
((** выводится как есть))

Несколько ссылок¶

Сноски по номеру позволяют сослаться на одно определение сноски из нескольких мест: ¶

Все эти сноски((**)) ссылаются на
одно[[**]] и то же ((**)) место.

((** Сноска с тремя ссылками))

Потерянная сноска ((**)) - её
определение уже было сделано выше.