Hexo + Github Pages:手把手教你打造免費個人部落格

前言

在使用 Hexo 這個網誌框架之前,曾經使用過非常受歡迎的 WordPress 架站服務。

WordPress雖然是個很棒的內容管理系統(CMS),佈景主題很漂亮,但最大的缺點就是站體很容易過於龐大,如果是用免費的雲端伺服器的話網頁讀取速度可以說是非常慢,而且因為資料都在雲端伺服器,在備份和還原上稍微較麻煩。

而Hexo這個輕量級的網誌框架就解決了讀取速度這個對我來講最大的問題,而且剛好可以搭配 Github Pages 這個免費服務來進行網站搭建。

以下的教學是針對使用MacOS的人所寫的,如果是使用Windows系統的話步驟基本上一樣,只是指令的部分可能會有點差異,還請見諒。

Hexo介紹

Hexo是一個能夠產生靜態網站的網誌框架,相對於動態網站需要有一個資料庫,靜態網站的檔案存在電腦上,將來在轉移的時候也比較方便。

Hexo的一些優點

  • 超快的檔案產生速度,在幾秒內即可完成網誌產檔
  • 近300個外掛插件
  • 有200多個免費主題
  • Markdown支援

建立使用Hexo的環境

事前準備

在安裝Hexo前電腦需要先安裝下列兩套軟體。

如果還沒裝的話可以點擊上方超連結至官網安裝。

安裝Hexo

於終端機中透過 npm 安裝Hexo

$ npm install -g hexo-cli

建立部落格

輸入$ hexo init <部落格名稱>進行hexo的初始化,並在剛剛創建好的資料夾內安裝npm套件。

完整程式碼如下

$ hexo init blog #建立部落格
$ cd blog #載入資料夾
$ npm install #安裝npm套件

接著可以先啟動local端的server來看看一下自己的部落格長怎樣。

$ cd blog $ hexo server #啟動本地端server

看到自己的部落格後先不要感動落淚,我們先來介紹幾個比較重要的檔案。

Hexo 部落格完成

目錄結構

_config.yml

網站的配置檔案,可以設定網站標題、作者、作者大頭貼、網域…等,是非場重要的一個檔案。

source

原始檔案資料夾是放置內容的地方。裡面的_posts資料夾是存放文章的地方,之後要新產生的文章都會在這邊。

theme

放置主題的資料夾。

開始設定

網站基本設定

建立完網誌後,我們可以先打開_config.yml這的檔案來設定一些基本的內容。

title: 網站標題 subtitle: 網站副標題 description: 網站描述 keywords: 網站關鍵字 author: 作者名稱 language: zh-TW timezone: Asia/Taipei

語言預設是英文,也可以設定成zh-TW改成中文,時區預設是你電腦的時區,也可跟我一樣改成台灣的時區。

主題設置

本篇文章主要是以使用NexT這套簡潔且集合了許多第三方外掛的強大主題來做說明。

首先載入自己的網誌資料夾(本文章的教學範例是blog),並且將主題檔案從Github端上載下來到本地端。

$ cd blog $ git clone https://github.com/theme-next/hexo-theme-next themes/next #將next的主題資料從github載下來放在next資料夾裡

打開網站設定檔config.yml,將theme:landscape改成theme:next,新的主題就套用成功了!

現在我們來輸入hexo generate讓hexo產生靜態檔案,並且使用hexo server來啟動伺服器。

$ hexo generate #產生靜態檔案 $ hexo server

在瀏覽器中輸入 localhost:4000 ,可以看見新主題已經成功套用。

作者資訊設定

theme/next這個資料夾中打開主題的設定檔_config.yml,url設定如下。並在blog/source/uploads/images的資料夾中放入你想要的大頭照,並命名為avatar.jpg

avatar: url: /uploads/images/avatar.jpg

加入社群連結

在主題設定檔_config.yml,設定各社群媒體的連結,把前面的#字號去掉就是開啟該社群連結的意思。

social: #Google: https://plus.google.com/yourname || google #Twitter: https://twitter.com/yourname || twitter FB Page: https://www.facebook.com/larrynote || facebook

開始寫作

第一篇文章

前面講了這麼多終於要開始介紹怎麼寫文章囉!

首先一樣要透過終端機先進入自己的blog資料夾,再執行hexo new <文章名稱>,就會在路徑blog/source/_posts內創建一個文章名稱.md的檔案。

接下來就可以用文字編輯器打開文章名稱.md進行撰寫。

另外這邊建議在網站設定檔config.yml的中可以將post_asset_folder: false改成post_asset_folder: true,這樣之後在用hexo new創建新文章的時候會建立一個該文章的對應資料夾,可以在該資料夾中放入該文章圖片,這樣比較好方便管理。

文章設定

當你在打開文章檔案時,預設可以做以下設定。

— title: {{ title }} #文章標題,不用動它 date: {{ date }} #文章創建日期 tags: #標籤(多標籤寫法如下) – tag1 – tag2 —

可以在上方區塊中為文章加入更多詳細設置,例如文章分類、SEO會用到的關鍵字和敘述設定。

categories: #文章分類 keywords: #關鍵字(SEO用) decription: #文章敘述

這邊建議可以直接修改blog/scaffolds/post.md這個文章模板檔案,此檔案就是每次執行hexo new <文章名稱>指令時的會產生的文章模板。

加入「繼續閱讀」按鈕

在文章斷點處加入<!--more-->就可以囉!

例如以下程式碼就只會在首頁顯示”我是第一段”的文字,”我是第二段則是需要點「繼續閱讀」才會出現”

我是第一段 我是第二段

新增網站頁面

我們先來創建一個分類頁面,於終端機中輸入hexo new page categories這個指令。

blog/source/categories/ 路徑中找到index.md這個檔案,打開檔案,並增加頁面的type屬性。建議可以關閉頁面的評論功能(預設是開啟)

— title: categories date: 2019-03-19 12:12:12 type: “categories” comments: false —

打開主題設定檔config.yml,找到以下程式碼,把前方的categories的註解#給刪掉。

menu: home: / || home #about: /about/ || user #tags: /tags/ || tags categories: /categories/ || th archives: /archives/ || archive #schedule: /schedule/ || calendar #sitemap: /sitemap.xml || sitemap #commonweal: /404/ || heartbeat

將網站佈署至GitHub Pages

終於來到了要讓大家能看到你的部落格的階段,我在這裡選擇了免費又穩定的GitHub Pages這套服務。

GitHub Pages官方介紹

Websites for you and your projects, hosted directly from your GitHub repository. Just edit, push, and your changes are live.

使用Github創建一個名稱為<username>.github.io的專案,例如larryblog.github.io

執行npm install hexo-deployer-git —save這個外掛,讓Hexo可以執行指令部署至Github上。

在網站設定檔config.yml找到deploy並進行以下修改

deploy: type: git repo: https://github.com/skylovely2005/larrylai.github.io.git #新建專案的網址 branch: master #Github Pages的是以master這個分支作為顯示頁面

另外找到url並進行以下設定

url: https://username.github.io/ root: /repo.github.io/

假設我Github的帳號名稱為larry,並且剛剛創建了larryblog.github.io這個專案,那程式碼修改如下:

url: https://larry.github.io/ root: /larryblog.github.io/

現在執行hexo deploy指令,將網站部署到Github Pages上。

接下來就可以輸入到你的網站https://username.github.io/reop.github.io來看到你的網站囉!

例如https://larry.github.io/larryblog.github.io

實用外掛推薦

現在要來介紹幾個實用的外掛,大家可以參考斟酌要不要用,或是可以自己到官方的外掛列表來找到適合自己的外掛。

設置好外掛後,都需要先執行hexo generate來產生新的靜態檔案,然後再執行hexo server於本地端進行測試。

為部落格增加搜索功能

執行 npm install hexo-generator-search安裝外掛,並在主題設定檔config.yml中找到local_searchenable: false改成enable: true

local_search: enable: true

使用Disqus為文章加入留言功能

  1. 首先要到Disqus網站去申請一個帳號,並且新增一個「網站」。
  2. 到setting的General中找到該網站的Shortname並複製起來
  3. 回到主題設定檔config.yml中找到以下程式碼,並把剛剛複製好的貼在shortname後面。
disqus:
  enable: true #開啟功能
  shortname: https-username-web
  count: true #在文章中顯示評論數量
  lazyload: false #延遲載入功能
至disqus設定中找到shorname

加入Google Analytics紀錄網站流量

取得追蹤碼

Google Analytics中建立新帳戶,並至資源設定 -> 追蹤資訊 -> 追蹤程式碼,找到追蹤IDUA-123456789-1,並把他複製起來。

完成GA設置

於主題的設定檔config.yml中加入自己的tracking_id,建議將本地端的流量忽略掉,這樣在計算上比較準確

# Google Analytics
google_analytics:
  tracking_id: UA-123456789-1
  localhost_ignored: true

Google SEO優化

申請帳號,並使用GA驗證

先至Google Search Console將你的網站網址新增至資源中,由於剛剛加了Google Analytics至你的部落格中,所以驗證方法可以用Google Analytics帳戶來進行驗證。

提交sitemap

執行hexo-sitemap-generator安裝外掛。

在網站設置的config.yml中,新增路徑,讓sitemap可以順利提交。

sitemap: path: sitemap.xml

執行指令提交sitemap

hexo generate hexo deploy

回到Google Search Console內的索引 -> Sitemap中提交sitemap的網址(寫sitemap.xml)。
提交sitemap

接下來就等Google解析你的網址啦!通常過幾天後就能夠搜尋到自己的網站了。

全站訪客及文章閱讀人數統計

使用集合在NexT主題中的不蒜子計數套件即可。

打開主題的配置檔案config.yml,並且找到busuanzi_count,並輸入以下指令。

busuanzi_count: enable: true total_visitors: true total_visitors_icon: user total_views: true total_views_icon: eye post_views: true post_views_icon: eye

接下來一樣執行hexo generate後就可以看到部落格中已經添加了全站瀏覽數統計以及文章閱讀數統計了。

Hexo 常用指令

hexo generate #產生靜態檔案 hexo deploy #部署至github hexo server #啟動本地端server hexo new <文章名稱> #新增文章 hexo clean #清除現有的靜態檔案

總結

以上是使用Hexo這個網誌框架的教學,希望能夠幫助你們順利使用Hexo這套網誌框架,如果有任何關於hexo的問題或是更進階的使用技巧想要知道的話,歡迎在下方留言與我討論。

下一篇文章會在教大家如何綁定自己的網域,讓網站的網址變得比較漂亮。

參考資料

發表迴響

%d 位部落客按了讚: