我最近发现了jekyll,并想用它制作一个项目登录页面。我想有一个使用一个主题(例如ubuild )的主页,并有另一个使用不同主题(例如just-the-docs )的文档页面(通过顶部的导航栏访问)。我该怎么做呢?
编辑:我想为此使用 Github Pages。
我最近发现了jekyll,并想用它制作一个项目登录页面。我想有一个使用一个主题(例如ubuild )的主页,并有另一个使用不同主题(例如just-the-docs )的文档页面(通过顶部的导航栏访问)。我该怎么做呢?
编辑:我想为此使用 Github Pages。
我在@JoostS 的回答的帮助下解决了这个问题,但做了一些修改:
在GitHub页面上使用名为<org-name>.github.io
. 这个 repo 应该包含主页的主题(ubuild
在我的例子中)和它的所有内容。
使用 jeykll 站点创建另一个 repo,名为docs
. 这个网站应该有你想要的其他页面的主题(just-the-docs
在我的例子中)以及所有的内容。
在docs
repo 中,添加baseurl: "/docs"
到您的_config.yml
回购协议现在<org-name>.github.io
应该托管在<org-name>.github.io/
:
存储库docs
现在应该托管在<org-name>.github.io/docs
url 上:
要链接到该docs
页面,您现在应该可以使用/docs
。
由于您计划仅在一个页面上使用其中一个主题,我认为最好的解决方案是使用两个基本布局而不是两个主题。
最初需要一些小工作,但会大大简化未来的维护。
首先设置站点以呈现所有页面just-the-docs
的主题,包括登录页面。然后修改为父布局(如布局)以从主题呈现标记。_layouts/home.html
default
ubuild..
使用 Jekyll 和 GitHub Pages 在同一站点上维护两个布局的最简单方法是为新布局创建一个新存储库,因此主站点位于 GitHub 组织中,需要使用不同布局的页面必须是在您的存储库中。
但是,如果你不使用 GitHub,只使用 jekyll,只需将每个文件夹配置为新的 Jekyll 项目,并指示它们写入 _site 文件夹中的相应子文件夹。为了解决所有问题,您需要从主文件夹启动 Jekyll Server,然后分别构建每个子文件夹,因此它会在不删除主文件夹的情况下更新
解决方案是创建两个单独的网站。第一个站点仅包含主页,应部署到 Web 文件夹的根目录。第二个站点包含所有文档,应该部署到一个子目录,例如“/docs/”。您可能希望为此使用 baseurl:https ://byparker.com/blog/2014/clearing-up-confusion-around-baseurl/
我认为您不能在 Github 页面上使用此解决方案。您可以尝试将相同的 CNAME 添加到两个存储库,因为我不确定 100%。任何其他静态托管环境都应该可以工作。
您可以通过链接到“/”来从文档链接到主页。您可以通过链接到“/docs/pagename/”(假设您使用permalink: pretty
)从主页链接到文档。