504 Gateway Time-out
504 Gateway Time-out
JSP3/2.0.14博客访问： 360155
博文数量： 200
博客积分： 0
博客等级： 民兵
技术积分： 1507
注册时间：
IT168企业级官微
微信号：IT168qiye
系统架构师大会
微信号：SACC2013
分类： Python/Ruby
Jekyll在github上构建免费的Web应用
，将介绍如何利Javascript做为服务端脚本，通过Nodejs框架web开发。Nodejs框架是基于V8的引擎，是目前速度最快的Javascript引擎。chrome浏览器就基于V8，同时打开20-30个网页都很流畅。Nodejs标准的web开发框架Express，可以帮助我们迅速建立web站点，比起PHP的开发效率更高，而且学习曲线更低。非常适合小型网站，个性化网站，我们自己的Geek网站！！
张丹(Conan), 程序员Java,R,PHP,Javascript
weibo：@Conan_Z
转载请注明出处：
程序员会写程序是基本技能，程序员会写文档是更高的能力。用简单的图形表达架构，用流畅语言描述业务，用专业的文笔写成报告，看似简单的要求，但对于普通的程序员来说都是一种挑战。
有时候我们纠结的不是怎么组织文字，而是怎么排版，用哪种字体，居中还是靠右放置？如何能保持多人撰写文档的统一风格？
Jekyll可以帮助我们标准化文档结构，文档样式，文档过程。剩下就是提升自己的知识基础了。
Jekyll介绍
安装Jekyll
用Jekyll构建基于bootstrap模板
发布到Github
1. Jekyll介绍
Jekyll是一个静态站点生成器，它会根据网页源码生成静态文件。它提供了模板、变量、插件等功能，可以用来生成整个网站。
Jekyll生成的站点，可以直接发布到github上面，这样我们就有了一个免费的，无限流量的，有人维护的属于我们的自己的web网站。Jekyll是基于Ruby的程序，可以通过gem来下载安装。
Jekyll官方文档：
2. 安装Ruby
我的系统环境
win7 64bit
下载Ruby 2.0.0-p247 (x64):&
安装Ruby，再安装RubyGems
~ D:\workspace\ruby&ruby --version
ruby 2.0.0p247 () [x64-mingw32]
~ D:\workspace\ruby&gem update --system
Updating rubygems-update
Fetching: rubygems-update-2.1.10.gem (100%)
Successfully installed rubygems-update-2.1.10
Parsing documentation for rubygems-update-2.1.10
Installing ri documentation for rubygems-update-2.1.10
Installing darkfish documentation for rubygems-update-2.1.10
Installing RubyGems 2.1.10
RubyGems 2.1.10 installed
Parsing documentation for rubygems-2.1.10
Installing ri documentation for rubygems-2.1.10
3. 安装Jekyll
~ D:\workspace\ruby&gem install jekyll
Could not find a valid gem 'jekyll' (&= 0), here is why:
Unable to download data from https://rubygems.org/ - SSL_connect returned=1 errno=0 state=SSLv3 read server ce
rtificate B: certificate verify failed (https://rubygems.global.ssl.fastly.net/quick/Marshal.4.8/jekyll-1.3.0.gemspec.rz
Possible alternatives: jekyll
问题1：下载认证文件
~ D:\workspace\ruby&curl http://curl.haxx.se/ca/cacert.pem -o cacert.pem
% Received % Xferd
Average Speed
0:00:02 --:--:-- 94724
# 移动到Ruby安装目录
~ D:\workspace\ruby&mv cacert.pem D:\toolkit\Ruby200\bin
设置环境变量
新打开一个命令行，再安装jekll
~ D:\workspace\ruby&gem install jekyll
Error installing jekyll:
The 'fast-stemmer' native gem requires installed build tools.
Please update your PATH to include build tools or download the DevKit
from 'http://rubyinstaller.org/downloads' and follow the instructions
at '/oneclick/rubyinstaller/wiki/Development-Kit'
问题2：安装Devkit，下载DevKit-mingw64-64-4.7.2-2-sfx.exe：
解压到目录：D:\toolkit\devkit
运行msys.bat，打开ruby命令行，再安装jekll
Administrator@PC ~
$ gem install jekyll
Building native extensions.
This could take a while...
Successfully installed fast-stemmer-1.0.2
Fetching: classifier-1.3.3.gem (100%)
Successfully installed classifier-1.3.3
Fetching: rb-fsevent-0.9.3.gem (100%)
Successfully installed rb-fsevent-0.9.3
Fetching: ffi-1.9.3-x64-mingw32.gem (100%)
Successfully installed ffi-1.9.3-x64-mingw32
Fetching: rb-inotify-0.9.2.gem (100%)
Successfully installed rb-inotify-0.9.2
Fetching: rb-kqueue-0.2.0.gem (100%)
Successfully installed rb-kqueue-0.2.0
Fetching: listen-1.3.1.gem (100%)
Successfully installed listen-1.3.1
Fetching: syntax-1.0.0.gem (100%)
Successfully installed syntax-1.0.0
Fetching: maruku-0.6.1.gem (100%)
Successfully installed maruku-0.6.1
Fetching: yajl-ruby-1.1.0.gem (100%)
Building native extensions.
This could take a while...
Successfully installed yajl-ruby-1.1.0
Fetching: posix-spawn-0.3.6.gem (100%)
Building native extensions.
This could take a while...
Successfully installed posix-spawn-0.3.6
Fetching: pygments.rb-0.5.4.gem (100%)
Successfully installed pygments.rb-0.5.4
Fetching: highline-1.6.20.gem (100%)
Successfully installed highline-1.6.20
Fetching: commander-4.1.5.gem (100%)
Successfully installed commander-4.1.5
Fetching: safe_yaml-0.9.7.gem (100%)
Successfully installed safe_yaml-0.9.7
Fetching: colorator-0.1.gem (100%)
Successfully installed colorator-0.1
Fetching: redcarpet-2.3.0.gem (100%)
Building native extensions.
This could take a while...
Successfully installed redcarpet-2.3.0
Fetching: jekyll-1.3.0.gem (100%)
Successfully installed jekyll-1.3.0
Parsing documentation for classifier-1.3.3
Installing ri documentation for classifier-1.3.3
Parsing documentation for colorator-0.1
Installing ri documentation for colorator-0.1
Parsing documentation for commander-4.1.5
Installing ri documentation for commander-4.1.5
Parsing documentation for fast-stemmer-1.0.2
unable to convert "\x90" from ASCII-8BIT to UTF-8 for lib/stemmer.so, skipping
Installing ri documentation for fast-stemmer-1.0.2
Parsing documentation for ffi-1.9.3-x64-mingw32
Installing ri documentation for ffi-1.9.3-x64-mingw32
Parsing documentation for highline-1.6.20
Installing ri documentation for highline-1.6.20
Parsing documentation for jekyll-1.3.0
Installing ri documentation for jekyll-1.3.0
Parsing documentation for listen-1.3.1
Installing ri documentation for listen-1.3.1
Parsing documentation for maruku-0.6.1
Couldn't find file to include 'MaRuKu.txt' from lib/maruku.rb
Installing ri documentation for maruku-0.6.1
Parsing documentation for posix-spawn-0.3.6
Installing ri documentation for posix-spawn-0.3.6
Parsing documentation for pygments.rb-0.5.4
Installing ri documentation for pygments.rb-0.5.4
Parsing documentation for rb-fsevent-0.9.3
Installing ri documentation for rb-fsevent-0.9.3
Parsing documentation for rb-inotify-0.9.2
Installing ri documentation for rb-inotify-0.9.2
Parsing documentation for rb-kqueue-0.2.0
Installing ri documentation for rb-kqueue-0.2.0
Parsing documentation for redcarpet-2.3.0
unable to convert "\x90" from ASCII-8BIT to UTF-8 for lib/redcarpet.so, skipping
Installing ri documentation for redcarpet-2.3.0
Parsing documentation for safe_yaml-0.9.7
Installing ri documentation for safe_yaml-0.9.7
Parsing documentation for syntax-1.0.0
Installing ri documentation for syntax-1.0.0
Parsing documentation for yajl-ruby-1.1.0
unable to convert "\x90" from ASCII-8BIT to UTF-8 for lib/yajl/yajl.so, skipping
Installing ri documentation for yajl-ruby-1.1.0
18 gems installed
这样就安装好了jekyll。
查看jekyll命令行帮助
DESCRIPTION:
Jekyll is a blog-aware, static site generator in Ruby
Build your site
Launch local server with docs for Jekyll v1.3.0
Search site and print specific deprecation warnings
Display global or [command] help documentation.
Import your old blog to Jekyll
Creates a new Jekyll site scaffold in PATH
Serve your site locally
GLOBAL OPTIONS:
-s, --source [DIR]
Source directory (defaults to ./)
-d, --destination [DIR]
Destination directory (defaults to ./_site)
Safe mode (defaults to false)
-p, --plugins PLUGINS_DIR1[,PLUGINS_DIR2[,...]]
Plugins directory (defaults to ./_plugins)
--layouts DIR
Layouts directory (defaults to ./_layouts)
-h, --help
Display help documentation
-v, --version
Display version information
-t, --trace
Display backtrace when an error occurs
4. 用Jekyll构建基于bootstrap模板
下载jekyll-bootstrap的模板项目
#从github下载模板
Administrator@PC /d/workspace/ruby
$ git clone /plusjade/jekyll-bootstrap.git jekyll
Cloning into 'jekyll'...
remote: Counting objects: 1898, done.
remote: Compressing objects: 100% (), done.
remote: Total 1898 (delta 850), reused 1729 (delta 723)
Receiving objects: 100% (), 575.45 KiB | 184 KiB/s, done.
Resolving deltas: 100% (850/850), done.
#进入项目目录
Administrator@PC /d/workspace/ruby
$ cd jekyll/
#查看目录模板
Administrator@PC /d/workspace/ruby/jekyll
_config.yml
pages.html
History.markdown
categories.html
archive.html
changelog.md
sitemap.txt
Administrator@PC /d/workspace/ruby/jekyll
$ jekyll serve
Configuration file: d:/workspace/ruby/jekyll/_config.yml
Source: d:/workspace/ruby/jekyll
Destination: d:/workspace/ruby/jekyll/_site
Generating... done.
Server address: http://0.0.0.0:4000
Server running... press ctrl-c to stop.
打开浏览器，http://localhost:4000/
通过几条命令，基于bootstrap风格的模板就构建好了。
4. Jekyll的基本使用
编写新文章(Post)
编写新页面(Page)
1). 编写新文章(Create a Post)
通过命令生成文章
~ D:\workspace\ruby\jekyll&rake post title="Hello World"
Creating new post: ./_posts/-hello-world.md
查看文件：-hello-world.md
编辑文件：-hello-world.md
~ vi ./_posts/-hello-world.md
layout: post
title: "Hello World"
description: ""
category: ""
{% include JB/setup %}
## 第一页，jekyll的开始
Jekyll is a parsing engine bundled as a ruby gem used to build static websites from
dynamic components such as templates, partials, liquid code, markdown, etc. Jekyll is known as "a simple, blog aware, static site generator".
### 博客文章：[用Jekyll构建基于bootstrap系统](http://blog.fens.me/jekyll-bootstarp-doc/)
程序员会写程序是基本技能，程序员会写文档是更高的能力。用简单的图形表达架构，用流畅语言描述业务，用专业的文笔写成报告，看似简单的要求，但对于普通的程序员来说都是一种挑战。
有时候我们纠结的不是怎么组织文字，而是怎么排版，用哪种字体，居中还是靠右放置？如何能保持多人撰写文档的统一风格？
Jekyll可以帮助我们标准化文档结构，文档样式，文档过程。剩下就是提升自己的知识基础了。
保存后，启动服务器。
Administrator@PC /d/workspace/ruby/jekyll
$ jekyll serve
Configuration file: d:/workspace/ruby/jekyll/_config.yml
Source: d:/workspace/ruby/jekyll
Destination: d:/workspace/ruby/jekyll/_site
Generating... Error reading file d:/workspace/ruby/jekyll/_posts/
6-hello-world.md: invalid byte sequence in GBK
error: invalid byte sequence in GBK. Use --trace to view backtrace
发现中文的GBK编码报错。
找到jekyll安装目录，修改convertible.rb文件，第38行
~ vi D:\toolkit\Ruby200\lib\ruby\gems\2.0.0\gems\jekyll-1.3.0\lib\jekyll\convertible.rb
#第38行，替换为下面内容
self.content = File.read_with_options(File.join(base, name), :encoding =& "utf-8")
重启服务器
Administrator@PC /d/workspace/ruby/jekyll
$ jekyll serve
Configuration file: d:/workspace/ruby/jekyll/_config.yml
Source: d:/workspace/ruby/jekyll
Destination: d:/workspace/ruby/jekyll/_site
Generating...
___________________________________________________________________________
| Maruku tells you:
+---------------------------------------------------------------------------
| Could not find ref_id = "httpblogfensmejekyllbootstarpdoc" for md_link(["http:
//blog.fens.me/jekyll-bootstarp-doc/"],"httpblogfensmejekyllbootstarpdoc")
| Available refs are []
+---------------------------------------------------------------------------
!d:/toolkit/Ruby200/lib/ruby/gems/2.0.0/gems/maruku-0.6.1/lib/maruku/errors_mana
gement.rb:49:in `maruku_error'
!d:/toolkit/Ruby200/lib/ruby/gems/2.0.0/gems/maruku-0.6.1/lib/maruku/output/to_h
tml.rb:715:in `to_html_link'
!d:/toolkit/Ruby200/lib/ruby/gems/2.0.0/gems/maruku-0.6.1/lib/maruku/output/to_h
tml.rb:970:in `block in array_to_html'
!d:/toolkit/Ruby200/lib/ruby/gems/2.0.0/gems/maruku-0.6.1/lib/maruku/output/to_h
tml.rb:961:in `each'
!d:/toolkit/Ruby200/lib/ruby/gems/2.0.0/gems/maruku-0.6.1/lib/maruku/output/to_h
tml.rb:961:in `array_to_html'
\___________________________________________________________________________
Not creating a link for ref_id = "httpblogfensmejekyllbootstarpdoc".done.
Server address: http://0.0.0.0:4000
Server running... press ctrl-c to stop.
错误解决！
打开浏览器：http://localhost:/06/hello-world/
2). 编写新页面(Create a Page)
通过命令生成页面
~ D:\workspace\ruby\jekyll&rake page name="about.md"
mkdir -p .
Creating new page: ./about.md
~ D:\workspace\ruby\jekyll&rake page name="pages/about"
mkdir -p ./pages/about
Creating new page: ./pages/about/index.html
同样，我们编辑文件，重启jekyii服务就行了。
5. 发布到Github
在github网站，我们创建一个新的库，jekyll-demo
把jekll项目，添加到jekyll-demo
~ D:\workspace\ruby\jekyll&git remote set-url origin :bsspirit/jekyll-demo.git
~ D:\workspace\ruby\jekyll&git add .
~ D:\workspace\ruby\jekyll&git commit -m 'new_post'
[master 1fc298e] 'new_post'
4 files changed, 36 insertions(+)
create mode 100644 _posts/-hello-world.md
create mode 100644 about.md
create mode 100644 pages/about/index.html
~ D:\workspace\ruby\jekyll&git push origin master
Counting objects: 916, done.
Delta compression using up to 4 threads.
Compressing objects: 100% (431/431), done.
Writing objects: 100% (916/916), 297.68 KiB, done.
Total 916 (delta 437), reused 879 (delta 422)
To :bsspirit/jekyll-demo.git
* [new branch]
master -& master
新建一个gh-pages分支，用于发布项目
~ git branch gh-pages
~ git checkout gh-pages
修改文件：_config.yml，设置base_path
~ vi _config.yml
production_url : http://bsspirit.github.io
BASE_PATH : /jekyll-demo
~ git add .
~ git commit -m 'deploy'
~ git push origin gh-pages
发布需要10分钟，10分钟后，在github上面浏览项目，
项目地址的格式为：
http://[username].github.io/[projectname]/
这样我们就可以通过github构建免费的web应用了。
转载请注明出处：
阅读(413) | 评论(0) | 转发(0) |
相关热门文章
给主人留下些什么吧！~~
请登录后评论。采用Jekyll + github + pygments构建个人博客的最终说明 - 简书
采用Jekyll + github + pygments构建个人博客的最终说明
日16:28:35
该文章已经有些久远。随着各自软件的更新迭代，目前安装jekyll以及构建博客相对更加简单。这篇文章只是希望能作个参考，能帮到您当然最好。以及如果看客您感觉这个文章不是太合适的话，还请不要太在意细节。
文章主题目录：
构建github个人博客库：username.github.io
安装jekyll相关内容
修改configuration file以及建立自己的对应网页
安装相关插件，比如markdown解析包、代码高亮包pygments、mathjax相关修改等，以让博客支持自己的大多数写作需求
本地编译预览，没有问题后上传至github
1. 构建github个人博客库：username.github.io
不管怎么样去建立这个博客，首先必须在 github 上有这样的一个库，其名称为 username.github.io，username就是每个github用户的用户ID，只有这样名称的库才能被github用于链接到个人博客。链接的代码就是:
git remote set-url origin :*******/********.github.io.git
2. 安装jekyll相关内容
jekyll 是 Ruby 的一个gem包。安装稍显繁琐，主要顺序如下：
2.1 下载安装ruby
这里下载的ruby版本为1.9.3，由于大陆墙掉了官方给的下载网址，所以百度这个版本的下载即可。注意安装路径不能包含中文和空格，就 c://ruby 蛮好。
2.2 安装 Devkit for Ruby 1.9.3
可到下载。并且在cmd.exe中运行如下代码：
cd devkit // 目的是将当前目录转移到devkit解压路径
ruby dk.rb init
ruby dk.rb install
P.S. 安装过程中记得全部勾选 add to the path，将其位置添加到系统变量中，并且在安装完成后，使用如下代码查询安装版本号确认安装成功(显示版本号即为安装成功)：
2.3 安装 gem 以及 jekyll 包
到下载合适的gem安装包并安装，注意点同上。同时记得这个网站，里面包括了所有的gem功能包，很好狠强大；安装完gem后也记得查看版本号以及安装完成状态。然后安装 jekyll,通过
gem install jekyll // 安装jekyll
gem install kramdown // markdown语言解析包
gem install pygments.rb // 代码高亮包
gem install liquid // 这个包我不知道，但是好像有用
// 还有些别的包，看需要来安装啦
其中，高亮包需要python2.6或2.7的环境，因此还需要安装python，所幸在使用某些gem包的时候，可能会出现 Application runtime error的问题，这个时候也需要安装 Node.js 来提供一个使用环境（maybe），也需要安装python，因此就早点安装了更好。
3. 修改configuration file以及建立自己的对应网页
完成上述操作后，就可以进入博客的成型步骤了。首先需要建立自己的文件档案，也就是博客的硬件来源。有两种方案：
3.1 自己建立
可以自己通过如下代码建立，会在当前目录下产生一个jekyll默认模板文件夹，里面包含了主要的文件内容，将其整体拷贝到自己的仓库中即可。
jekyll new (name)
3.2 fork别人
但是更好的方式可能是这种，因为建立一个漂亮的博客是每一个bloger最希望的事，但是可能刚开始入手会有点难，从0开始的话需要安装主题、自己做前段开发是件很考验编程水平和艺术水平的事，不妨可以在刚开始接触的时候先套用别人的模板，等自己对大致使用方法和流程了解后，再在其基础上或自己从0开始构建自己心中最完美的博客。网上有很多牛人提供了漂亮的主题以及博客模板，因此可以通过github fork，然后将名字改为自己的username.github.io；然后clone到本地（注意路径不能包含中文，因为jekyll在建立运行时对中文不识别导致不成功）。
3.3 修改相应文件建立自己的blog
库中所包含的主要文件及文件夹有：
文件夹_layouts：用于存放模板的文件夹，
文件夹_posts：用于存放博客文章的文件夹
文件夹css：存放博客所用css的文件夹,比如主题文件以及高亮文件都是放在此处的
.gitignore：可以删掉，后面会将项目添加到git项目，所以这个不需要了
_coinfig.yml：jekyll的配置文件，里面可以定义相当多的配置参数，具体配置参数可以参照其官网
index.html：项目的首页
_includes:用于存放一些固定的HTML代码段，文件为.html格式，可以在模板中通过liquid标签引入，常用来在各个模板中复用如 导航条、标签栏、侧边栏之类的在每个页面上都一样不变的内容，需要注意的是，这个代码段也可以是未被编译的，也就是说也可以使用liquid标签放在这些代码段中
通过修改配置文件_coinfig.yml以及post和layouts就可以实现主要blog的建立和修改。
4. 安装相关插件，比如markdown解析包、代码高亮包pygments、mathjax相关修改等，以让博客支持自己的大多数写作需求
4.1 markdown解析包 kramdown
通过gem安装后，需要在配置文件 _coinfig.yml 中添加该项：
markdown: kramdown
input: GFM
4.2 代码高亮包 pygments
安装后，首先需要一个 .css 文件，但是我也不清楚怎么在windows下生成这个文件，也就是从找到的一个，且其，并且名字成为 highlight.css，存放目录为 ./assets/css以及./_site/assets/css两个文件夹，然后同样需要在配置文件中做如下修改：
highlight: true
并且需要对样式进行链接，需要修改生成网页的模板或通用头文件，进入本地库目录 ./_includes/header.html,然后添加下句：
&link rel="stylesheet" href="/assets/css/highlight.css"&
//其中 /assets/css/ 为该文件所在位置
在使用代码时，需要在符合markdown的语法基础上，在代码主体前后添加两句话，举例如下：
{% highlight c++ linenos %}
cout&&"HAHAHA"&&
cout&&"I am Hahaha"&&
{% endhighlight %}
4.3 使用mathjax呈现公式
虽然kramdown是支持mathjax语法的，但是为了使网页可以使用mathjax，还需要作如下修改，可参考，同样到库 ./_includes/header.html，添加如下语句，有的里面给出的添加内容没有这么多，但是多多益善吧，仅仅信之。
5. 本地编译预览，没有问题后上传至github
5.1 本地编译预览
使用命令建立并在当地可预览当前的网页状态，网址为： ，如果有问题则继续修改，没有就可以进行下一步了。
jekyll build
jekyll serve
5.2 通过github将本地库的改动提交到网上
所使用的命令为：
git add . // 如果没有新加文件可以不用运行此句
git commit -am '描述内容'
git push (-u origin master) // 括号中内容可加可不加
如果没有提示错误的话，一切顺利，就可以去网站： 查看属于自己的个人博客啦！~~标签：至少1个，最多5个
系列文章传送门：
首先安装git bash和申请，这个文章很多，百度、Google上一抓一大把，就不重复赘述了
对已有项目进行git初始化
到jekyll项目下，运行命令：
$ git init
创建一个名为gh-pages的分支
$ git checkout --orphan gh-pages
上说如果要部署在github上，必须名称叫gh-pages。所以先创建一个叫gh-pages的分支
$ git add .
$ git commit -a -m "v0.0.1 first blood"
提交所有的修改到本地的git仓库
上传到github
使用命令：
$ git remote add origin /(github用户名)/(jekyll项目名称).git
$ git push origin gh-pages
修改后提交
使用命令：
$ git add .
$ git commit -a -m "自己的提交注释"
$ git push origin gh-pages
第一句增加所有新增的文件到项目中
第二句提交所有修改
第三句将修改提交到远程github服务器
绑定到自己的域名
如果是绑定到一级域名：
1. 首先在项目根目录下创建一个叫CNAME文件，里面写上自己的以及一级域名（如这个博客就是）
2. 在DNS中为自己的域名增加一条A记录，指向207.97.227.245
3. 将项目提交到github上，等一会儿（不会超过1小时）
4. baseurl应该为"/"
5. 访问自己的域名看看结果吧
如果是绑定到二级域名，需要额外在DNS中增加一条CNAME，指向(github用户名).github.io，然后再CNAME文件中修改为自己的二级域名即可
0 收藏&&|&&33
你可能感兴趣的文章
3 收藏，1.3k
21 收藏，12k
4 收藏，929
谢谢！（字数太短, 至少要包括6个字符）
看了这么多介绍jekyll的文章，你写的最清楚！
并不是一定要gh-pages分支，也可以在mastet分支下建立docs文件夹，取决于你在项目的仓库设置(Settings)中的 GitHub Pages Source 下拉菜单选择 master branch/docs folder 或 gh-pages branch。
可以看看我的个人博客:
谢谢你！！！感激
用pinp-blogs搭建 于github.io上的博客会更爽，也借助gh-pages分支用于Web发布的原理，但该工具提供丰富的可视化编辑功能，写博客，写胶片，妥妥的！网址：
分享到微博？
技术专栏，帮你记录编程中的点滴，提升你对技术的理解收藏感兴趣的文章，丰富自己的知识库
明天提醒我
我要该，理由是：
扫扫下载 App