Jekyll describes installing the. GitHub Static page tool

  
 

   
  

  


   
  

  
jekyll build
   
  

  
# => 当前文件夹中的内容将会生成到 ./site 文件夹中。
   
  

  

   
  

  
$ jekyll build --destination <destination>
   
  

  
# => 当前文件夹中的内容将会生成到目标文件夹<destination>中。
   
  

  

   
  

  
$ jekyll build --source <source> --destination <destination>
   
  

  
# => 指定源文件夹<source>中的内容将会生成到目标文件夹<destination>中。
   
  

  

   
  

  
$ jekyll build --watch
   
  

  
# => 当前文件夹中的内容将会生成到 ./site 文件夹中，
   
  

  
# 查看改变，并且自动再生成。
  
 

  
 

   
  

  
jekyll serve
   
  

  
# => 一个开发服务器将会运行在 http://localhost:4000/
   
  

  

   
  

  
$ jekyll serve --detach
   
  

  
# => 功能和`jekyll serve`命令相同，但是会脱离终端在后台运行。
   
  

  
# 如果你想关闭服务器，可以使用`kill -9 1234`命令，"1234" 是进程号（PID）。
   
  

  
# 如果你找不到进程号，那么就用`ps aux | grep jekyll`命令来查看，然后关闭服务器。[更多](http://unixhelp.ed.ac.uk/shell/jobz5.html).
   
  

  

   
  

  
$ jekyll serve --watch
   
  

  
# => 和`jekyll serve`相同，但是会查看变更并且自动再生成。
  
 

 
   
  

  
    
   
还有一些可以配置的配置选项. 很多配置选项既可以在命令行中作为标识(flags)设定，也可以在源文件根目录中的 _config.yml 文件中进行设定。Jekyll 会自动加载这些配置。比如你在你的 _config.yml 文件中添加了下面几行：
  
    
   
source: _source
  
    
   
destination: _deploy
  
    
   
jekyll build
  
    
   
$ jekyll build --source _source --destination _deploy
 
   
  

  
 

   
  

  
//jekyll安装
   
  

  
1. 下载最新的RubyInstaller并安装(我下载的是rubyinstaller-1.9.3-p194.exe)，设置环境变量，path中配置C:\Ruby193\bin目录，然后在命令行终端下输入gem update --system来升级gem；
   
  

  

   
  

  
2. 下载最新的DevKit，DevKit是windows平台下编译和使用本地C/C++扩展包的工具。它就是用来模拟Linux平台下的make,gcc,sh来进行编译。但是这个方法目前仅支持通过RubyInstaller安装的Ruby，并双击运行解压到C:\DevKit。然后打开终端cmd，输入下列命令进行安装：
   
  

  

   
  

  
cd C:\DevKit
   
  

  

   
  

  
ruby dk.rb init
   
  

  

   
  

  
ruby dk.rb install
   
  

  

   
  

  
3. 完成上面的准备就可以安装Jekyll了,因为Jekyll是用Ruby编写的,最好的安装方式是通过RubyGems(gem):
   
  

  

   
  

  
gem install Jekyll
   
  

  

   
  

  
并使用命令检验是否安装成功
   
  

  

   
  

  
jekyll --version
   
  

  

   
  

  
4. 安装Rdiscount，这个用来解析Markdown标记的包，使用如下命令：
   
  

  

   
  

  
gem install rdiscount
   
  

  

   
  

  
5. 运行本地工程：
   
  

  

   
  

  
cd 到工程目录，启动服务：
   
  

  

   
  

  
jekyll --server
  
 

  
 

   
  

  
 jekyll目录结构
   
  

  
 _posts： _posts中的数据文档，通过注入_layouts定义的模板，通过jekyll --server最终生成的静态页面在_sites目录。目录是用来存放你的文章的，一般以日期的形式书写标题。
   
  

  
 _layouts：_layouts中的模板一般指向了_includes/themes中的模板。目录是用来存放模板的，在这里你可以定义页面中不同的头部和底部。
   
  

  
 _includes：
   
  

  
1) _includes/JB中有一些常用的工具，用于列表显示、评论等；
   
  

  

   
  

  
2) _includes/themes中可参看主题的相关html文档。
   
  

  

   
  

  
3) _includes/themes中的主题一般包含default.html、post.html和page.html三个文档。default.html定义了网站的最上层框架（模板），post.html和page.html是其子框架（模板）。
   
  

  

   
  

  
4) 生成好的html子页面通过default.html的{{ content }}变量调用，生成整个页面。
   
  

  

   
  

  
 assets 渲染页面的CSS和JS文档在assets/themes中
   
  

  
 _config.yml 站点生成需要用到_config.yml配置文件，站点的全局变量在_config.yml中定义，用site.访问；页面的变量在YAML Front Matter中定义，用page.访问，更多的模板变量可参考模板数据。
   
  

  
 index.html是你的页面首页。
  
 

  
 

   
  

  
 Jekyll-Bootstrap创建博客
   
  

  
1. 创建个人站点，即创建一个新资源，格式为username.github.com；
   
  

  

   
  

  
2. 安装Jekyll-Bootstrap：
   
  

  

   
  

  
$ git clone https://github.com/plusjade/jekyll-bootstrap.git USERNAME.github.com
   
  

  

   
  

  
$ cd USERNAME.github.com
   
  

  

   
  

  
$ git remote set-url origin [email protected].com:USERNAME/USERNAME.github.com.git
   
  

  

   
  

  
$ git push origin master
   
  

  

   
  

  
3. 访问创建好的个人站点：username.github.com
   
  

  

   
  

  
4. 在本地测试查看效果：
   
  

  

   
  

  
cd USERNAME.github.com
   
  

  

   
  

  
jekyll --server
  
 

  
 

   
  

  
Jekyll 写博过程
   
  

  
1、 配置_config.yml：
   
  

  

   
  

  
1) 修改标题：title : My Blog =)
   
  

  

   
  

  
2) 修改个人信息：
   
  

  

   
  

  
author :
   
  

  

   
  

  
name : Name Lastname
   
  

  

   
  

  
email : [email protected].test
   
  

  

   
  

  
github : username
   
  

  

   
  

  
twitter : username
   
  

  

   
  

  
feedburner : feedname
   
  

  

   
  

  
3) 引用：_config.yml中的键值均引用到其他页面{{ site.title }}；
   
  

  

   
  

  
2、 写文章
   
  

  

   
  

  
按照_config.yml的格式permalink: /:categories/:year/:month/:day/:title，可以修改格式，创建markdown格式文件，就可以当初博客发布了。
   
  

  

   
  

  
3、 发布
   
  

  

   
  

  
本地预览修改：运行jekyll –server，预览http:127.0.0.1:4000。
   
  

  

   
  

  
发布到github上：通过命令提交或者客户端提交。
   
  

  

   
  

  
4.6 个性化博客
   
  

  
Github Page完成了博客的主要功能，写作、发布、修改，这些都是相对静态的东西，就是你自己可以控制的事情，还有一些动态的东西Github Pages无法支持，比如说文章浏览次数、文章的评论等，还有一些个性化的东西，像个性化页头页尾、代码高亮可以把博客整的更漂亮一点，其实这写都可以通过第三方应用来实现，个性化自己的博客。
   
  

  

   
  

  
加上Disqus云评论:
   
  

  

   
  

  
注册http://disqus.com/
  
 

From for notes (Wiz)

Jekyll describes installing the. GitHub Static page tool