0

我正在尝试为开源项目贡献一些文档，因此我正在尝试在本地预览文档页面，这些页面是 github 网站的一部分。但是，我的代码块的格式不正确。我创建了一个最小的例子：

_config.yml

markdown: kramdown
highlighter: rouge
kramdown:
  input: GFM
  hard_wrap: false
  parse_block_html: true
name: test

默认.html

<!doctype html>
<html>
<body>{{ content }}</body>
</html>

认证.md

---
layout: default
---
## Authentication

Some description.

```scala
case class User(id: Long, name: String)
// defined class User
```

结果输出jekyll build是

<!doctype html>
<html>
<body><h2 id="authentication">Authentication</h2>

<p>Some description.</p>

<div class="language-scala highlighter-rouge"><span class="k">case</span> <span class="k">class</span> <span class="nc">User</span><span class="o">(</span><span class="n">id</span><span class="k">:</span> <span class="kt">Long</span><span class="o">,</span> <span class="n">name</span><span class="k">:</span> <span class="kt">String</span><span class="o">)</span>
<span class="c1">// defined class User
</span></div>
</body>
</html>

这会导致一长行未格式化的代码。在 github 站点（您可以在此处查看http://http4s.org/docs/0.15/auth.html）上，html 具有<pre>和<code>元素。像这样：

<div class="language-scala highlighter-rouge"><pre class="highlight"><code><span class="k">...

由于其他人在本地预览站点时没有这个问题，而我在预览http://typelevel.org/cats/时也遇到了同样的问题，我认为这是某种本地配置问题。但是，我无法弄清楚任何事情。这是我第一次使用 jekyll/kramdown，所以我没有经验可以利用。

我安装了github-pagesgem，它给了我jekyll 3.3.1和kramdown 1.11.1.

4

1 回答 1

2

如果它可以帮助其他人：

我在翻阅 Github 文档后发现了这一点。它实际上是一个版本和安装的 gems 问题。存储库中有一个 Gemfile 和 Gemfile.lock 文件。一方面，它们没有被构建过程复制到运行站点的目录中。而且，我需要安装bundlergem 来安装依赖项bundle install。然后使用bundle exec jekyll serve. 这与回购网站上的说明不同。

于 2016-11-30T04:52:12.410 回答