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

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

我已经能够安装大多数其他 jekyll 主题,但特别是这个主题我无法渲染。它总是以 markdown 的形式显示,并且从不渲染主题。我在其他主题上也遇到过这个问题,通常涉及修复配置中的 url 和 baseurl 或其他一些主题设置。

有问题的主题: https://pmarsceill.github.io/just-the-docs/

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

我尝试克隆 github 存储库: https://github.com/pmarsceill/just-the-docs

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

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

我期望一个渲染的主题,我得到一个带有一堆文本的白色背景页面。我尝试使用 jekyll 服务在本地复制他们的确切存储库,或者在我自己的存储库的 github 页面上复制,但没有成功。

为什么这个主题不起作用,而其他主题却不起作用?

github jekyll github-pages jekyll-theme
2个回答
11
投票

我遇到了类似的问题,并且仓库中提出了一个问题,看起来就像您所描述的那样: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 jekyllserve --config _config_local.yml。


0
投票

我在本地测试 just-the-docs 时遇到了类似的问题,发现我必须使用

--baseurl
参数将绝对路径传递到“_site”目录:

bundle exec jekyll build --baseurl "C:/path/to/my/_site"

这会导致“assets”文件夹(例如,包含样式表)的路径正确呈现。

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