jekyll介绍安装.github静态页面工具

  
  
  
  

   
   
   
   

   
   
   
   

   
   
   
   

   
   
   
   

   
   
   
   

   
   
   
   

   
   
   
   

   
   
   
   

   
   
   
   

   
   
   
   

   
   
   
   

   
   
   
   

   
   
   
   

  
  
  
  

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: _sourcedestination: _deployjekyll 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:\DevKitruby dk.rb initruby dk.rb install3. 完成上面的准备就能够安装Jekyll了,由于Jekyll是用Ruby编写的,最好的安装方式是经过RubyGems(gem):gem install Jekyll并使用命令检验是否安装成功jekyll --version4. 安装Rdiscount，这个用来解析Markdown标记的包，使用以下命令：gem install rdiscount5. 运行本地工程：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 git@github.com:USERNAME/USERNAME.github.com.git$ git push origin master3. 访问建立好的我的站点：username.github.com4. 在本地测试查看效果：cd USERNAME.github.comjekyll --server

      
      
      
      

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

       
       
       
       

      
      
      
      
Jekyll 写博过程1、 配置_config.yml：1) 修改标题：title : My Blog =)2) 修改我的信息：author :name : Name Lastnameemail : blah@email.testgithub : usernametwitter : usernamefeedburner : feedname3) 引用：_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/

来自为知笔记(Wiz)