Блог

У меня есть блог Jekyll на GitHub, и есть проблемы, вызванные старой версией подсветки синтаксиса Rouge. Проблему можно увидеть, например, в этом посте здесь ¹. Обратите внимание на красные знаки равенства.

Если я обслуживаю свой сайт локально, я получаю последнюю версию Rouge и не вижу этих красных знаков равенства (на самом деле, я написал патч для исправления этой ошибки, и мой патч был выпущен в Rouge 3.3.0). Так вот откуда я знаю, что зависимости устарели на стороне GitHub.

Я нашел множество сообщений о том, как обновлять зависимости локально, но как я могу обновить их в GitHub?

¹ Благодаря ответу, который впоследствии был удален, я смог исправить красную подсветку с помощью подсветки синтаксиса JS.

С некоторой помощью службы поддержки GitHub у меня наконец есть ответ на этот вопрос.

Процедура в основном:

Создайте Gemfile:

 source 'https://rubygems.org'
gem 'github-pages', group: :jekyll_plugins
  

Установите пакет:

 ▶ bundle install
  

Создайте и обслуживайте сайт локально:

 ▶ bundle exec jekyll serve
  

Затем сайт должен быть доступен для предварительного просмотра по адресу: http://127.0.0.1:4000 /

Вот где это становится сложнее.

После того, как вы создали свой сайт, вам нужно будет перенести содержимое _site папки на GitHub, но в корень главной ветки, заменив существующий исходный код.

Таким образом, рекомендуется сначала создать новую ветку, например, разработать, где может находиться исходный код блога. Затем эту ветку разработки можно использовать для редактирования сайта, а затем созданное содержимое можно перенести в основную ветку, когда оно будет готово.