Как написать пост с формулами: markdown + LaTeX
Привет! На Хабре периодически появляются статьи, где авторы хотят вставить математические формулы: ,
или даже
У некоторых это получается, у некоторых — с трудом. parpalak сделал web-сервис для вставки svg формул, и это очень круто. Я хочу дополнить его небольшим скриптом, с которым вставка многих формул сведется к одной команде.
Метод состоит в следующем. Вы пишете свой пост в markdown-редакторе с поддержкой . Можете попробовать stackedit.io. Когда пост готов, копируем разметку в буфер обмена; запускаем команду
> poster clipboard
Команда меняет в буфере текущий исходник на хабрачитаемый; вставляем в Хабрахабр; делаем предпросмотр и, если нравится, публикуем.
Есть альтернативные пути, но этот кажется наиболее оптимальным. Может быть вы его оптимизируете у себя до пары шорткатов.
Скрипт
Цель скрипта — упростить набор формул. Скрипт собирает все доллары, разбросанные по тексту и выделяет по ним формулы. Формулы преобразуются в картинки через сервисы codecogs или tex.s2cms.
Кроме того, скрипт преобразует стандартный markdown к html + немного выправляет переводы строк.
По своему опыту я знаю, что сервисы с картинками могут сильно тупить, а то и умирать от хабраэффекта, помноженного на число формул в статье. Я сделал автоматический загрузчик картинок, который грузит все за исключением составляют svg с tex.s2cms.
Подготовка
- Ставим Python 2.7 если нет.
- Ставим curl если нет. Если ставите под Windows, не забудьте добавить путь к переменной PATH.
- Качаем скрипт с GitHub-а.
- Запускаем скрипт init.py.
Почти готово. Под линуксом или маком, вы можете вызвать init.py через sudo с флагом -l. Скрипт добавит софт-линк /usr/bin/poster на скрипт poster.py.
В файле default.json вы можете поменять источник формул: texsvg, texpng для tex.s2cms или codecogs, а также кодировку.
Как можно использовать
> poster clipboard
Преобразует содержимое буфера к хабрачитаемому виду и записывает обратно в буфер.
> poster
Преобразует содержимое файла filename.md и записывает результат в filename.txt
> poster -c
Тоже самое, но результат при этом копируется в буфер. Есть возможность указать, куда записывать результат через флаг -o.
Нюансы
- При загрузке картинок, скрипт запрашивает habrasid и сохраняет его в default.json. Один раз вы должны решить, насколько для вас важно, что habrasid будет находиться в открытом виде. Если согласны, то его надо будет периодически обновлять. Как добывать, смотрите в этом посте.
- Подгрузка картинок требует времени. Поэтому скрипт кэширует ссылки. Если указан путь к файлу, в той же папке появится папка links с картинками по ссылка и файл links.json c информацией о загруженных картинках. Если вы преобразуете через буфер, файлы будут скачиваться в папку, где находится скрипт.
- Чтобы сделать кат, наберите
Плюшка в конце
Пользователи Windows могут воспользоваться программкой AutoHotKey. Например, ahk-скрипт
^j::
Send, ^a
Send, ^c
Run, clipboard
Return
позволит по нажатию сочетания Ctrl+J одновременно выделить текущий текст, скопировать в буфер обмена и преобразовать.
Надеюсь, что я смогу облегчить своим небольшим вкладом оформление математических статей здесь и на других ресурсах, не поддерживающих .
Удачи!
