可折叠部分的内容(<details><summary>...)在 GitHub 存储库中呈现 markdown,但不在 GitHub Pages 上呈现

问题描述 投票:0回答:1

在 GitHub 存储库的自述文件中,可折叠部分内的降价按需要呈现。

enter image description here

但在 GitHub Pages 上,markdown 并未呈现,只是字面意思。

enter image description here

_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.

markdown jekyll github-pages kramdown
1个回答
5
投票

正如 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 转换器:

markdown: CommonMarkGhPages

该处理器目前正在测试在 GitHub Pages 中使用。

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

commonmark:
  options: ["UNSAFE", "SMART", "FOOTNOTES"]
  extensions: ["strikethrough", "autolink", "table", "tagfilter"]

为了使其正常工作(截至 2018 年 10 月),我所要做的就是

markdown: CommonMarkGhPages
添加到 _config.yml。 (仓库中没有
Gemfile
。)

© www.soinside.com 2019 - 2024. All rights reserved.