Сноски
Как ставить сноски через [^метка], писать длинные и многоабзацные примечания и где они показываются и как нумеруются
Сноска выносит отступление из фразы, не теряя его: источник, техническую оговорку, деталь доказательства, которую большинство читателей пропустит. Вы отмечаете место в тексте и пишете примечание где угодно в документе, а страница сама нумерует примечания и собирает их в конце.
Синтаксис
У сноски две половины. Ссылка [^метка] ставится в тексте сразу после
слова или знака препинания, к которому относится. Определение
[^метка]: текст пишется отдельной строкой в любом месте документа:
Позже оценку улучшили до .1
Позже оценку улучшили до $O(n \log n)$.[^tao2019]
[^tao2019]: T. Tao, «Universality of random matrices», 2019.Отрисованное примечание — в самом низу этой страницы, под последним разделом, со стрелкой, которая возвращает к месту ссылки. В публикации всё так же.
Как работает нумерация
- Читатель видит номера, а не ваши метки. Примечания нумеруются 1, 2, 3
в порядке первой ссылки в тексте, а не в порядке определений.
[^tao2019]показывается как надстрочный номер. - Метки — для вас. Выбирайте такие, по которым понятно, что это за
примечание (
[^tao2019],[^набросок]), — так его легко найти при правке. Метка — слово без пробелов. Цифры тоже годятся ([^1]), но описательная метка переживает перестановку, а номер в исходнике быстро перестаёт совпадать с порядком. - Ссылка на одну сноску дважды использует тот же номер, а у примечания появляется по стрелке на каждую ссылку.
- Определение без единой ссылки не выводится, а ссылка без определения
остаётся буквальным текстом
[^метка]— опечатка видна на странице, а не теряется молча.
Длинные примечания
Примечание может содержать несколько абзацев, список или выносную формулу. Всё после первой строки сдвиньте на четыре пробела:
Формула Стирлинга точна даже при малых .2
Формула Стирлинга точна даже при малых $n$.[^стирлинг]
[^стирлинг]: При $n = 10$ относительная ошибка меньше процента.
Следующий член асимптотического ряда даёт
$$
n! \approx \sqrt{2\pi n}\left(\frac{n}{e}\right)^n \left(1 + \frac{1}{12n}\right).
$$Внутри любого примечания работают оформление текста, ссылки и строчные формулы.
Где писать определения
Где угодно: положение определения не влияет на то, где выводится примечание. В длинном документе помогают две привычки:
- Рядом с абзацем — пока пишете черновик и примечание часть мысли. Исходник тогда читается почти как страница.
- В конце каждого раздела, как обычно собирают ссылки-сноски, — когда примечаний много и они короткие.
В любом случае держитесь одного способа в пределах документа.
Сноски и цитирование
Сегодня источник в документе указывают сноской. Синтаксис [@ключ]
зарезервирован за ссылками на библиографию, но опубликованная страница пока
не разрешает их: она показывает текст как написан. До тех пор цитируйте в
сноске и давайте DOI или ссылку на arXiv, где они есть, — так читатель
попадёт к источнику одним щелчком.
Делайте сноски короткими и немногочисленными. Примечание длиннее абзаца, к которому оно относится, обычно просится в сам текст или в отдельный раздел-приложение.