当前位置: 首页 > 工具软件 > Jekyll > 使用案例 >

用Jekyll写博客

冯流觞
2023-12-01

安装Jekyll-Bootsrap

安装Jekyll-Bootsrap,如果你还没安装好。Jekyll-Bootsrap是一个博客框架,拥有内建的主题、分析、评论以及Post/Page建立功能。


$ gem install jekyll

如果安装出了问题,请看看原始的Jekyll安装文档。你也可以通过GitHub Issues来创建一个支持issue

一旦这个gem安装好,你就可以转到你的Jekyll-Bootsrap安装目录。如果你一直跟着首页的说明来做,此目录将是:USERNAME.github.com。进入此目录后,你就可以运行有服务器支持的jekyll:


cd USENAME.github.com
jekyll --server
# 记得将USENAME改为你自己的GitHub用户名

新建一篇博文(Post)

你可以轻易地通过一个rake任务来新建博文:


$ rake post title="Hello World"

此rake任务会自动创建一个有着正确的格式化好文件名的文件和一个YAML Front Matter。确保指定一个你自己的标题。缺省日期是当前日期。


# 根据我的测试,写上日期才不会报错
$ rake post title="Hi, Jekyll" date="2012-03-04"

此rake任务不会覆盖任何已存在的博文,除非你让它那样做。

新建一个页面(Page)

新建页面也是通过rake任务,同样很容易:


$ rake page name="about.md"

新建一个嵌套页面:


$ rake page name="pages/about.md"

新建一个有着好看路径的页面:


$ rake page name="pages/about"
# 这会建立一个文件: ./pages/about/index.html

此rake任务会自动创建一个有着正确的格式化好文件名的文件和一个YAML Front Matter,同时包含Jekyll Bootstrap的设置文件。

Jekyll-Bootstrap页面样例

Jekyll-Bootstrap同样提供了许多预配置好页面样例提供用户参考。你可以学习它们的代码然后按照你需要的样子定制。

发布

在你添加了一些博文或改了主题等其它文件后,简单地提交它们到你的git仓库并push到GitHub上。


$ git add .
$ git commit -m "添加了新内容"
$ git push origin master

定制

Jekyll-Bootstrap是一个基本的博客平台。有许多方式可以深入定制它。下列就是Jekyll-Bootstrap更深入的定制技术:

主题

Jekyll-Bootstrap支持模块化主题。多个主题可以同时存在,且能根据需要关闭或打开。编辑、配置以及建立主题的方法在文档的主题一节。

博客配置

Jekyll和Jekyll-Bootstrap有一个简单但强大的Jekyll配置系统。你可以:

* 为博文指定一个自定义的链接格式

  • 为博客指定一个评论系统,如disqus、intensedebate、livefyre或者自定义
  • 为博客指定一个分析引擎,如google、getclicky或者自定义

编程接口

API页面文档里主要的数据结构和代码都可以用于Jekyll和Jekyll-Bootstrap。查看这些页面以知晓如何使用以及何处使用这些数据的代码。

Jekyll介绍

强烈推荐
如果你计划定制你的博客,我强烈推荐你阅读Jekyll介绍。此介绍说明了如何以及为何Jekyll按照它工作的方式工作。This will provide you with the proper context, knowledge-base, and fundamentals necessary to understand and be efficient in working with Jekyll and Jekyll-Bootstrap.

 类似资料: