Gmeek 部落格一鍵搭建教程#
type: 文章
status: 發布
date: 2024/10/20
slug: 2
summary: Gmeek 為個人部落格的創建和管理提供了一個簡潔、快捷且高效的解決方案。通過利用 GitHub 的強大功能，用戶無需擔心複雜的部署流程，只需專注於內容創作即可。如果你正在尋找一個輕量級且易於維護的部落格框架，Gmeek 無疑是一個值得嘗試的選擇。
tags: GitHub, 部落格，建站
category: 教程
專案地址https://github.com/Meekdai/Gmeek#
Gmeek 搭建教程#
Gmeek 是一個超輕量級的個人部落格框架，完全基於 GitHub Pages、GitHub Issues 和 GitHub Actions 構建。無需本地部署，從搭建到寫作僅需 18 秒 和 兩步，而 第三步 就可以開始寫作。
前言#
Gmeek 旨在為個人部落格提供一個簡潔、高效的解決方案。借助 GitHub 的強大功能，你無需擔心伺服器配置和維護，只需簡單幾步即可完成部落格的搭建與管理。Gmeek 利用了 GitHub Pages 進行靜態頁面托管，GitHub Issues 作為部落格文章的創作平台，GitHub Actions 自動化部署流程，使整個流程自動化、無縫銜接。
特點#
- 與 GitHub 同源的 UI 界面：採用 GitHub 原生 CSS（primer.style），界面風格與 GitHub 無縫銜接。
- 自動化部署：在 Issues 中完成部落格寫作後，自動觸發 GitHub Actions 執行部署任務。
- 評論系統：集成 utteranc.es 作為評論系統，輕量且易於使用。
- 可自定義主題：使用 Jinja2 對 HTML 進行渲染，支持通過模板自定義 UI 主題。
- 無需本地部署：所有操作均在 GitHub 上完成，簡化部署流程。
示例#
- 官方 Demo 頁面
- 我建立的
快速上手#
按照以下步驟，可以在 兩步，18 秒 內完成 Gmeek 部落格的搭建。
1. 創建倉庫#
-
通過模板創建倉庫：
- 點擊通過模板創建倉庫
-
命名倉庫：
- 推薦將倉庫命名為
YOUR_GITHUB_USERNAME.github.io，其中YOUR_GITHUB_USERNAME為你的 GitHub 用戶名。 - 示例：如果你的 GitHub 用戶名為
wanwuzhishi，則倉庫名稱應為wanwuzhishi.github.io。
- 推薦將倉庫命名為
-
完成倉庫創建：
- 點擊
Create repository完成倉庫的創建。
- 點擊
2. 啟用 GitHub Pages#
- 進入倉庫設置：
- 在新創建的倉庫頁面，點擊上方的
Settings標籤。
- 在新創建的倉庫頁面，點擊上方的
- 配置 Pages：
- 在左側菜單中，找到並點擊
Pages。 - 在
Build and deployment部分，設置Source為GitHub Actions。
- 在左側菜單中，找到並點擊
- 保存設置：
- 確認設置後，頁面會自動保存，並顯示部署狀態。
3. 開始寫作#
- 創建 Issue 文章：
- 進入倉庫的
Issues頁面，點擊New issue創建一篇新的文章。
- 進入倉庫的
- 添加標籤：
- 在創建 Issue 時，至少添加一個
Label（標籤），例如blog。
- 在創建 Issue 時，至少添加一個
- 保存 Issue：
- 完成內容撰寫後，點擊
Submit new issue提交。
- 完成內容撰寫後，點擊
- 自動生成部落格內容：
- 提交 Issue 後，GitHub Actions 會自動觸發構建流程。
- 片刻後，你的部落格內容將生成並部署到
https://YOUR_GITHUB_USERNAME.github.io。
- 查看構建進度：
- 可進入
Actions頁面查看構建的詳細進度和日誌。
- 可進入
4. 手動全局生成#
在以下情況下，需要手動全局生成部落格內容：
- 修改了
config.json文件。 - 出現了構建或顯示上的奇怪問題。
操作步驟：
- 進入 Actions 頁面：
- 在倉庫頁面，點擊上方的
Actions標籤。
- 在倉庫頁面，點擊上方的
- 找到 Build Gmeek 工作流：
- 在左側工作流列表中，選擇
build Gmeek。
- 在左側工作流列表中，選擇
- 運行工作流：
- 點擊
Run workflow按鈕，手動觸發一次全局重新生成。
- 點擊
提交問題#
如果在搭建或使用過程中遇到問題，可以參考以下步驟提交問題：
- 參考快速上手：
- 檢查是否按照快速上手中的步驟正確操作。
- 手動全局生成：
- 在提交問題之前，先手動全局生成一次，確保問題不在配置文件或構建流程中。
- 提交 Issue：
- 如果問題依舊存在，進入倉庫的
Issues頁面，點擊New issue提交你的問題描述。 - 提供盡可能詳細的信息，例如錯誤日誌、截圖等，以便更快定位問題。
- 如果問題依舊存在，進入倉庫的
- 協助解決：
- 提交後，專案維護者會協助查看構建流程，幫助定位和解決問題。
總結#
Gmeek 為個人部落格的創建和管理提供了一個簡潔、快捷且高效的解決方案。通過利用 GitHub 的強大功能，用戶無需擔心複雜的部署流程，只需專注於內容創作即可。如果你正在尋找一個輕量級且易於維護的部落格框架，Gmeek 無疑是一個值得嘗試的選擇。