Jekyll自定义主题(在本地运行)

时间:2018-09-17 16:36:30

标签: jekyll jekyll-theme

我是Jekyll的新手,我正在尝试启动并运行自定义主题。到目前为止,这是我所做的:

  1. 创建了我的Jekyll网站。 CD到我要安装并运行的目录

    bundle exec jekyll serve

这些文件已创建,我可以在默认的4000端口本地查看该站点。

enter image description here

然后我尝试按照说明here来安装您自己的主题。我在终端输入了此内容:

$ jekyll new-theme skull_and_roses

如指示所示,它建立了一个新目录...

enter image description here

它还在_site目录中添加了一个目录,不确定是否正确:

enter image description here

然后我按照以下说明进行操作:

enter image description here

但是当我运行它时:

bundle exec jekyll serve --watch

我收到一个错误:

The skull_and_roses theme could not be found.

就像我说的那样,这是我在Jekyll的第一次跑步,因此对您的帮助将不胜感激。

1 个答案:

答案 0 :(得分:2)

我还使用了jekyll theme template(这是一个非常友好的手册模板),并对其进行了自定义以最近设置my own github page

除了在github上使用用户名(username.github.io)创建回购外,我在Mac上(本地)所做的是:

  1. 设置环境以使用Jekyll,您可以参考:https://jekyllrb.com/docs/

  2. $ git clone https://github.com/username/username.github.io.git(假设您已经创建了存储库)。

  3. $ cd username.github.io

  4. $ git clone <theme github repo>

  5. 将所有主题文件放入您的网站文件的根目录(我们在步骤2中创建的目录)

  6. 通常主题模板将具有Gemfile,如果确实没有,您可以尝试创建Gemfile并输入:

    source 'https://rubygems.org'
    gem 'github-pages', group: :jekyll_plugins
    

    确认拥有Gemfile后,运行

    $ bundle install 
    $ bundle exec jekyll serve
    

    现在,您可以输入localhost:4000127.0.0.1:4000来检查主题是否可以在本地服务上运行。

  7. 然后,您可以根据主题模板说明主要修改_config.yml文件,如标题,作者等。每当您更新某些内容并想要检查结果时,都可以在本地(localhost:4000127.0.0.1:4000)进行检查。通常在_config.yml中进行更改,您需要重新启动jekyll serve(使用ctrl+c停止并运行$ bundle exec jekyll serve以重新启动服务以检查修改。您可能需要修改更多内容而不是_config.yml文件来满足您的要求,至少像about.md一样,或者在_post中添加您自己的帖子。

  8. 完成对主题模板的修改,并创建自己喜欢的github页面。您可以将本地存储库推送到远程存储库(username.github.io的主分支)。顺便说一句,如果您在本地工作,则可以使用分支来测试要添加的功能,在本地检查结果,然后对结果满意后再合并到母版中。

  9. 最后,您可以检查:https://username.github.io并享受自己的github页面。

  10. 关于_site和其他您可能想知道的其他问题,您可能还需要检查以下内容:

    Creating and Hosting a Personal Site on GitHub

    Quick start & tutorials on jekyll