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

Posted itly

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了jekyll介绍安装.github静态页面工具相关的知识,希望对你有一定的参考价值。


  1. jekyll build
  2. # => 当前文件夹中的内容将会生成到 ./site 文件夹中。
  3. $ jekyll build --destination <destination>
  4. # => 当前文件夹中的内容将会生成到目标文件夹<destination>中。
  5. $ jekyll build --source <source> --destination <destination>
  6. # => 指定源文件夹<source>中的内容将会生成到目标文件夹<destination>中。
  7. $ jekyll build --watch
  8. # => 当前文件夹中的内容将会生成到 ./site 文件夹中,
  9. # 查看改变,并且自动再生成。
  1. jekyll serve
  2. # => 一个开发服务器将会运行在 http://localhost:4000/
  3. $ jekyll serve --detach
  4. # => 功能和`jekyll serve`命令相同,但是会脱离终端在后台运行。
  5. # 如果你想关闭服务器,可以使用`kill -9 1234`命令,"1234" 是进程号(PID)。
  6. # 如果你找不到进程号,那么就用`ps aux | grep jekyll`命令来查看,然后关闭服务器。[更多](http://unixhelp.ed.ac.uk/shell/jobz5.html).
  7. $ jekyll serve --watch
  8. # => 和`jekyll serve`相同,但是会查看变更并且自动再生成。
  1. 还有一些可以配置的配置选项. 很多配置选项既可以在命令行中作为标识(flags)设定,也可以在源文件根目录中的 _config.yml 文件中进行设定。Jekyll 会自动加载这些配置。比如你在你的 _config.yml 文件中添加了下面几行:
  2. source: _source
  3. destination: _deploy
  4. jekyll build
  5. $ jekyll build --source _source --destination _deploy

  1. //jekyll安装
  2. 1. 下载最新的RubyInstaller并安装(我下载的是rubyinstaller-1.9.3-p194.exe),设置环境变量,path中配置C:\Ruby193\bin目录,然后在命令行终端下输入gem update --system来升级gem
  3. 2. 下载最新的DevKitDevKitwindows平台下编译和使用本地C/C++扩展包的工具。它就是用来模拟Linux平台下的make,gcc,sh来进行编译。但是这个方法目前仅支持通过RubyInstaller安装的Ruby,并双击运行解压到C:\DevKit。然后打开终端cmd,输入下列命令进行安装:
  4. cd C:\DevKit
  5. ruby dk.rb init
  6. ruby dk.rb install
  7. 3. 完成上面的准备就可以安装Jekyll了,因为Jekyll是用Ruby编写的,最好的安装方式是通过RubyGems(gem):
  8. gem install Jekyll
  9. 并使用命令检验是否安装成功
  10. jekyll --version
  11. 4. 安装Rdiscount,这个用来解析Markdown标记的包,使用如下命令:
  12. gem install rdiscount
  13. 5. 运行本地工程:
  14. cd 到工程目录,启动服务:
  15. jekyll --server
  1. jekyll目录结构
  2. _posts _posts中的数据文档,通过注入_layouts定义的模板,通过jekyll --server最终生成的静态页面在_sites目录。目录是用来存放你的文章的,一般以日期的形式书写标题。
  3. _layouts_layouts中的模板一般指向了_includes/themes中的模板。目录是用来存放模板的,在这里你可以定义页面中不同的头部和底部。
  4. _includes
  5. 1) _includes/JB中有一些常用的工具,用于列表显示、评论等;
  6. 2) _includes/themes中可参看主题的相关html文档。
  7. 3) _includes/themes中的主题一般包含default.htmlpost.htmlpage.html三个文档。default.html定义了网站的最上层框架(模板),post.htmlpage.html是其子框架(模板)。
  8. 4) 生成好的html子页面通过default.html的{{ content }}变量调用,生成整个页面。
  9. assets 渲染页面的CSSJS文档在assets/themes
  10. _config.yml 站点生成需要用到_config.yml配置文件,站点的全局变量在_config.yml中定义,用site.访问;页面的变量在YAML Front Matter中定义,用page.访问,更多的模板变量可参考模板数据。
  11. index.html是你的页面首页。
  1. Jekyll-Bootstrap创建博客
  2. 1. 创建个人站点,即创建一个新资源,格式为username.github.com
  3. 2. 安装Jekyll-Bootstrap
  4. $ git clone https://github.com/plusjade/jekyll-bootstrap.git USERNAME.github.com
  5. $ cd USERNAME.github.com
  6. $ git remote set-url origin [email protected].com:USERNAME/USERNAME.github.com.git
  7. $ git push origin master
  8. 3. 访问创建好的个人站点:username.github.com
  9. 4. 在本地测试查看效果:
  10. cd USERNAME.github.com
  11. jekyll --server
  1. Jekyll 写博过程
  2. 1 配置_config.yml
  3. 1) 修改标题:title : My Blog =)
  4. 2) 修改个人信息:
  5. author :
  6. name : Name Lastname
  7. email : [email protected].test
  8. github : username
  9. twitter : username
  10. feedburner : feedname
  11. 3) 引用:_config.yml中的键值均引用到其他页面{{ site.title }};
  12. 2 写文章
  13. 按照_config.yml的格式permalink: /:categories/:year/:month/:day/:title,可以修改格式,创建markdown格式文件,就可以当初博客发布了。
  14. 3 发布
  15. 本地预览修改:运行jekyll server,预览http:127.0.0.1:4000
  16. 发布到github上:通过命令提交或者客户端提交。
  17. 4.6 个性化博客
  18. Github Page完成了博客的主要功能,写作、发布、修改,这些都是相对静态的东西,就是你自己可以控制的事情,还有一些动态的东西Github Pages无法支持,比如说文章浏览次数、文章的评论等,还有一些个性化的东西,像个性化页头页尾、代码高亮可以把博客整的更漂亮一点,其实这写都可以通过第三方应用来实现,个性化自己的博客。
  19. 加上Disqus云评论:
  20. 注册http://disqus.com/





以上是关于jekyll介绍安装.github静态页面工具的主要内容,如果未能解决你的问题,请参考以下文章

如何在 github.io 上使用 Jekyll 制作一本书

jekyll搭建博客

Jekyll 博客文件夹不会在 github 页面上编译,但可以离线工作

Jekyll-Admin: Jekyll后台管理工具

Github+Jekyll 搭建个人网站详细教程

Jekyll 中看起来像终端的代码块