配置Github
这里我直接使用了GithubDesktop客户端，安装登录之后关于SSH Key的部分会自动完成，不过Git的帐号信息还是要设置一下：
$ git config --global user.name "你的名字"
$ git config --global user.email "your_email@youremail.com"
名字和邮箱替换成自己的，Github会用这些信息做相关权限的处理。
使用Github Pages 新建项目
在这步我折腾了好久，建立项目上传之后，jayf4n.github.io一直显示404，最后发现是弄成了依附于项目的pages。
-
登录Github网站，点击
+New repository，项目名称为username.github.io,这里的username必须是Github账号的用户名。 -
在Github Desktop 里将刚才的项目克隆到本地。打开 Git shell：
进入项目目录
cd username.github.io #进入项目目录
在本地的项目目录里添加index.html文件
git add index.html #将index.html文件添加到暂存区
git commit -a -m "First pages commit" #将暂存区的修改提交到当前分支
git push #将修改同步到Github
可以打开username.github.io开下是否成功
套用Jekyll模板
-
下载模板，可以在客户端里下载也可以在Git shell用
git clone https://github.com/beiyuu/Github-Pages-Example命令。 -
删除之前的index.html文件，在Git shell里打开
git rm index.html
git commit -m "delete first-pages"
将除了.git文件夹的所有内容复制到自己的user.github.io文件夹内。
-
修改模板，将里面关于社交资料的内容改为自己的。删除images和_posts文件夹里的内容,原作者用的是本地图片在Git里上传，我自己在Markdwon链接的是七牛云存储的图床。
-
加入自己的文章，md文件命名格式为year-month-day-title.md，例如2016-03-06-github-pages.md，放到_posts文件夹里对应的分类中。
YAML Front Matter和模板变量
对于使用YAML定义格式的文章，Jekyll会特别对待，他的格式要求比较严格，必须是这样的形式：
---
layout: post
title: Blogging Like a Hacker
---
前后的---不能省略，在这之间，你可以定一些你需要的变量，layout就是调用_layouts下面的某一个模板，他还有一些其他的变量可以使用：
permalink你可以对某一篇文章使用通用设置之外的永久链接
published可以单独设置某一篇文章是否需要发布
category设置文章的分类
上面的title就是自定义的内容，你也可以设置其他的内容，在文章中可以通过{ { page.title }}这样的形式调用。
还有其他需要的变量，可以参考官方的文档
同步到Github pages
cd username.github.io #进入目录
git add . #添加修改到暂存区
git commit -m "add Beiyunn's theme" #添加修改到当前分支
git push #将修改同步到Github
完成之后可以在浏览器里看下是否成功
主页
文章
至此利用Github pages和Jekyll模板搭建个人博客已经完成了，接下来就是不断学习与完善了;_)
Git与Markdown教程
- Git教程推荐史上最浅显易懂的Git教程！_廖雪峰
- Markdown请看Markdown 语法说明 (简体中文版)
原文链接JayF4n'Blog
网友评论