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

  • Tutorial
Привет! На Хабре периодически появляются статьи, где авторы хотят вставить математические формулы: 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.

Удачи!
AdBlock has stolen the banner, but banners are not teeth — they will be back

More
Ads

Comments 20

    +9
    Это чит.
      –1
        +3
        Интересно, но там сервис работает на MathJax. Непонятно, как это прикрутить к постам.
        0
        Обещаю попробовать и написать отзыв
          +1
          Ей! Напишите, если возникнут проблемы. Я пробовал на разных машинках и ОС, но все равно что-нибудь может проскочить.
            0
            Первое впечатление от работы с Вашим скриптом и предложенным в статье редактором исключительно положительное. Начал готовить 15 серию про тензоры и не могу нарадоваться, насколько удобно набирать текст поста, насыщенный формулами
              0
              Единственное — не работает предложенный способ вставки ката. Но генерация ссылок на формулы и рисунки, формат заголовков — всё работает хорошо
                +1
                Очень здорово! Поправил кат, добавил выравнивание картинок. Теперь если в квадратных скобках markdown-а написать left, right или center — этот параметр выставится в параметре align.
                  0
                  Теперь если в квадратных скобках markdown-а написать left, right или center

                  Да, это очень кстати
                    0
                    Опробовал исправленную версию. Теперь замечательно всё работает. Великолепная штуковина
                      0
                      Спасибо! :)
                      0
                      Ещё мелкое замечание. Я в питоне не спец, но у меня установлены как версия 3.4.3 так и 2.7 пришли с зависимостями к каким-то пакетам. При запуске по умолчанию выбирается третий питон и сыпятся ошибки. Поэтому я костыльный скрипт

                      #!/bin/bash
                      python2.7 /home/maisvendoo/install/habratex/poster.py $1
                      


                      и сделал симлинк на него
                        0
                        Ага, поправил. Сейчас скрипт должен выбирать 2.x.
                          0
                          Проверил. Теперь и установка и работа проходит без ошибок
                0
                Да, я тоже, естественно, попробую, но вряд ли скоро. Следующий мой пост будет не о математике, а там как карта ляжет.
                  +1
                  Да, тоже пишите, если что-то пойдет не так или чего-то будет не хватать.
                0
                Как раз сейчас занимаюсь примерно тем же. Требуется перегонять html + tex в pdf.
                Делаю через перегон nodejs mathJax -> html + svg -> с помощью batik делаем html + images data uri -> pdf.
                MathJax используется потому, что он же стоит и на фронте и хочется видеть одинаковое представление и в pdf и на фронте. Скорость на большом кол-ве формул не радует :(
                  0
                  Как раз сейчас занимаюсь примерно тем же. Требуется перегонять html + tex в pdf.
                  Делаю через перегон nodejs mathJax -> html + svg -> с помощью batik делаем html + images data uri -> pdf.
                  MathJax используется потому, что он же стоит и на фронте и хочется видеть одинаковое представление и в pdf и на фронте. Скорость на большом кол-ве формул не радует :(
                    0
                    Интересно, а pandoc такое не покрывает?
                      0
                      Не знал про него. Изучу, спасибо

                  Only users with full accounts can post comments. Log in, please.