Jekyll 教程二:基础使用

HomeJekyllJekyll 教程二:基础使用

安装完之后,我们就可以在终端上执行 jekyll 命令来使用。这里介绍一下一些基础的用法。

自从 Jekyll 1.1 就开始使用 Markdown 语法来渲染新的站点。假如我们还没有站点,可以通过下面的 3 行代码来完成一个博客站点的建立:

##新建一个博客
$ jekyll new blog

##切换到博客目录下,这时候已经生成文件了
$ cd blog

##启动服务,以 4000 为端口
$ jekyll server

这时候,我们就可以通过浏览器访问http://localhost:4000,来查看我们建好的博客站点。默认的主题很经典,基本可以满足你的博客写作需求。

如何写作?

我们回头看下 Jekyll 帮我们默认生成的目录:

.
├── _config.yml
├── _layouts
│   ├── default.html
│   └── post.html
├── _posts
│   └── 2013-08-07-welcome-to-jekyll.markdown
├── css
│   ├── main.css
│   └── syntax.css
└── index.html

我们要写的文章,就放在_posts目录下,以这样的形式命名一篇文章:YYYY-MM-DD-name-of-post.markdown 。

这样一批文件,在jekyll server这个命令下,就会生成一个_site的目录,我们在浏览器访问时,就会指向这个目录下的文件。

还有其他的命令?

我们生成一个博客,然后在本地测试,常用jekyll server,其实还有很多有用的命令供我们使用。

$ jekyll build
## => 把博客生成到 _site 目录下

$ jekyll build --destination 
## => 把博客生成到 <指定> 目录下

$ jekyll build --source  --destination 
## => <源文件> 将会生成到 <指定> 目录下

$ jekyll build --watch
## 当文件有修改的时候,自动生成到 _site 下

启动本地的服务,我们使用下面的命令

$ jekyll server
## => 在较早的 Jekyll 版本,是 jekyll --server,后来改了

$ jekyll server --watch
## => 监控文件变化,自动生成到 _site 目录下

经过了这两节介绍,大致能够使用 Jekyll 来建立自己的博客。接下来的几篇教程中,可以更深入地理解 Jekyll 的构造,便于修改自己的博客主题。

  • 作者「」于 更新本文
  • 文章声明:自由转载-非商用-非衍生-保持署名 | BY-NC-SA
← Jekyll 教程一:安装 Jekyll 教程三:目录结构→
  • 获取每日の能量源
  • ATP