使用Github Page 搭建博客

Window推荐使用Msysgit,安装完毕直接使用命令行(bash)界面登入.注意msysgit和msys还是有区别的,例如前者~在我的文档.另外其原生的vim很弱(缺了很多插件)..可以去找官网的下载一些插件下来补充.
Ubuntu可以直接sudo apt-get install git
Mac我也忘了..
图形界面待补充…
更多Git命令介绍将在日后介绍

注册: 到github注册账户link
创建密钥: 使用ssh-keygen -t rsa -b 4096 -C "[email protected]" 来创建公有私有密钥,使用默认的地址,若不输入passphrase则可以跳过每次输入密码(建议passphrase为空).然后复制公钥~/.ssh/id_rsa.pub的内容,在github账号中Settings,SSH keys中黏贴该密钥. 更多ssh key产生和处理请参考github sshkey generation,中文ssh key 介绍
本地库: 创建一个文件夹如MyGit,mkdir MyGit, 然后进去git init创建空的本地库(加入.git文件夹), 若之前没有设置过,还需要git config --global user.name "yourname"以及git config --global user.email "[email protected]"来注册基本信息.

在Github创建新的RepositoryNew Repository. 在Github主页右下角一般显示了你当前库数量.
创建Project Name为name.github.com这里name随意,一般使用账号名.主页可不填. 项目不付费只能公开.随后Create Repository,页面给出提示,可忽略之.
Github可以提供一个<user-id>.github.io的主页给用户,可以将该主页和我们创建的主页用的库进行绑定.每个项目也可以使用项目主页,此时要新建一个分支gh-pages,此时项目的内容可以在<user-id>.github.io/<project-name>访问到. 更详细请参考建立主页
CNAME文件可以保存映射主页名.
更多关于使用Pages创建博客信息可以参考Github Pages,包括连接主页名,help等.

库地址: 在Github中,打开自己的主页项目如https://github.com/name/name.github.com,在右下clone URL处选择SSH并点图标进行复制
克隆库在本地需要放置网页的库(文件夹内),克隆远程项目到本地(这里使用ssh协议,所以请确保上述ssh key已正常可用).使用命令来克隆内容到本地(提示是否登录,yes).git clone [email protected]:name/name.github.com.git. 很长的地址直接用刚才复制的内容黏贴.
创别名(非必要): git remote add myhomepage [email protected]:name/name.github.com.git可以创建别名为myhomepage来代替之前复制那段地址, 可用git remote rm myhomepage来删除别名
说明文件(非必要): touch readme.md 创建库的说明文件,编辑内容可在github网页中看到.
主页文件: 可以自行将主页内容拉到此处,使用 index.html 作主页文件,可以创建或编辑该文件. 也可以使用github的自动生成器来生成个基础模板.
提交修改: 修改后,使用git add -A来将所有修改递交到本地暂存库,再用git commit -am "your comments"提交修改到本地库,然后用git push origin master将本地库更新提交到远程库, 这里origin可以用之前的myhomepage名替换.OK.
此时已经成功创建主页.简要使用git命令请参考Git简明指南,更详细的Git使用请参看GotGitHub
可以使用一些Jekyll的主页模板来快速设置你的主页啦! jekyll主页模板

安装Jekyll:首先需要使用gem,gem是ruby安装后配套产生的. 下载ruby 可以使用 gem update --system 来升级gem 在命令行中 gem install jekyll 进行安装
Github官方介绍使用; Jekyll中文官方介绍和英文介绍
配置文件: 修改_config.yml: 其中source和destination是源文件目录以及生成_site网页目录,markdown和highlighter定义语法高亮及着色使用的方法.
网页模板: _layout内的为网页模板,一般含有一个主界面一个博文的模板.
本地生成: 直接jekyll build 来生成本地的html文件. 其实只是做网页的话,可以不装jekyll.

---
layout: post
title: 使用Github搭建博客
date: 2015-06-02 11:06:56
category: Github
tags: Github
---

PS: 每项如layout和内容间要留空格!

layout:是使用的模板,在_layout文件夹内定义,这里用的是post.html
title:是文章显示的一级标题.但是网页地址显示的是文件的名不是这里.
date:是文章的发表日期时间,遵照我显示的格式,一般是"%Y-%m-%d %H:%M:%S".注意Jekyll计算时间是按GMT标准时间来计算的,否则博文显示时间会和博客设置的时区不同.
category或categories:文章分类,随意.
tags: 文章标签,可以用多个标签.
comment: true/false,可以相应开启/关闭评论.
GitHub 使用一种被称为“GitHub 风格的 Markdown 语法”（ GFM ）来书写版本注释、Issue 和评论。它和标准 Markdown 语法（SM）相比，存在一些值得注意的差异，并且增加了一些额外功能。默认GFM使用maruku,也可以用Jekyll来应用kramdown.(注意:kramdown的语法块使用~~~来代替---)以及rdiscount等.语法高亮可以用pygments.
避免产生bug和冲突.请阅读一些注意事项Page构建失败. 其中,例如避免两文章时间完全一致,避免文章中有语法错误(尤其markdown)等比较重要.

Hom's Blog