配置Github
這里我直接使用了GithubDesktop客戶端,安裝登錄之后關(guān)于SSH Key的部分會(huì)自動(dòng)完成,不過(guò)Git的帳號(hào)信息還是要設(shè)置一下:
$ git config --global user.name "你的名字"
$ git config --global user.email "your_email@youremail.com"
名字和郵箱替換成自己的,Github會(huì)用這些信息做相關(guān)權(quán)限的處理。
使用Github Pages 新建項(xiàng)目
在這步我折騰了好久,建立項(xiàng)目上傳之后,jayf4n.github.io一直顯示404,最后發(fā)現(xiàn)是弄成了依附于項(xiàng)目的pages。
登錄Github網(wǎng)站,點(diǎn)擊
+New repository
,項(xiàng)目名稱為username.github.io
,這里的username必須是Github賬號(hào)的用戶名。在Github Desktop 里將剛才的項(xiàng)目克隆到本地。打開(kāi) Git shell:
進(jìn)入項(xiàng)目目錄
cd username.github.io #進(jìn)入項(xiàng)目目錄
在本地的項(xiàng)目目錄里添加index.html文件
git add index.html #將index.html文件添加到暫存區(qū)
git commit -a -m "First pages commit" #將暫存區(qū)的修改提交到當(dāng)前分支
git push #將修改同步到Github
可以打開(kāi)username.github.io
開(kāi)下是否成功
套用Jekyll模板
下載模板,可以在客戶端里下載也可以在Git shell用
git clone https://github.com/beiyuu/Github-Pages-Example
命令。-
刪除之前的index.html文件,在Git shell里打開(kāi)
git rm index.html
git commit -m "delete first-pages"
將除了.git文件夾的所有內(nèi)容復(fù)制到自己的user.github.io文件夾內(nèi)。
修改模板,將里面關(guān)于社交資料的內(nèi)容改為自己的。刪除images和_posts文件夾里的內(nèi)容,原作者用的是本地圖片在Git里上傳,我自己在Markdwon鏈接的是七牛云存儲(chǔ)的圖床。
加入自己的文章,md文件命名格式為year-month-day-title.md,例如2016-03-06-github-pages.md,放到_posts文件夾里對(duì)應(yīng)的分類中。
YAML Front Matter和模板變量
對(duì)于使用YAML定義格式的文章,Jekyll會(huì)特別對(duì)待,他的格式要求比較嚴(yán)格,必須是這樣的形式:
---
layout: post
title: Blogging Like a Hacker
---
前后的---不能省略,在這之間,你可以定一些你需要的變量,layout就是調(diào)用_layouts下面的某一個(gè)模板,他還有一些其他的變量可以使用:
permalink
你可以對(duì)某一篇文章使用通用設(shè)置之外的永久鏈接
published
可以單獨(dú)設(shè)置某一篇文章是否需要發(fā)布
category
設(shè)置文章的分類
上面的title就是自定義的內(nèi)容,你也可以設(shè)置其他的內(nèi)容,在文章中可以通過(guò){ { page.title }}
這樣的形式調(diào)用。
還有其他需要的變量,可以參考官方的文檔
同步到Github pages
cd username.github.io #進(jìn)入目錄
git add . #添加修改到暫存區(qū)
git commit -m "add Beiyunn's theme" #添加修改到當(dāng)前分支
git push #將修改同步到Github
完成之后可以在瀏覽器里看下是否成功
主頁(yè)
文章
至此利用Github pages和Jekyll模板搭建個(gè)人博客已經(jīng)完成了,接下來(lái)就是不斷學(xué)習(xí)與完善了;_)
Git與Markdown教程
- Git教程推薦史上最淺顯易懂的Git教程!_廖雪峰
- Markdown請(qǐng)看Markdown 語(yǔ)法說(shuō)明 (簡(jiǎn)體中文版)
原文鏈接JayF4n'Blog