Org-mode. Предпросмотр TeX

Предпросмотр TeX в org-mode.

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

• Входит в состав пакета org.

2 Использование

• Визуализация запускается командой C-c C-x C-l (org-preview-latex-fragment).
• Визуализация поддерева: C-u C-c C-x C-l.
• Визуализация всего буфера: C-u C-u C-c C-x C-l.
• Команда обрабатывает код Latex и создаёт изображение png или svg, которое накладывается на код LaTeX.
• Просмотр других элементов LaTeX (например, листинг для кода) также работает.

3 Реализация

• Список процедур обработки находятся переменной org-preview-latex-process-alist.
• Используются методы: dvipng, imagemagick, dvisvgm.
• Фрагмент кода встраивается в полный файл LaTeX, который затем обрабатывается программой LaTeX для создания файла dvi или pdf.
• Затем результирующий файл преобразуется в формат png или svg.

4 Настройка

• Необходимо выбрать метод конвертации (dvipng, imagemagick, dvisvgm):

  (setq org-latex-create-formula-image-program 'dvipng)
  

• Набор используемых пакетов LaTeX заносятся в переменные:
  • org-latex-default-packages-alist : список пакетов по умолчанию, лучше не изменять;
  • org-latex-packages-alist : пустая по умолчанию переменная, заносите информацию сюда.
• Созданные изображения лучше поместить в отдельный кэш:

  (setq org-preview-latex-image-directory (concat home-cache-path "org-latex/"))
  

5 Опции в org-файле

• Вы можете включить предварительный просмотр всех фрагментов LaTeX в файле с помощью опции:

  #+STARTUP: latexpreview
  

• Чтобы отключить предпросмотр:

  #+STARTUP: nolatexpreview