iT邦幫忙

2024 iThome 鐵人賽

DAY 15
0
Modern Web

新手友善園區-如何架設人生第一個網站系列 第 15

Day-15 使用 Hexo 與 GitHub Pages 部署你的靜態網站

  • 分享至 

  • xImage
  •  

在上一篇文章中,我們了解了如何使用 Hexo 生成靜態網站,並撰寫了第一篇文章。今天,我們將進一步介紹如何將這個靜態網站部署到 GitHub Pages,讓全球的使用者都可以訪問你的網站。
如果你想要快速建立一個靜態網站來展示你的個人作品、部落格文章或是簡單的個人簡歷,那麼 GitHub Pages 搭配 Hexo 是一個絕佳的選擇。這篇文章將帶你一步步了解如何使用這兩個工具,在短時間內打造出屬於你自己的網站。

什麼是 GitHub Pages?

GitHub Pages 是 GitHub 提供的一項免費服務,它允許你將靜態網站托管在 GitHub 上。簡單來說,GitHub Pages 就像是一個網站伺服器,它可以自動將你放在特定 GitHub Repository 中的 HTML、CSS 和 JavaScript 檔案轉變成一個網站。無需額外設置伺服器或購買主機,只要有一個 GitHub 帳號,你就能輕鬆架設網站。

適合的使用場景

GitHub Pages 非常適合個人作品集、部落格、小型專案展示等用途。它支援自訂域名,並且完全免費,這對於初學者和開發者來說都是一個絕佳的選擇。

Hexo 與靜態網站生成

Hexo 是一個快速、簡單的靜態網站生成器,它以 Node.js 為基礎,提供了極高的擴展性和豐富的插件系統。使用 Hexo,從撰寫 Markdown 格式的文章到自動生成 HTML 檔案都變得非常簡單。

1. 安裝環境

在開始之前,請確保你的電腦上已安裝以下工具:

  • Node.jsnpm:Hexo是基於 Node.js 的靜態網站生成器,所以需要安裝 Node.js 和 npm。

    • 你可以從Node.js 官網 下載並安裝。
    • 安裝完成後,在命令提示符(cmd)或 PowerShell 中輸入以下命令,確認 Node.js 和 npm 是否安裝成功:
      https://ithelp.ithome.com.tw/upload/images/20240928/20169341InFv8Qt02F.jpg

    https://ithelp.ithome.com.tw/upload/images/20240928/20169341Pk4Il1fwWI.jpg

  • Git:Git 是用來將你的網站部署到 GitHub Pages 的工具。

    • 你可以從Git 官網 下載並安裝。
    • 安裝完成後,檢查 Git 是否安裝成功:
      https://ithelp.ithome.com.tw/upload/images/20240928/20169341znUKuyrnRm.jpg

2. 安裝 Hexo

一旦環境準備好,你可以安裝 Hexo 來生成靜態網站。具體步驟如下:
(1) 安裝 Hexo CLI
在命令提示符(cmd)或 PowerShell 中運行以下命令來全域安裝 Hexo CLI:

npm install -g hexo-cli

https://ithelp.ithome.com.tw/upload/images/20240928/20169341elaEjrFN6g.jpg

(2) 初始化 Hexo 專案
安裝完成後,在你希望創建網站的目錄中,使用以下命令初始化一個新的 Hexo 專案:

hexo init my-website
cd my-website
npm install

這會創建一個名為 my-website 的文件夾,並下載所有必需的文件和依賴。
https://ithelp.ithome.com.tw/upload/images/20240928/20169341Cxk2HlWh6D.jpg

https://ithelp.ithome.com.tw/upload/images/20240928/20169341vBUqHZDVOF.jpg

https://ithelp.ithome.com.tw/upload/images/20240928/20169341rzYSLjvSNq.jpg
初始檔案長這樣

(3) 本地預覽網站
初始化完成後,你可以使用以下命令生成網站並啟動本地伺服器來預覽你的網站:

hexo generate

https://ithelp.ithome.com.tw/upload/images/20240928/20169341fJC3sXingD.jpg
使用以下指令啟動本地伺服器預覽網站:

hexo server

然後在瀏覽器中打開 http://localhost:4000,你將看到預設的 Hexo 網站。此時你已經成功在本地運行了 Hexo 靜態網站。
https://ithelp.ithome.com.tw/upload/images/20240928/20169341SrkoJoGoHD.jpg

3. 部署到 GitHub Pages

現在你已經有了一個本地的靜態網站,接下來的步驟是將其部署到 GitHub Pages。
(1) 創建 GitHub Repository

  1. 登入 GitHub 並創建一個新的 repository,建議命名為 <your-username>.github.io。這樣 GitHub 會自動將其設定為 GitHub Pages 網站。
    https://ithelp.ithome.com.tw/upload/images/20240928/20169341GmCXry9JvS.jpg

  2. 記下這個 repository 的 URL,如https://github.com/<your-username>/<your-repo>.git
    https://ithelp.ithome.com.tw/upload/images/20240928/20169341cr3EbH7DkJ.jpg

(2) 安裝 Hexo 部署插件
Hexo 提供了一個內建的 Git 部署功能,你需要安裝hexo-deployer-git插件:

npm install hexo-deployer-git --save

(3) 配置 Hexo 部署設置
打開專案根目錄下的 _config.yml 文件,找到 deploy 部分,並修改為以下內容:

deploy:
  type: git
  repo: https://github.com/<your-username>/<your-repo>.git
  branch: main

把從GitHub複製的網址貼在repo那邊
https://ithelp.ithome.com.tw/upload/images/20240928/201693413kHbRNlFPE.jpg

(4) 部署網站到 GitHub Pages
最後,運行以下命令來清理、生成並部署網站:

hexo clean
hexo generate
hexo deploy

這些命令會自動將生成的靜態網站推送到 GitHub 的main分支,並使其通過 GitHub Pages 上線。

4. 自訂域名(可選)

如果你想使用自訂域名而不是<your-username>.github.io,可以通過以下步驟來配置:

  1. 在 repository 的根目錄下創建一個名為CNAME的文件,內容是你自訂的域名(如 www.yourdomain.com)。
  2. 前往你的域名註冊商,將 DNS 設定中的A 記錄指向 GitHub Pages 的 IP 地址。

總結與實例展示

到這裡,你應該已經學會如何使用 Hexo 生成靜態網站並將其部署到 GitHub Pages 上。這個過程非常適合初學者,因為它結合了簡單的操作和強大的網站功能。如果你有興趣深入了解更多進階功能,不妨繼續探索 Hexo 的各種主題和插件,打造出屬於自己的個性化網站。

讓我們一起看一下完成的網站效果!如果你有任何問題,歡迎留言,我會盡力解答。


上一篇
Day-14 Hexo 的誕生與核心功能:打造簡單高效的靜態網站
下一篇
Day-16 使用 Hexo 與 GitHub Pages 部署你的靜態網站(實作)
系列文
新手友善園區-如何架設人生第一個網站30
圖片
  直播研討會
圖片
{{ item.channelVendor }} {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

尚未有邦友留言

立即登入留言