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 无疑是一个值得尝试的选择。