Это мой первый раз, когда я использую Jekyll и Pygments. Но я не знаю, как вставить красочный фрагмент кода.
Я успешно установил Pygments, следуя официальным шагам, с уценкой следующим образом:
{% highlight ruby %}
def foo
puts 'foo'
end
{% endhighlight %}
Я вижу исходный код html, включая классы, однако для этого фрагмента нет цвета.
Нужно ли мне генерировать некоторые css файлы из Pyigs и включать их? И как?
Вам нужно включить syntax.css
Вы можете взять образец из моего репо https://github.com/madhur/madhur.github.com/blob/master/files/css/syntax.css
а затем настройте его в соответствии с вашей темой. Шахта настроена для темного фона.
Да, вам нужно либо установить, либо создать классы CSS, чтобы сделать работу с подсветкой кода. Пигменты видны. После установки Pygments это можно сделать, запустив в командной строке следующее:
pygmentize -S default -f html > pygments.css
Это создаст файл pygments.css со значением по умолчанию в вашем текущем каталоге; pygments -L style отобразит все доступные стили.
Вы можете либо переместить это в свое дерево HTML и вызвать его с помощью соответствующего:
<link rel="stylesheet" type="text/css" href="/path/to/pygments.css">
Или скопируйте содержимое pygments.css и поместите его в существующую таблицу стилей. Это поможет вам начать. Вы можете отредактировать CSS оттуда, чтобы соответствующим образом настроить.
Две заметки:
Возможно, вы уже это сделали, но для людей, которые не знакомы с Jekyll и Pygments, вам, вероятно, также придется добавить pygments: true в ваш файл _config.yml, чтобы заставить Pyigs работать. (Или, запустите jekyll с jekyll --pygments, который имеет тот же эффект.)
Оригинальная документация по установке Jekyll не совсем поняла, как заставить Pyigs работать, когда задавался этот вопрос. Я добавил раздел "Использование пигментов" с тех пор, чтобы, надеюсь, также помог очистить его.