Как цитировать работы и ссылаться на части текста

Научный текст указывает в две стороны: наружу — на источники, на которые он опирается, и внутрь — на собственные теоремы, рисунки и формулы. Это руководство делает и то и другое: ссылку на источник, по которой читатель может перейти, тот же источник в списке источников работы и ссылки на части своего текста и чужих работ.

Сослаться на источник в сноске

1. Сразу после утверждения, которое опирается на источник, поставьте метку сноски с понятной вам меткой, например [^knuth1974].
2. В любом месте документа, на отдельной строке, напишите саму сноску: источник в том виде, в каком он должен быть напечатан, с DOI или ссылкой на arXiv, если они есть.

Общий случай разобрал Кнут.[^knuth1974]
 
[^knuth1974]: D. E. Knuth, "Structured programming with go to statements",
    *Computing Surveys* 6 (1974), 261–301. <https://doi.org/10.1145/356635.356640>

Страница нумерует сноски 1, 2, 3 в порядке первого упоминания и собирает их в конце работы, у каждой — ссылка обратно к месту, где на неё сослались. Метка нужна только вам: читатель видит номер. Повторная ссылка на тот же источник использует ту же сноску и тот же номер. Сноска в несколько строк пишется с отступом в четыре пробела после первой строки.

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

Внести источник в список источников работы

У работы есть ещё и список источников, который показывается под текстом. Там читатель может открыть каждый источник, скопировать его в BibTeX, RIS или CSL-JSON или сохранить в свою библиотеку цитирований.

1. Закройте редактор и откройте вкладку Ссылки в форме работы.
2. Выберите Добавить ссылку.
3. Чтобы взять запись из своей библиотеки цитирований, найдите её в Из моей библиотеки. Чтобы ввести новую, выберите Добавить новую и заполните тип, заголовок, авторов, год, издание и DOI или URL. Отметьте Также добавить в мою библиотеку цитирований, чтобы сохранить её на следующий раз.
4. Выберите Сохранить.

Запись появится на вкладке Ссылки и на опубликованной странице под текстом. Ваша библиотека цитирований, куда можно разом импортировать выгрузки BibTeX, RIS или Zotero, находится на сайте по адресу /library/citations.

Почему не [@ключ]

Форма со скобками и @ — [@knuth1974] или [@knuth1974, p. 33] — это синтаксис цитирования, который читает pandoc, и LibreTimes резервирует его для ссылок, разрешаемых по списку источников. Это разрешение ещё не сделано, поэтому сегодня опубликованная страница показывает текст ровно так, как вы его набрали. Пока этого нет, пользуйтесь сносками. Что синтаксис уже делает — сохраняет ключ в целости: он никогда не превращается в ссылку на профиль, хотя ключ похож на упоминание.

Файл LaTeX или Word, который вы импортируете, приходит уже преобразованным: ссылки на источники становятся в тексте нумерованными метками вроде [1], а библиография — списком источников.

Ссылка на часть своего текста

Внутри одного документа ссылка — это обычная ссылка на якорь, имя, которое вы даёте блоку.

1. Дайте блоку якорь:
   • у заголовка он уже есть, из его текста: у ## Main result это #main-result;
   • утверждение или рисунок получают его в ограде: :::theorem[Лагранж]{#lagrange}, ::::figure{#fig-orbit};
   • любой другой блок, например выключная формула или таблица, получает его в строке атрибутов прямо над собой: {#eq-energy}.
2. Сошлитесь на него как [текст ссылки](#имя), а если у блока есть номер, впишите его в текст ссылки сами.

:::theorem[Лагранж]{#lagrange number=2.2}
Если $H$ — подгруппа конечной группы $G$, то $|H|$ делит $|G|$.
:::
 
{#eq-index}
$$
|G| = [G : H]\,|H| \tag{3}
$$
 
По [теореме 2.2](#lagrange) или прямо из [(3)](#eq-index) у группы простого
порядка нет собственных нетривиальных подгрупп.

Щелчок по любой из ссылок прокручивает страницу к её цели. Страница пока не подставляет «Теорема 2.2» или «Рисунок 3» сама, поэтому текст ссылки пишете вы: следите, чтобы он совпадал с номерами, которые вы дали.

Выбирайте имена по тому, что это за блок, а не где он стоит: #lagrange останется верным, когда выше добавится теорема, а #theorem-3 — нет. Имя начинается с латинской буквы, состоит из латинских букв, цифр, -, _, . и : и используется в документе один раз; имя с . или : пишется как {id="eq:2.1"}.

Ссылка на часть другой работы

1. Откройте другую работу и скопируйте её адрес, который заканчивается на /works/<id>.
2. Добавьте якорь после #. Перед именем, которое выбрал автор, стоит user-content-, так что {#lagrange} в той работе — это /works/<id>#user-content-lagrange. Якорь заголовка, #p412 печатной страницы и #p-412 задачи пишутся как есть.
3. Сошлитесь на результат: [теорема Лагранжа](https://libretimes.io/works/<id>#user-content-lagrange).

Префикс не даёт именам автора совпасть с частями самой страницы; ссылкам внутри документа он добавляется автоматически, поэтому писать его нужно только в ссылках извне. Полная таблица — в справочнике.

Результат

В предпросмотре каждая метка сноски — маленький надстрочный номер со ссылкой на сноску в конце, а каждая сноска ссылается обратно. Каждая ссылка на якорь прокручивает к своему блоку. После сохранения на вкладке Ссылки в форме работы перечислены добавленные источники, а опубликованная страница показывает их под текстом. Ссылка, цель которой пропала, никуда не ведёт, поэтому после переименования якоря поищите в документе старое имя.