创建仓库
首先要创建仓库,仓库的名字需要和你的账号对应,比如我的账号是 gf5353, 那么我的仓库名则为gf5353.github.io
创建完之后进入Settings后会有个 Launch automatic page generator
进入之后直接 Continue to layouts
接下来会让你选择模板,发布之后就可以通过gf5353.github.io来访问你发布的站点了
更换模板(Jekyll)
Jekyll是一个静态网站生成工具。它允许用户使用HTML、Markdown或Textile来建立静态页面,然后通过模板引擎Liquid(Liquid Templating Engine)来运行.步骤大致如下
-安装 Ruby
-安装 DevKit
-安装 Jekyll
-安装 Pygments
-安装 Python
-安装 ‘Easy Install’
-安装 Pygments
-启动 Jekyll
-故障诊断
安装 Ruby
前往 http://rubyinstaller.org/downloads/
我这边是64位的,需要把ruby和devkit下载下来
注意Ruby在安装的过程中需要选择Add Ruby executables to your PATH,这样执行程序会被自动添加至 PATH 而避免不必要的头疼。
打开一个命令提示行并输入以下命令来检测 Ruby 是否成功安装。
ruby -v
//输出格式为版本号
安装 DevKit
就是刚才一起下载的那个文件,解压到某目录后,执行以下目录
cd “C:\DevKit”
ruby dk.rb init
notepad config.yml
在末尾添加 - C:\Ruby200-x64 保存退出,通过命令来检测是否安装成功
ruby dk.rb review
ruby dk.rb install
安装 Jekyll
确保gem是否安装
gem -v//同样版本号则安装成功
gem install jekyll//安装命令
在国内这是要被墙掉的,但是万能的淘宝提供了万能的镜像, https://ruby.taobao.org/
[root@webscan-55 ruby-2.1.3]# gem sources -l
*** CURRENT SOURCES ***
https://rubygems.org/
[root@webscan-55 ruby-2.1.3]# gem sources --remove https://rubygems.org/
https://rubygems.org/ removed from sources
[root@webscan-55 ruby-2.1.3]# gem sources -a https://ruby.taobao.org/
http://ruby.taobao.org/ added to sources
[root@webscan-55 ruby-2.1.3]# gem sources -l
*** CURRENT SOURCES ***
https://ruby.taobao.org/
//替换源之后再安装,有时默认源多试几次也能安装
gem install jekyll
安装 Python
为的是使用Pygments Jekyll 里默认的语法高亮插件 ,它需要安装 Python 并在网站的配置文件_config.yml 里将 highlighter 的值设置为pygments。
如果不需要可忽略此步骤
前往 http://www.python.org/download/
尽量选Python 2的版本,3可能无法工作
python –V//输出版本则正常
安装 Easy Install
浏览 https://pypi.python.org/pypi/setuptools#installation-instructions 来查看详细的安装指南。
对于 Windows 7 的机器,下载 ez_setup.py 并保存,例如,至C:\。 然后从命令行使用 Python 运行此文件:
python “C:\ez_setup.py”
添加 ‘Python Scripts’ 路径 (如: C:\Python27\Scripts) 至 PATH
安装 Pygments
确保 easy_install 已经正确安装
easy_install --version
输出示例:
setuptools 3.1
使用 “easy_install” 来安装 Pygments
easy_install Pygments
启动 Jekyll
jekyll new myblog
cd myblog
jekyll serve
一个新的 Jekyll 博客可以被建立并在localhost:4000浏览。
注意:
一定要确保你的文章要保存为UTF-8 无 BOM 格式才行。 文件名称不能是中文
配置域名
首先域名选购,地方很多,作用都一样,哪里申请都可以
添加纪录类型A 主机名分别是@ 和 www 纪录值改为 192.30.252.153
最后在你的github仓库里修改个CANAME 改成你的域名,这样这访问gf5353.github.io 的时候就会重定向到你指定的域名了,
改完之后就等生效了
git提交markdown文件
markdown语法自行百度吧,这里提供一个刚刚入门git的不想敲命令的提交工具,挺方便, 请移驾到这里
参考链接
http://blog.csdn.net/kong5090041/article/details/38408211
http://www.tuicool.com/articles/7Vz6BzJ