Github Pages + Jekyll 方案的優點:
· 免費
· 有版本管理,修改方便
· 支持markdown
缺點:
· 它生成的是靜態網頁,添加動態功能必須使用外部服務,比如評論功能要使用第三方服務(如disqus)。
· 它不適合大型網站,因為沒有用到數據庫,每運行一次都必須遍歷全部的文本文件,網站越大,生成時間越長。
步驟:
1.注冊Github
2.域名
1)去買域名
2)用Github pages提供的免費域名
http://{username}.github.io //用你的Github用戶名替換網址中的{username}`
后面有詳細說明。
3.安裝Git環境
現討論window環境的。這里可以下載:https://git-for-windows.github.io/
工作需要,這個是舊版的:
新版的圖標比較好看。
在打開的命令行窗口(Shell)內執行以下命令,設置你的git用戶名和郵箱:
$ git config --global user.name "{username}" // 用你的用戶名替換{username} $ git config --global user.email "{name@site.com}" // 用你的郵箱替換{name@site.com}
4.SSH配置
為了和Github的遠程倉庫進行傳輸,需要進行SSH加密設置。
在剛才打開的Shell內執行:
$ ssh-keygen -t rsa -C"{name@site.com}" // 用你的郵箱替換{name@site.com}
可以不輸入其他信息,一直敲回車直到命令完成。 這時你的用戶目錄(win7以上系統默認在C:\Users\你的計算機用戶名)內會出現名為 .ssh 的文件夾,點進去能看到 id_rsa 和 id_rsa.pub兩個文件,其中 id_rsa 是私鑰,不能讓怪人拿走, id_rsa.pub 是公鑰,無需保密。
接下來用你的瀏覽器登錄Github,點擊右上角的“Settings”:
用文字處理軟件打開剛才的 id_rsa.pub 文件,復制全部內容。
點擊“SSH and GPG Keys”,
點擊“New SSH Key”,將復制的內容粘貼在Key中,點“Add Key”確定。
5.創建項目
1)Fork(Git系統的創建分支,簡單來說是把當前倉庫復制一份到你的倉庫,你可以進行修改,因為你的倉庫是原來倉庫的新的分支)已有的開源博客倉庫,在巨人的肩膀上進行符合自我的創作(找個大神的作品自己改改)。
可以去這里挑:
https://github.com/jekyll/jekyll/wiki/sites
這個就挺好,知乎上看到的:https://github.com/Huxpro/huxpro.github.io
然后點fork:
去主頁里找到剛才fork的分支:
點擊“Settings”,將“Repository name”改為 {你的Github用戶名}.github.io,點擊“Rename”。
此時就可以通過 http://{你的Github用戶名}.github.io 訪問你fork下來的網站了。
2)自建
自建比較慢,以后討論。
6.寫東西
1)克隆
再次打開Git Bash,輸入以下命令切換到你想放置本地代碼倉庫的位置:
$ cd {本地路徑} // 比如:cd d:/hahah
或者隨便找個地方右鍵Git Bash。
clone(克隆)你自己的遠程倉庫:
$ git clone https://github.com/{username}/{username}.github.io.git // 用你的Github用戶名替換{username}
失敗的話可能是打錯了或者網不好,網不好的話可以找工具tiao牆,網慢就等一會:
2)寫博客
打開本地的 _posts 文件夾,你的所有博文都將放在這里,寫新博文只需要新建一個標准文件名的文件,在文件中編寫文章內容。 比如我們fork的模版中 _posts 文件夾里有一篇2014-01-29-hello-2015.markdown,你的文件命名也要嚴格遵循 年-月-日-文章標題.文檔格式 這樣的格式,注意月份和日期是兩位數。
推薦使用Markdown語言寫文章,windows下推薦MarkdownPad這個軟件編寫Markdown文本。
最開始寫可以直接模仿別人的博文語法,更多Markdown語法可參考 認識與入門Markdown。
3)修改和提交
當你使用Git Bash對你的本地倉庫進行操作時,先用 cd 命令將你的工作目錄設置到你要操作的本地倉庫
$ cd {你剛才clone下來的項目文件夾路徑}
每當你對本地倉庫里的文件進行了修改,只需在Bash中依次執行以下三個命令即可將修改同步到Github,刷新網站頁面就能看到修改后的網頁:
$ git add . $ git commit -m "statement" //此處statement填寫此次提交修改的內容,作為日后查閱 $ git push origin master
報錯的情況會單獨討論。
7.搭建本地環境
1).先安裝Ruby:
x64對應64位系統,挑一個順眼的。
記得勾選添加到環境變量PATH,忘了就卸載重安。
2).安裝 RubyGems
windows下下載ZIP格式較為方便,下好后解壓到本地任意路徑,下面以 {unzip-path} 代替你解壓的路徑。 打開windows的cmd終端(按win+R快捷鍵打開“運行”,輸入cmd,確定),輸入命令:
$ cd {unzip-path} //如果你沒有解壓在C盤,windows的終端切換到其他盤需要寫為 cd /d {unzip-path}$ ruby setup.rb
3).安裝Jekyll
在終端里輸入
$ gem install jekyll
4).安裝jekyll-paginate
在終端里輸入
$ gem install jekyll-paginate
如遇到以下錯誤,說明網絡不通:
ERROR: While executing gem ... (Gem::RemoteFetcher::FetchError)Errno::ECONNRESET: An existing connection was forcibly closed by the remote host.
其他錯誤度娘或google,忘了當時報的什么錯了。
8.開啟本地預覽
上一小節的安裝都完成以后,在終端中輸入命令
$ cd {local repository} // {local repository}替換成你的本地倉庫的目錄 $ jekyll serve
如果沒有報錯,在瀏覽器地址欄輸入 http://localhost:4000/ 回車就可以預覽了。不過 jekyll serve 服務需要一直開着。
摘取自:http://playingfingers.com/2016/03/26/build-a-blog/
擴展閱讀:
Github Pages
Git教程 - 廖雪峰
Jekyll中文文檔
認識與入門Markdown
Ruby和Gem
使用Github Pages建獨立博客
搭建一個免費的,無限流量的Blog—-github Pages和Jekyll入門