Как легко преобразовать документ Markdown в HTML в текстовом редакторе Kate [Linux]

Существует множество причин писать текст в виде простого текста, одна из которых заключается в том, что текстовые редакторы (как правило) работают легче по сравнению с другими приложениями для работы с документами, такими как текстовые процессоры, и в основном не отвлекают внимание. Но многие текстовые редакторы скрывают некоторые другие хитрости, которые могут сделать их полезными по-разному. В этой статье мы будем использовать функцию «Сборка» текстового редактора Kate в KDE для автоматического создания выходных данных с помощью pandoc, как мы это делали недавно.

Активация плагина Kate Build

Чтобы сделать этот вывод пандока автоматическим, нам нужно активировать плагин «Сборка».

1. Зайдите в меню «Настройки», затем выберите «Настроить Кейт».
2. Из пунктов слева выберите «Плагины». Откроется диспетчер плагинов.
3. Отметьте пункт «Создать плагин».
4. Нажмите «ОК».

Если у вас это сработало правильно, вы должны увидеть элемент внизу экрана с надписью «Вывод сборки». Здесь мы расскажем Кейт, как генерировать выходные данные из редактируемого в данный момент файла с помощью команды pandoc.

Настройка профиля сборки

Как следует из названия, эта функция обычно предназначена для разработчиков, пишущих код, и компилирует этот код за них. Но есть опция «Быстрая компиляция», которая ничего не делает, а только запускает настроенную вами команду, и именно здесь мы будем размещать нужные нам параметры pandoc. Нажмите на элемент «Build Output» в самом низу окна Kate, и вы увидите диалоговое окно, подобное показанному ниже.

На первой вкладке «Ошибки и предупреждения» будет отображаться результат вашей команды, если что-то пойдет не так, а на второй, «Вывод», ничего не будет отображаться, если все идет по плану. Нас интересует последняя вкладка «Настройки цели». Давайте создадим то, что Кейт называет «Построить цель» для pandoc. Сначала нажмите кнопку «Новый» (крайняя слева с зеленым плюсом). Это создаст профиль сборки, которому мы можем дать имя в поле над кнопкой «Создать» — назовем его «MD > HTML», чтобы обозначить, что мы хотим, чтобы это автоматически создавало HTML-версию нашего документа Markdown.

Когда вы это сделаете, Кейт заполнит некоторые настройки справа, включая «Создание» и «Очистка». Это элементы, о которых нам не нужно беспокоиться в нашей работе, поэтому мы можем удалить эти команды «make» и «make clean». Вместо этого введите следующую команду в поле «Быстрое завершение»:

pandoc -r markdown -w html -o %f.html %f

Здесь «%f» — это код, который Кейт заменит на имя файла, открытого в данный момент в окне. Теперь, когда вы завершили создание документа Markdown, выберите меню «Создать» на панели инструментов, затем «Быстрая компиляция».

Вуаля! Проверьте каталог, в котором находился ваш документ Markdown, и вы увидите файл с названием [имя исходного файла].html. Обратите внимание, что код «%f» включает в себя полное имя файла, поэтому, если ваш исходный файл назывался «myfile.md», новый файл будет называться «myfile.md.html» (поскольку исходное расширение включено).

Теперь мне нравится назначать это сочетание клавиш. Сделать это можно в диалоговом окне «Настройки -> Настройка ярлыков». Найдите элемент «Быстрая компиляция», щелкните столбец «Ярлык» для этой строки, выберите «Пользовательский», когда он откроется, и нажмите кнопку «Нет». Затем это изменится на «Ввод» — для этого будет назначена следующая комбинация клавиш, которую вы нажмете, поэтому обязательно используйте кнопку Control или Alt. Он также может предупредить вас о том, что этой комбинации уже назначена другая функция, но очевидно, что это более важно, поэтому вы можете ее переопределить. Как показано на рисунке ниже, я назначил «Быструю компиляцию» клавише Ctrl+B.

Теперь, когда я хочу просмотреть HTML-код, который сгенерирует мой Markdown, все, что мне нужно сделать, это нажать Ctrl+B.