menu

Jekyll

Jekyll - это генератор статических веб-сайтов, который использует файлы формата Markdown в качестве основы.

Обзор

Вы знаете Ruby? Итак, это был язык программирования, выбранный для разработки Jekyll.

Программа бесплатная и с открытым исходным кодом.

Среди тысяч сайтов, которые используют Jekyll для преобразования файлов Markdown в HTML, стоит упомянуть один из них, GitHub Pages.

GitHub Pages использует Jekyll в качестве основного инструмента для преобразования файлов Markdown в HTML на своей бесплатной службе хостинга веб-сайтов.

Приложение использует процессор Markdown kramdown.

Jekyll загружает kramdown с настройками по умолчанию, но вы можете изменить их, как показано в примере ниже.

kramdown:
syntax_highlighter: rouge
input: GFM
auto_ids: true
toc_levels: 1..3

Файл конфигурации называется _config.yml, вы можете щелкнуть здесь, чтобы узнать больше о настройках Jekyll.

Официальный веб-сайт: https://jekyllrb.com/

Поддержка Markdown на Jekyll

Таблица 1.1 показывает элементы Markdown, совместимые с Jekyll.

Элемент Поддерживать Информация
Титулы Да
Абзацы Да
Разрывы строк Да
Смелый Да
Курсив Да
Blockquote Да
Упорядоченные списки Да
Неупорядоченные списки Да
Код Да
Горизонтальные линии Да
Links Да
Изображений Да
Столы Да
Огороженные блоки кода Да Вставьте параметр syntax_highlighter: rouge в раздел kramdown файла _config.yml, чтобы включить выделение языка внутри блока.
Сноски Да
Идентификатор заголовка Да
Списки определений Да
Зачеркнутый Да Чтобы вычеркнуть слово в Jekyll, используйте плитки ~~ word ~~ или просто фрагмент ~ word ~ вокруг содержимого. Оба синтаксиса работают.
Списки задач Да
Emoji (скопировать и вставить) Да
Emoji (коды доступа) Нет По умолчанию Jekyll не поддерживает поддержку, но вы можете добавить plugin jemoji.
автоматический Link от URL Да
Отключить автоматический link URL Да
HTML Да

Поддержка дополнительных элементов синтаксиса

В Таблица 1.2 вы можете увидеть больше неясных элементов, поддерживаемых Jekyll.

Элемент Markdown Выход
Сокращение *[HTML]: Hyper Text Markup Language
Спецификация HTML поддерживается W3C.
Спецификация HTML поддерживается W3C.

Смотри тоже

Параметры конфигурации для Markdown на Jekyll

Документация kramdown