Pull to refresh

Как написать пост с формулами: markdown + LaTeX

Reading time 3 min
Views 24K
Привет! На Хабре периодически появляются статьи, где авторы хотят вставить математические формулы: inline_formula, inline_formula или даже


У некоторых это получается, у некоторых — с трудом. parpalak сделал web-сервис для вставки svg формул, и это очень круто. Я хочу дополнить его небольшим скриптом, с которым вставка многих формул сведется к одной команде.



Метод состоит в следующем. Вы пишете свой пост в markdown-редакторе с поддержкой inline_formula. Можете попробовать stackedit.io. Когда пост готов, копируем разметку в буфер обмена; запускаем команду

> poster clipboard

Команда меняет в буфере текущий исходник на хабрачитаемый; вставляем в Хабрахабр; делаем предпросмотр и, если нравится, публикуем.

Есть альтернативные пути, но этот кажется наиболее оптимальным. Может быть вы его оптимизируете у себя до пары шорткатов.

Скрипт Poster


Цель скрипта — упростить набор формул. Скрипт собирает все доллары, разбросанные по тексту и выделяет по ним формулы. Формулы преобразуются в картинки через сервисы codecogs или tex.s2cms.

Кроме того, скрипт преобразует стандартный markdown к html + немного выправляет переводы строк.

По своему опыту я знаю, что сервисы с картинками могут сильно тупить, а то и умирать от хабраэффекта, помноженного на число формул в статье. Я сделал автоматический загрузчик картинок, который грузит все за исключением составляют svg с tex.s2cms.

Подготовка


  1. Ставим Python 2.7 если нет.
  2. Ставим curl если нет. Если ставите под Windows, не забудьте добавить путь к переменной PATH.
  3. Качаем скрипт с GitHub-а.
  4. Запускаем скрипт init.py.

Почти готово. Под линуксом или маком, вы можете вызвать init.py через sudo с флагом -l. Скрипт добавит софт-линк /usr/bin/poster на скрипт poster.py.

В файле default.json вы можете поменять источник формул: texsvg, texpng для tex.s2cms или codecogs, а также кодировку.

Как можно использовать


> poster clipboard

Преобразует содержимое буфера к хабрачитаемому виду и записывает обратно в буфер.

> poster <filename.md>

Преобразует содержимое файла filename.md и записывает результат в filename.txt

> poster -c <filename.md>

Тоже самое, но результат при этом копируется в буфер. Есть возможность указать, куда записывать результат через флаг -o.

Нюансы


  1. При загрузке картинок, скрипт запрашивает habrasid и сохраняет его в default.json. Один раз вы должны решить, насколько для вас важно, что habrasid будет находиться в открытом виде. Если согласны, то его надо будет периодически обновлять. Как добывать, смотрите в этом посте.
  2. Подгрузка картинок требует времени. Поэтому скрипт кэширует ссылки. Если указан путь к файлу, в той же папке появится папка links с картинками по ссылкам и файл links.json c информацией о загруженных картинках. Если вы преобразуете через буфер, файлы будут скачиваться в папку, где находится скрипт.

Особенности синтаксиса


  • Чтобы сделать кат, наберите

    <!-- cut [Cut title] -->
    

  • Чтобы сделать спойлер, введите сначала

    <!-- spoiler [spoiler title] -->
    

    а затем

    <!-- /spoiler -->
    

  • Используйте ключевые слова left, center, right, чтобы обозначить выравнивание картинки

    ![left][beautiful.png]
    


Плюшка в конце


Пользователи Windows могут воспользоваться программкой AutoHotKey. Например, ahk-скрипт

^j::
  Send, ^a
  Send, ^c
  Run, <path to poster.py> clipboard
Return

позволит по нажатию сочетания Ctrl+J одновременно выделить текущий текст, скопировать в буфер обмена и преобразовать.

Надеюсь, что я смогу облегчить своим небольшим вкладом оформление математических статей здесь и на других ресурсах, не поддерживающих LaTeX.

Удачи!
Tags:
Hubs:
+46
Comments 20
Comments Comments 20

Articles