问题标签 [kramdown]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
3 回答
10271 浏览

github - Github Markdown - 使用 XML 和 HTML 渲染代码块 - kramdown vs redcarpet

我在我的 git 站点中遇到了一些不寻常的错误。

注意:我正在使用 Kramdown + highlight.js 来突出显示代码。

下面是我正在学习的一课。在本课中,我需要 EML在代码块中呈现(类似于 XML)。我正在使用 kramdown。我还想在代码块中呈现 HTML - 例如,我需要一个代码块来解释如何添加包含文件:

恰当的例子 - 下面的课程:http: //neoninc.github.io/NEON-DataSkills-Lesson-Development/R/EML/

git url https://github.com/NEONInc/NEON-DataSkills-Lesson-Development/blob/gh-pages/_posts/EML/2015-12-12-Intro-to-EML.md

奇怪的是,当 JEKYLL 构建页面时,它正在运行包含 XML 和 HTML 的代码块。

我努力了:

这会在页面上呈现结束</code>标签,这很奇怪。如果我不使用代码标签,那么 jekyll 会尝试解析 XML。

这仍然尝试解析和作为 HTML 标记。

我试图切换到红地毯。但是,redcarpet 打破了我的分线框,我将其编码如下:{: .notice }用于将样式应用于 div。

最后——我的工作流程是从 RMD 到 md,所以在我构建时向每个代码块(pre 和 code)添加自定义代码是有问题的。

简而言之 - 我很难找到一个解决方案

  1. 允许带有 HTML / XML 的代码块
  2. 允许我将类/ id 应用到我的突破 div。{: 。注意 }

非常感谢您对此问题的任何反馈/指导。利亚

0 投票
2 回答
717 浏览

css - 在 kramdown 中使用适当的缩进将代码块嵌入到列表项中

我需要在kramdown的列表项中嵌入一个代码块。代码块由Pygments突出显示。 结果如下图所示。我希望代码块向右移动以证明它是列表元素的一部分。kramdown 文档使用围栏块样式,它不适用于我的Jekyll网站,所以我使用另一个:

如何以这种方式自动控制缩进?
感谢您的任何建议。

这个

0 投票
1 回答
373 浏览

ruby - Jekyll 中的围栏代码块

我刚刚将本地 Jekyll 安装升级到 Jekyll 3.0.2。

我期待在发布源代码时使用围栏(反引号)代码块。

然而这不起作用,我仍然必须使用 Liquid 标签来指定代码块

我在 _config.yml 中的构建设置:

已安装的 Ruby gem 列表

0 投票
2 回答
1963 浏览

markdown - Jekyll 在添加 HTML 时不渲染 Markdown

我在 Markdown 文件中有这个降价代码。它具有内联 HTML。

但是当我用 a 包裹前面的东西时<div>,降价不会呈现。即使我<div>{% raw %}.

为什么?有什么解决方法吗?我正在使用 Jekyll 3。

0 投票
2 回答
810 浏览

github - # 在 GitHub 最近更新页面和 Jekyll 后不呈现 HTML 标题标签

本周,GitHub 宣布其产品Pages将支持 kramdown

根据他们的建议 - 我在项目_config删除markdown: redcarpet并更新了highlighterrouge

现在唯一的问题是无法在主网站#上的任何页面上呈现为标题

  • 解决方法是什么?

附带问题:还有什么需要注意的吗?

0 投票
1 回答
647 浏览

jekyll - 在 GFM 模式下无法识别 Kramdown 反引号

我试图让一些非常简单的页面使用 Jekyll 正确呈现,使用 kramdown 处理 markdown 和 rouge 以进行语法突出显示。然而,即使在 GFM 模式下,Kramdown 似乎也无法解释三次反引号。

我相信我已经按照信中的说明进行操作,当推送到 github 页面时一切正常,但我的本地设置只是忽略了反引号。

如果有任何帮助,这已在带有 Jekyll 3.1.1 的 OS X 上观察到。用于调用 jekyll 的命令行是jekyll serve --config "_config.yml".

我已将问题缩小到以下最小测试:

_config.yml

索引.md

布局/default.html

结果 index.html

0 投票
1 回答
968 浏览

jekyll - Jekyll 中带有 kramdown 的围栏代码块?

我有一个使用 Jekyll 构建的 GitHub Pages 站点,我想在该站点上添加代码高亮。

当我尝试使用受保护的代码块时,它们不会在本地呈现,但它们在实时 GitHub 站点上运行良好。

我的 Markdown 文件是这样的:

我的配置是这样的:

我最初没有安装 kramdown 或 rouge,但我现在已经安装了两者并确保一切都是最新的(Jekyll 是 3.1.1)。代码必须没问题,因为它可以在实时站点上运行。但我一定在当地遗漏了一些东西。

编辑:这里的答案对我也不起作用。


也可能相关,是否应该有用于自动生成的突出显示的 CSS,或者我是否需要从某个地方下载“主题”?我只知道它在 GitHub Pages 上工作,因为它在 HTML 中有各种类,例如<span class="k">class</span>,但没有应用于它们的 CSS。

0 投票
1 回答
513 浏览

jekyll - 乳胶方程不会在 Jekyll(kramdown 引擎)中呈现

我正在使用 Jekyll + kramdown 来渲染我的博客。但我发现这个特殊的等式不可渲染,它要么出现在原始乳胶代码中,要么只是空白,这取决于我在美元符号周围放置了多少空格。所有其他方程式都已渲染得很好。

这是我插入方程式的方法:

我需要配置 kramdown 的一些设置吗?我已经在 MathJax 网站演示中尝试过这段代码,并且渲染得很好。

谢谢!

0 投票
3 回答
773 浏览

markdown - 使用 Jekyll 3,我可以在实际 Markdown 解析之前转换帖子的 Markdown 吗?

我想使用Jekyll Responsive Image 插件srcset为我的帖子图像生成带有/sizes属性的适当响应图像。

但我也希望能够在一个提供实时预览的软件中编辑我的帖子,比如MacDown,它只理解图像的标准 Markdown 语法。

这就是为什么我想知道是否有一种方法——某种插件——告诉 Jekyll 转换图像的标准 Markdown 语法,我会将其放入我的 Markdown 文件中……</p>

![alt text](path/to/image.jpg)

…进入Jekyll Responsive Image 插件特有的语法:

{% responsive_image path: path/to/image.jpg alt: "alt text" %}

然后,Jekyll 可以继续使用 Kramdown 生成 HTML……</p>

我还在插件的 Github 中创建了一个问题,但更一般的答案也会很好,并且可能对其他需求有用。

0 投票
1 回答
1592 浏览

markdown - 如何在 jekyll 中使用 kramdown 使用编号的 LaTeX 方程

是否可以kramdown在 jekyll 的引擎中使用方程式编号?以前的引擎似乎maruku支持方程编号。我想使用 MathJax 支持的方程编号和交叉引用。

我努力了

我得到:

a+b=c