Emacs. Org-noter

Emacs. Пакет org-noter.

1 Общая информация

• Репозиторий: https://github.com/org-noter/org-noter
• Предыдущие варианты:
  • https://github.com/weirdNox/org-noter
• Позволяет создавать заметки, которые синхронизируются при прокрутке документа, но являются внешними по отношению к нему.
• Заметки сохраняются в файле org-mode.
• Совместим с DocView , PDF Tools , Nov.el и DJVU-image-mode.
• Позволяет комментировать файлы в форматах PDF, EPUB , Microsoft Office , DVI, PS, OpenDocument, DJVU.

2 Навигация по документу и примечаниям

• Для навигации по документу можно использовать обычные сочетания клавиш:
  • SPC, n, Page-down, down: двигаться вперед в документе.
  • BACKSPACE, p, Page-up, up: вернуться назад в документе.

3 Настройка

• Вы можете установить начальное местоположение для документа, используя org-noter-set-start-location.
• Чтобы автоматически возобновить работу с того места, где вы остановились, используйте org-noter-set-auto-save-last-location.
• С помощью org-noter-set-notes-window-behavior вы можете изменить всплывающее окно заметок.
• С помощью org-noter-set-notes-window-location вы можете изменить позицию, где всплывает окно заметок.
• org-noter-set-doc-split-fraction запросит у вас долю кадра, которую занимает окно документа при разделении.
• org-noter-set-hide-other будет переключать, следует ли скрывать заголовки, не связанные с выполняемым действием.
• org-noter-set-closest-tipping-point установит ближайшую точку записи.

3.1 Вставка примечания без подтверждения

• org-noter-insert-note-no-questions по умолчанию nil.
• Если установлено значение t, приглашение минибуфера заголовка заметки пропускается, и заметка всегда создается с заголовком по умолчанию.
• Активируйте этот параметр, если вы редко или никогда не печатаете собственные заголовки.
• Оба стиля вставки примечаний имеют вариант toggle-no-questions, позволяющий получить поведение не по умолчанию.
• Привязка клавиш по умолчанию для варианта toggle-no-questions добавляет клавишу Control (C-i и C-M-i, соответственно).

3.2 Выделение цветом

• org-noter-highlight-selected-text управляет поведением выделения выделенного текста по умолчанию.
• C-u префикс к любой команде вставки заметки переключает это поведение.

4 Порядок работы

4.1 Открытие сеанса заметок

• Подготовить файл:
  • открыть файл (pdf, djvu, epub);
  • открыть заметку org-roam с ссылкой на рецензируемый файл.
• M-x org-noter

4.2 Настройка расположения окон

• Можно удовольствоваться расположением окон по умолчанию.
• Можно задать своё расположение.
• M-x org-noter-set-doc-split-fraction
• M-x org-noter-set-notes-window-location

4.3 Настройка нескольких столбцов

• Порядок заметок в нескольких столбцах можно настроить на уровне документа или заголовка.
• org-noter-pdf-set-columns вставляет параметр COLUMN_EDGES в свойства текущего заголовка.
• Команда запрашивает количество столбцов, а затем просит вас щёлкнуть по правому краю всех столбцов, кроме последнего.
• Свойство наследуется всеми подзаголовками.

4.4 Скопировать структуру документа в заметку

• M-x org-noter-create-skeleton

4.5 Вставка примечания

4.5.1 insert-note (i)

• Вставляет заметку, связанную с текущей страницей.
• Если заголовок не указан, то используется заголовок по умолчанию «Примечания для страницы <P>», где <P> — метка страницы, если она существует, или номер страницы.
• Если текст выделен и он короткий (org-noter-max-short-selected-text-length), выделенный текст становится заголовком по умолчанию.
• Если вы вводите заголовок, выделенный текст помещается в кавычки в основной части заметки.
• Короткий выделенный текст будет заключён в «кавычки в стиле LaTeX».
• Длинный выделенный текст устанавливается внутри разделителей блока QUOTE.
• В подсказке заголовка Note: вы можете использовать M-p для выбора из заголовков предыдущих заметок или M-n для выбора из значений по умолчанию.
• Если вы выберете заголовок предыдущей заметки, то выделенный текст будет цитироваться в этом заголовке.

4.5.2 insert-precise-note (M-i)

• Точные заметки всегда создают новую заметку, даже если вы выбираете существующий предыдущий заголовок.
• Точные заметки связаны с определенной точкой на странице, заданной вертикальными и горизонтальными координатами.
• Свойство COLUMN_EDGES, задаваемое параметром org-noter-pdf-set-columns, управляет порядком точных заметок на странице.
• Если заголовок не указан, то используется заголовок по умолчанию Notes for page <P> V: <v>% H: <h>%, где
  • <P> — метка страницы, если она существует, или номер страницы,
  • <v> — вертикальное расстояние от вершины,
  • <h> — горизонтальное положение слева.
• Поведение с выделенным текстом (заголовок по умолчанию, цитирование в теле) такое же, как и для insert-note.