Github pages + jekyll 博客快速搭建


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

  http://jekyllthemes.org/

  這個就挺好,知乎上看到的: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入門


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM