我最近了解到 jekyll,想要用它创建一个项目的着陆页。我希望有一个主页使用一个主题(例如ubuild),并且另外一页为文档(通过顶部导航栏访问),使用不同的主题(例如just-the-docs)。如何实现这一点?
编辑:我想要在 Github Pages 上实现这个目标。
编辑:我想要在 Github Pages 上实现这个目标。
just-the-docs
主题的所有页面,包括着陆页面。然后修改_layouts/home.html
以成为一个父布局(类似于default
布局),以呈现来自ubuild..
主题的标记。在@JoostS的答案帮助下,我解决了这个问题,但做了一些修改:
在GitHub页面上创建一个名为<org-name>.github.io
的仓库,用于存放主页的主题(例如我的是ubuild
)和所有内容。
创建另一个名为docs
的jekyll网站仓库。该网站应包含您想要用于另一个页面的主题(例如我的是just-the-docs
)和所有相关内容。
在_config.yml
中的docs
仓库中添加baseurl: "/docs"
<org-name>.github.io
仓库现在应托管在<org-name>.github.io/
下:
docs
仓库现在应托管在<org-name>.github.io/docs
url中:
要链接到docs
页面,现在只需使用/docs
即可。
permalink: pretty
)从主页链接到文档。base_url
,然后将其作为绝对链接链接(例如,org_name.github.io/docs
和 /home
作为不同的网站)。我想类似于 这个,但是我想避免这种情况,因为它看起来有点 hacky。 - Monolithbase_names
上。例如,如果我有一个域名org.github.io
,它可以有两个基本名称org.github.io/home
和org.github.io/docs
,分别托管在不同的代码库中。但我还不太确定。 - Monolith在一个基于Jekyll的Github Pages站点中可以使用多个Jekyll主题。 我采用的方法是基于@Delfino的答案,使用子文件夹作为独立的Jekyll项目。需要配置设置以确保站点在本地和Github Pages上正确构建。
之前提到的文章中有所有的细节。变量keep_files
、exclude
在根文件夹的_config.yml
中设置,而destination
需要在子文件夹中正确设置。然后,在子文件夹中构建站点,提交生成的文件夹_site
并推送更改到gh-pages
。