github - 使用 jekyll 专门实施 just-the-docs 主题时遇到问题

Question

我已经能够安装大多数其他 jekyll 主题，但特别是这个主题我无法渲染。它总是显示为降价并且从不呈现主题。我在其他主题中遇到过这个问题，通常涉及在配置或其他主题设置中修复 url 和 baseurl。

我已经尝试在我自己的新 jekyll 构建中实现该主题。

我曾尝试在以下位置克隆 github 存储库： https ://github.com/pmarsceill/just-the-docs

我尝试使用远程主题克隆真正的基本版本： https ://github.com/pmarsceill/jtd-remote

我现在想要做的主要事情是克隆 just-the-docs 存储库并创建一个我可以编辑的分支，但我什至无法让他们的工作存储库为我工作。我尝试更改 url 和 baseurl 并查看文件以查找其他可能使我与他们不同的东西。还有什么我必须冒险的吗？

我期待一个渲染的主题，我得到一个带有一堆文本的白色背景页面。我尝试在本地使用 jekyll serve 或在我自己的 repo 上的 github 页面上复制他们的确切 repo，但没有成功。

为什么当其他主题不起作用时，这个主题不起作用？

score 6 · Accepted Answer

我遇到了类似的问题，并且在 repo 中提出了一个问题，看起来就像您所描述的那样：https ://github.com/pmarsceill/just-the-docs/issues/148

这为我解决了这个问题 - 来自那里的评论：

几天前我遇到了同样的错误，我的解决方案是 github 和本地机器的单独配置文件。您可以在https://github.com/taruma/hidrokit-nb/tree/master/docs上查看我的设置。

对于本地（_config_local.yml）：

# Local Setting
baseurl: ""
url: ""

# Theme
theme: "just-the-docs"
# remote_theme: pmarsceill/just-the-docs

对于 github (_config.yml)：

# Remote Setting
baseurl: "/guidelines"
# url: ""

# Theme
# theme: "just-the-docs"
remote_theme: pmarsceill/just-the-docs

对于本地机器上的实时服务器，我运行 bundle exec jekyll serve --config _config_local.yml。

1 回答 1