Страницы Github не могут правильно отображать уценку

Question

Я использую github pages + jekyll для создания своего блога.

Он работал должным образом, прежде чем подтолкнул мой последний коммит. Этот коммит добавляет файл cname и просто редактирует некоторые слова без каких-либо изменений в архитектуре моего сайта.

-    <h3 class="description">aaaaaaaaaa</h3>
+    <h3 class="description">bbbbbbbbbb</h3>

После этого уценка не отображается должным образом.

Когда я пишу #head1. Заголовок заголовка head1 не появляется, просто появляется заголовок #head1.

Однако, если я использую сборку jekyll serve в localhost:4000, она отображается правильно.

Это мой _config.yml:

уценка: kramdown
markdown_ext: уценка, мкд, мкдн, мкр
textile_ext: текстиль
маркер: фрагменты

Есть идеи, что стало причиной этой ошибки?

Answer 1

ОБНОВЛЕНО!

Скорее всего, это связано с обновлением Jekyll 3 на страницах GitHub.

С 1 мая 2016 года GitHub не будет поддерживать rdiscount ни redcarpet больше. Также с 1 февраля GitHub Pages поддерживает только rouge:

Начиная с 1 мая 2016 года, страницы GitHub будут поддерживать только kramdown, движок Markdown по умолчанию для Jekyll.

GitHub Pages теперь поддерживает только Rouge.

Вы можете проверить это здесь.

Чтобы справиться с этим, сделайте следующее:

Сначала попробуйте, как описано в этом ответе. Вместо #Heading ты напишешь # Heading,

Во-вторых, отрегулируйте _config.yml: менять highlighter а также markdown за

highlighter: rouge
markdown: kramdown
kramdown:
  input: GFM

В-третьих, чтобы создать свой сайт локально, используйте Bundler, метод, рекомендованный GitHub:

1. Установите Bundler:

   gem install bundler
   

2. Тогда беги bundle update - это обновит все ваши драгоценные камни, включая github-страницы, если вы уже установили этот драгоценный камень локально.

3. Затем создайте Gemfile (оставьте это без расширения файла) со следующим содержанием:

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

Сохраните его в корне вашего проекта.

4. Затем беги bundle install на вашем проекте. Это создаст файл с именем Gemfile.lock и установит все необходимые гемы и их зависимости.

5. Наконец, беги bundle exec jekyll serve --watch и вы сможете просматривать свой веб-сайт точно так же, как онлайн (при размещении на GitHub).

Вы должны быть в порядке к тому времени!

---

PS. Если вашему проекту нужно больше драгоценных камней, как jekyll-paginate или же jekyll-mentionsвам нужно будет добавить их в Gemfile, например:

source 'https://rubygems.org' 
gem 'github-pages'
gem 'jekyll-paginate'

Кроме того, добавьте их в свой проект _config.yml:

gems:
  - jekyll-paginate
  - jekyll-mentions

Здесь вы увидите список версий гемов, которые в настоящее время поддерживаются GitHub Pages. Здесь вы читаете об обновлении Jekyll 2 до 3.

Надеюсь, что помог!

Answer 2

Небольшое наблюдение за моим собственным блогом на Github, посвященном Jekyll,

Пробел между #, представляющим размер заголовка, и текстом заголовка важен, иначе уценка не будет отображаться должным образом. Поэтому в вашем примере мой заголовок уценки будет отображаться как

# Zookeeper Atomic Broadcast for heading 1

## Zookeeper Atomic Broadcast for heading 2

### Zookeeper Atomic Broadcast for heading 3

#### Zookeeper Atomic Broadcast for heading 4

##### Zookeeper Atomic Broadcast for heading 5

Answer 3

GitHub поддерживает уценку, а также Jekyll.
Прежде всего переименуйте ваш файл с помощью .md расширение

Если у вас есть .nojekyll в вашей папке он отключит njekyll.

Убедитесь, что у вас нет этой папки.

---

Прочитайте документацию && GitHub, соответствующую документации о том, как подготовить и развернуть

---

Бегущий Джекилл

Используйте команду git checkout, чтобы переключиться на ветку по умолчанию, которую сервер сборки GitHub Pages использует для создания вашего сайта. Ветвь по умолчанию, на которую вы переключаетесь, зависит от типа создаваемого сайта GitHub Pages.

Для сайтов страниц проекта переключитесь на gh-pages. Для сайтов пользователей или страниц страниц организации переключитесь на мастер. Для получения дополнительной информации см. "Страницы пользователя, организации и проекта".

Используйте команду bundle exec jekyll serve в корне вашего репозитория, чтобы запустить сервер сборки GitHub Pages с Bundler.

bundle exec jekyll serve Перейдите по http://localhost:4000/, чтобы увидеть свой локальный сайт.