前言
最近看到朋友 的模板個人博客界面相對于 小專欄、掘金 之類的博客社區更加清爽及定制化,也萌生了搭建屬于自己的個人博客,下面就記錄搭建博客的過程。
搭建一、申請 賬戶
如果想要基于 搭建個人博客主頁,首先需要有一個 賬戶,沒有的可以 點擊此處注冊 - your本地網站模板修改,注冊一個屬于自己的 賬戶。
如果已有 賬戶的可以選擇跳過此步驟。
二、新建個人博客庫項目
當登錄注冊的賬戶后,點擊此處 - a new 創建新項目。
三、配置創建完的項目
當成功創建項目后,點擊 -> Pages,當出現 Your site is ready to be at 類似的提示,即代表初始的創建配置成功了。
點擊對應的鏈接即可以訪問主頁了本地網站模板修改,只不過此時都是一片空白,主要是因為還沒有配置主題,可以選擇 a theme 按鈕選擇一個模板使用,也可以自己選擇相應的模板配置。
四、配置模板主題參考鏈接 - 官方主題模板參考鏈接 - 主題模板參考鏈接 - / 主題模板(推薦)
本人選擇的也是 / 主題模板,感覺界面很清爽(預覽界面),最主要是博主很熱誠,細心指導其中的一些細節問題。
可以根據 / - .md 文件中的 Fork 指南 搭建。
五、此處簡要概述一下搭建的過程中的注意點(參考:)
1、clone 項目到本地:
首先需要先將本項目 clone 到自己個人博客在電腦中 clone 的根目錄文件夾中,此時打開的話,會展示的是 的博客界面。
2、正確設置項目名稱與分支:
按照 Pages 的規定,名稱為 ..io 的項目的 分支,或者其它名稱的項目的 gh-pages 分支可以自動生成 Pages 頁面。
3、修改域名:
如果你需要綁定自己的域名,那么修改 CNAME 文件的內容;如果不需要綁定自己的域名,那么刪掉 CNAME 文件。
4、修改配置:
網站的配置基本都集中在 .yml 文件中,將其中與個人信息相關的部分替換成你自己的,比如網站的 url、title、 和第三方評論模塊的配置等。
評論模塊: 目前支持 、 和 ,選用其中一種就可以了,推薦使用 。它們各自的配置指南鏈接在 .yml 文件的 一節里都貼出來了。
注意: 如果使用 ,因為 處理用戶名與域名白名單的策略存在缺陷,請一定將 . 修改成你自己的,否則請將該字段留空。我對該缺陷的記錄見 #2。
5、刪除原作者的文章與圖片:
如下文件夾中除了 .md 文件外,都可以全部刪除,然后添加你自己的內容。
文件夾中是我已發布的博客文章。 文件夾中是我尚未發布的博客文章。_wiki 文件夾中是我已發布的 wiki 頁面。 文件夾中是我的文章和頁面里使用的圖片。
6、修改「關于」頁面:
pages/about.md 文件內容對應網站的 「關于」 頁面,里面的內容多為個人相關,將它們替換成你自己的信息,包括 _data 目錄下的 .yml 和 .yml 文件里的數據。
六、配置本地預覽功能
如果沒有配置本地預覽功能,需要每次修改后都要將對應的代碼提交到 后,有時界面沒有更新還需要刪除瀏覽器緩存才能預覽到新的界面。所以配置本地預覽功能就很有必要了。
本地預覽配置參考: up your Pages site with
注意: 因為本人是 Mac 電腦,所以是基于 Mac 環境配置的。
1、安裝
安裝 安裝 - - MacOS
① 安裝 Line Tools
$ xcode- --復制代碼
② 檢查 Ruby 版本號:
首先需要檢查 ruby 版本號,因為 對 ruby 有一定的要求。
Ruby 2.5.0 or above, all (ruby can be by ruby -v) (which you can check by gem -v)GCC and Make (in case your doesn’t have them , which you can check by gcc -v, g++ -v and make -v in your ’s line )
Ruby > 2.5.0. macOS 10.15 comes with ruby 2.6.3, so you’re fine. If you’re a macOS , you’ll have to a newer of Ruby.
③ 安裝更新 Ruby: