Org-mode. Сноски

Org-mode. Сноски.

1 Встроенные сноски (краткие)

• В тексте пишете [fn:: текст сноски]:

  Это предложение со сноской[fn:: Короткое примечание].
  

• Не требует отдельного определения и подходит для одноразовых, коротких пояснений.

2 Определённые сноски (с меткой)

• В основном тексте ставите метку [fn:имя] (имя может быть цифрой или словом), а затем где-то в документе (обычно в конце) даёте определение:

  Здесь ставим ссылку[fn:1].
  
  * Сноски
  
  [fn:1] Текст сноски. Может быть длинным,
    состоять из нескольких строк, если каждая следующая строка начинается с отступа.
  

• Метка может быть [fn:1], [fn:note], [fn:my-note] и т.п.

• Определение должно начинаться с [fn:метка] в начале строки.

• Если текст сноски занимает несколько абзацев, между ними оставляйте пустые строки, но после пустой строки снова делайте отступ (пробелы или табуляцию).

3 Многострочные сноски

• Использование явного отступа для многострочности.

  • Все строки, относящиеся к сноске, должны иметь отступ относительно строки с [fn:...].
  • Отступом может быть один или несколько пробелов либо символ табуляции.
  • Если строка начинается без отступа, Org-mode посчитает её началом нового определения или части документа.

• Нельзя оставлять пустую строку между меткой сноски и её содержимым. Тогда Org-mode может не связать их.

• Пустые строки внутри определения допустимы, но после них отступ должен сохраняться.

• Если сноска определяется в отдельном месте, лучше явно указать её метку и сразу после неё (на той же строке или со следующей) начать текст с отступом.

3.1 Варианты оформления

• Определение сноски сразу после метки в тексте

  Здесь идёт основной текст с первой сноской[fn:1].
  
  [fn:1] Это первая строка сноски.
    Это вторая строка, которая начинается с отступа.
    А это третья строка — тоже с отступом.
  

• Определение сноски отдельным блоком (например, в конце документа)

  Текст с другой сноской[fn:long].
  
  * Сноски
  
  [fn:long] Первый абзац сноски.
  
    Второй абзац (отделяется пустой строкой) тоже является частью этой сноски.
    Для продолжения того же абзаца можно просто сделать отступ.
  

3.2 Пример с несколькими абзацами и списком

[fn:example] Первый абзац.

  Второй абзац. Здесь может быть любой текст, в том числе списки:
  - пункт 1
  - пункт 2

    Ещё один абзац внутри сноски — снова с отступом.

4 Повторное использование

• Можно ставить несколько ссылок на одну и ту же сноску.
• Для этого в тексте используйте [fn:имя] несколько раз.
• Определение сноски пишется один раз.

5 Сочетания клавиш

• C-c C-x f : вставить/обновить сноску.
• C-c C-x F : перейти к определению сноски.
• C-c C-c на определении сноски : вернуться к месту ссылки.

6 Расположение определений сносок

• Определения сносок могут находиться:
  • сразу после абзаца, где встречается первая ссылка,
  • в конце документа (в отдельном заголовке * Footnotes),
  • в неком другом месте.