可折叠部分的内容(<details> <summary> ...)在GitHub存储库中提供降价,但在GitHub Pages中不提供

时间:2018-10-23 08:40:46

标签: markdown jekyll github-pages kramdown

在GitHub存储库README上,可折叠部分内的markdown根据需要呈现。

enter image description here

但是在GitHub Pages上,标记文字不是按文字显示的。

enter image description here

_config.yml本质上是空的。

在问题中提到Markdown inside and not being processed,建议的解决方法是:

markdown: kramdown
kramdown:
  parse_block_html: true

这确实可以修复内容的呈现,我可以切换到kramdown,但是可以中断<details><summary>的呈现以及旋转。 (所以我回滚了。)

相关的HTML和markdown是:

<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 :(得分:2)

正如Waylan的评论所指出的那样,GitHub存储库中的markdown(如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: CommonMarkGhPages
     

此处理器当前正在测试中,可在GitHub Pages中使用。

     

指定扩展名和选项,用于将Markdown转换为   HTML,为Markdown转换器提供选项:

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

要使其正常工作(截至2018年10月),我要做的只是add markdown: CommonMarkGhPages to the _config.yml。 (存储库中没有Gemfile。)