Содержимое складных разделов (<details><summary> ...) отображает уценку в репозитории GitHub, но не на страницах GitHub. - PullRequest
Новая
       119

Содержимое складных разделов (<details><summary> ...) отображает уценку в репозитории GitHub, но не на страницах GitHub.

0 голосов
/ 23 октября 2018

В репозитории README на GitHub уценка внутри разборной секции отображается по желанию.

enter image description here

Но на страницах GitHub уценка не отображается, буквально.

enter image description here

_config.yml по существу пуст.

В номере упоминается Уценка внутри и не обрабатывается , и предлагаемое исправление: 

markdown: kramdown
kramdown:
  parse_block_html: true

Это действительно исправляет рендеринг контента, и я в порядке с переходом на kramdown, но он ломаетсярендеринг <details> и <summary> и вращение вниз.(Поэтому я откатился назад.)

Соответствующий HTML и уценка: 

<details><summary><strong>About transliteration</strong></summary>

About half of the billions of internet users speak languages written in non-Latin alphabets, like Russian, Arabic, Hebrew, Chinese, Greek, Armenian and Hindi.  Very often, they haphazardly use the Latin alphabet to write those languages.

`Привет`: `Privet`, `Privyet`, `Priwjet`, ...  
`كيف حالك`: `kayf halk`, `keyf 7alek`, ...  
`Բարև Ձեզ`: `Barev Dzez`, `Barew Dzez`, ...  

... ... ...

</details>

Есть ли способ форсировать рендеринг без kramdown (и без использования необработанного HTML)?Или есть способ сделать разборную секцию с помощью kramdown?

Полный репо, конечно, на github.com / deepchar / deepchar.github.io .

1 Ответ

0 голосов
/ 24 октября 2018

Как отмечается в комментариях Waylan, уценка в репозиториях GitHub, например README.md, отображается с помощью Commonmark.

Репозиторий github.com / github / jekyll-commonmark-ghpages # installation упоминает о поддержке GitHub Pages и дает некоторые инструкции.

Установка

Добавьте следующее к вашему Gemfile: 

group :jekyll_plugins do
  gem 'jekyll-commonmark-ghpages'
end

и измените ваш _config.yml, чтобы использовать CommonMarkGhPages в качестве конвертера Markdown: 

markdown: CommonMarkGhPages

Этот процессор в настоящее время тестируется для использования на страницах GitHub.

Чтобы указатьрасширения и опции для использования при конвертации Markdown в HTML, опции конвертера Markdown: 

commonmark:
  options: ["SMART", "FOOTNOTES"]
  extensions: ["strikethrough", "autolink", "tables"]

Чтобы все заработало (по состоянию на октябрь 2018 года), все, что мне нужно было сделать, это добавьте markdown: CommonMarkGhPages к _config.yml .(В репо нет Gemfile.)

...