在 GitHub 存储库的自述文件中,可折叠部分内的降价按需要呈现。
但在 GitHub Pages 上,markdown 并未呈现,只是字面意思。
_config.yml
本质上是空的。
问题中提到Markdown 内部且未处理,建议的修复方法是:
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.
正如 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
并修改您的
以使用 CommonMarkGhPages 作为您的 Markdown 转换器:_config.yml
markdown: CommonMarkGhPages
该处理器目前正在测试在 GitHub Pages 中使用。
指定用于将 Markdown 转换为 HTML,为 Markdown 转换器提供选项:
commonmark: options: ["UNSAFE", "SMART", "FOOTNOTES"] extensions: ["strikethrough", "autolink", "table", "tagfilter"]
为了使其正常工作(截至 2018 年 10 月),我所要做的就是 将
markdown: CommonMarkGhPages
添加到 _config.yml。 (仓库中没有Gemfile
。)