我已经能够安装大多数其他 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 页面上复制,但没有成功。
为什么这个主题不起作用,而其他主题却不起作用?
我遇到了类似的问题,并且仓库中提出了一个问题,看起来就像您所描述的那样: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。
我在本地测试 just-the-docs 时遇到了类似的问题,发现我必须使用
--baseurl
参数将绝对路径传递到“_site”目录:
bundle exec jekyll build --baseurl "C:/path/to/my/_site"
这会导致“assets”文件夹(例如,包含样式表)的路径正确呈现。