怎样用Github Pages建立博客（1。入门）
2017年1月7日 分类： 杰基尔 ;
create-blog系列博文
2017-01-08 怎样用Github Pages建立博客（3。绘图/科学计算）
2017-01-08 怎样用Github Pages建立博客（2。进阶）
2017-01-07 怎样用Github Pages建立博客（1。入门） <<<<当前
提示：双击Ctrl或点击页面右下图标进行站内搜索; Esc退出搜索。双击CTRL或单击底部的图标在整个博客网站内搜索。ESC退出搜索。
本站已加入Google索引：site：（https://wklchris.github.io）该网站可通过Google搜索进行访问。
【目录】的ToC
点击以跳转
如果您使用的是低分辨率设备或通过狭窄的网页浏览器窗口查看，您可能看不到边栏。如果您的设备分辨率过低，或网页窗宽度过小，您可能看到到目录边栏。
本文基于Jekyll，搭建成功后，博文可以使用Markdown进行书写。初级使用者只需初步了解Github推送方法，无需html相关知识。
安装Ruby和dev-kit
前往Ruby站点下载Ruby，下载Ruby后，将页面下拉，下载符合版本要求的开发套件。在本文的测试中，环境是Windows 10 x64，Ruby版本2.3.3 x64，dev-kit版本DevKit-mingw64-64-4.7.2-20130224-1432-sfx。
安装Ruby;将dev-kit解压到指定目录即完成安装。
安装Jekyll和Bundle
请确保电脑的Internet连接正常。转到dev-kit目录，空白处Shift +鼠标右键呼出运行cmd，输入：
ruby dk.rb initruby dk.rb installgem install jekyllgem install bundle
下载和安装会自动进行。
初始化博客文件夹
以下初始化内容可以通过fork对应的主题仓库完成。
切换到username .github.io仓库所在本地文件夹，进行普通的初始化。使用bash命令输入（以我的博客为例）：
git initgit remote add originhttps://github.com/wklchris/wklchris.github.io.git
然后进行一系列的新建操作：
_includes文件夹
_layouts文件夹，内含default.html，留空。
_posts文件夹
_site文件夹
_config.yml文件，内容：
title: wklchris 的博客 - wklchris' blogauthor: wklchrisemail: wklchris AT hotmail DOT comdescription: > # this means to ignore newlines until "baseurl:"[页面右下角文字]baseurl: ""twitter_username: wklchrisgithub_username: wklchrisdefaults:-scope:path: "posts" # 空字符串所有的文件。这里指posts文件夹values:layout: "default"theme: minimapermalink: date # 这是指博客文章的网址格式# Build settingsmarkdown: kramdowntheme: minimaexclude:- Gemfile- Gemfile.lock
index.html文件：
layout: home
gemfile文件，内容（墙内可能需要改成http://ruby.taobao.org/）。其中第二行是我使用的主题，参考此页面。http ：// ruby 。淘宝。org /）。其中第二行是我使用的主题，参考
source "https://rubygems.org"gem "minima"
关于Github仓库，你还可能需要的文件有：
.gitignore文件：屏蔽_site和.sass-cache文件夹。
readme.md文件
写博文
在posts文件夹内新建一个Markdown文件，文件名形如：
1900-01-20-this-is-the-title.md
然后用Markdown进行书写即可。注意要加上文件头：
---layout: posttitle: 怎样用 Github Pages 来建立一个博客---
如果在文件头中不更改parmalink属性，那么该博文发布后的网址将是：
username.github.io/1900/01/20/this-is-the-title.html
添加评论区
注：该评论区在非生产环境（比如本地调试）下不能显示。
该模板针对Disqus专门做出了优化，只需要在_config.yml中添加：
disqus:shortname: my_disqus_shortname
即可。注意将你注册的Disqus账号对应博客网址的短id正确填写。
发布前的测试
仍然是仓库文件夹，在CMD命令下输入：
bundle installbundle exec jekyll serve
如果后续对_config.yml文件进行了修改，就需要执行第一行;否则只用执行第二行即可。
此时服务器会运行，可以你通过访问http://127.0.0.1:4000预览你的博客页面。
如果不想测试，可以直接：jekyll build之后，将本地git推送。
其他
如果在仓库目录下新建一个assets文件夹，内放main.scss的文件，即可对一些细节进行定义。
layout文件夹可以留空，但也可以从主题所在的Github仓库克隆。你也可以自定义新的布局。
对于iOS系统，需要改动_layouts / header.html。本条由Snowkylin指出。
换成：
其他具体的文件内容参考本博客的Github仓库，或者直接叉。
https://wklchris.github.io/How-to-build-a-Github-Pages-blog.html
网友评论