使用jekyll专门实现仅文档主题的问题

时间:2019-06-05 16:42:55

标签: github jekyll github-pages jekyll-theme

我已经能够安装大多数其他jekyll主题,但是尤其无法渲染该主题。它总是像markdown一样显示,并且从不渲染主题。我在其他主题上遇到了这个问题,通常涉及在配置或其他主题设置中修复url和baseurl。

相关主题: https://pmarsceill.github.io/just-the-docs/

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

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

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

我现在想要的主要事情是克隆“仅文档”存储库,并创建一个我可以编辑的fork,但是我什至无法得到他们的工作仓库来为我工作。我尝试更改url和baseurl,并在文件中四处寻找其他可能与我不同的东西。我还有别的机会吗?

我希望呈现一个主题,我得到一个带有一堆文本的白色背景页面。我尝试使用jekyll服务或在我自己的仓库中的github页面上复制他们没有仓库成功的确切仓库。

为什么这个主题在其他主题不起作用时却不起作用?

1 个答案:

答案 0 :(得分:0)

我遇到了类似的问题,回购中出现了一个问题,好像您在描述什么: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

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