神觉晓

@shenjuexiao

神觉晓

发表于 更新于

Gmeek 部署

Gmeek Deploy

📖 内容来源

🌟 Gmeek 博客框架

  • 超轻量级个人博客模板
  • 完全基于 Github Pages 、 Github Issues 和 Github Actions，
  • 不需要本地部署

📦 一、资源

Gmeek

Markdown 语法

在线编辑工具

🛠️ 二、安装

创建仓库

启用 Pages

  • 仓库页面导航：Settings -> Pages -> Build and deployment
  • Source 下拉选择 Github Actions

Gmeek Settings Github-Pages GitHub-Actions

开始写作

  • 仓库页面导航：Issues -> New issue
  • Add a title（写标题），Add a description（写描述）。至少添加一个 Labels（标签），Create（创建）
  • 片刻后可通过<用户名>.github.io 访问
  • 仓库页面导航：Actions -> build Gmeek，可查看构建进度

Gmeek Settings Github-Pages GitHub-Actions

手动全局生成（修改 config.json 或按需要）

  • 仓库页面导航：Actions -> build Gmeek -> Run workflow

<img src="https://cdn.jsdelivr.net/gh/shenjuexiao/shenjuexiao@main/Github_png/Gmeek_Actions_build-Gmeek_Run-workflow.png\“ />

网友制作的视频教程：
https://www.bilibili.com/video/BV1GM4m1m7ZD/

⚙️ 三、配置

config.json 必要字段

1
2
3
4
5
6
{
    \"title\":\"Meekdai\",
    \"subTitle\":\"童话是一种生活态度，仅此而已。\",
    \"avatarUrl\":\"https://github.githubassets.com/favicons/favicon.svg\",
    \"GMEEK_VERSION\":\"last\"
}
配置参数 必填 说明
title 是 博客标题
subTitle 是 博客描述&自述
avatarUrl 是 博客头像
GMEEK_VERSION 是 Gmeek 版本，一般写 last 也可以用具体 tag 版本

config.json 其他字段

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
{
\"displayTitle\":\"Meekdai\",
\"homeUrl\":\"http://blog.meekdai.com\",
\"faviconUrl\":\"https://github.githubassets.com/favicons/favicon.svg\",
\"email\":\"meekdai@163.com\",
\"startSite\":\"02/16/2015\",
\"filingNum\":\"浙ICP备20023628号\",
\"onePageListNum\":15,
\"singlePage\":[\"about\"],
\"iconList\":{\"music\":\"M0 8a8 8 0 1 1 16 0A8 8 0 0 1 0 8Zm8-6.5a6.5 6.5 0 1 0 0 13 6.5 6.5 0 0 0 0-13Z\"},
\"exlink\":{\"music\":\"https://music.meekdai.com\"},
\"commentLabelColor\":\"#006b75\",
\"yearColorList\":[\"#bc4c00\", \"#0969da\", \"#1f883d\", \"#A333D0\"],
\"i18n\":\"CN\",
\"UTC\":8,
\"themeMode\":\"manual\",
\"dayTheme\":\"light\",
\"nightTheme\":\"dark_colorblind\",
\"urlMode\":\"pinyin\",
\"style\":\"\",
\"script\":\"\",
\"head\":\"\",
\"allHead\":\"\",
\"indexStyle\":\"\",
\"indexScript\":\"\",
\"showPostSource\":1,
\"rssSplit\":\"sentence\",
\"bottomText\":\"转载请注明出处\",
\"ogImage\":\"https://cdn.jsdelivr.net/gh/Meekdai/meekdai.github.io/logo64.jpg\",
\"primerCSS\":\"<link href='https://mirrors.sustech.edu.cn/cdnjs/ajax/libs/Primer/21.0.7/primer.css' rel='stylesheet' />\",
\"needComment\":0
}

最后一行配置末尾不需要逗号，其他行末尾都需要逗号（英文逗号）

配置参数 必填 说明
displayTitle 否 用于头像后面的标题展示，如果和 title 一致则不用添加
homeUrl 否 博客的主页地址，自定义域名时需要配置
faviconUrl 否 页面的 favicon 地址，如果和 avatarUrl 一致则不用添加
email 否 用于自动提交仓库时用，不添加也可以
startSite 否 用于页面底部显示网站运行天数
filingNum 否 用于页面底部显示备案信息
onePageListNum 否 用于首页每页展示的文章数量
singlePage 否 自定义独立页面，例如 about 或者 link 等
iconList 否 用于定义 singlePage 按钮展示的 SVG 图标 (16px)，about 和 link 内置无需定义
exlink 否 用于自定义首页右上角圆形按钮到外部链接功能，按钮图标定义在 iconList 中
commentLabelColor 否 用于自定义显示评论数量标签的颜色
yearColorList 否 用于自定义显示不同年份标签的颜色
i18n 否 用于定义博客语言，目前支持 EN/CN/RU
UTC 否 用于定义时区
themeMode 否 用于定义主题模式，默认为 manual，也可选择 fix 详细说明
dayTheme 否 用于定义亮主题
nightTheme 否 用于定义暗主题
urlMode 否 用于定义文章链接生成模式，目前支持 pinyin/issue/ru_translit
style 否 用于自定义文章页 CSS
script 否 用于自定义文章页 JavaScript
head 否 用于自定义文章页 head 内容
allHead 否 用于自定义所有页面 head 内容
indexStyle 否 用于自定义首页 CSS
indexScript 否 用于自定义首页 JavaScript
showPostSource 否 设置为 1 则在文章页显示 issue 链接按钮，设置为 0 则不显示
rssSplit 否 设置 RSS 输出的截断符号，默认 sentence 为第一句话，可配置其他特殊符号
bottomText 否 用于设置文章页面右下角显示的内容
ogImage 否 用于设置 Open Graph 协议展示的图片
primerCSS 否 用于设置 primer.css 的 CDN 地址，默认使用南科大
needComment 否 用于设置是否需要评论功能，1 开启评论，0 关闭

修改发布时间

1
<!-- ##{\"timestamp\":1490764800}## -->

自定义单篇文章页面的 style 和 script

1
2
<!-- ##{\"style\":\"<style>#postBody{font-size:20px}</style>\"}## -->
<!-- ##{\"script\":\"<script async src='//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js'></script>\"}## -->

多种自定义参数

1
<!-- ##{\"script\":\"<script async src='//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js'></script>\",\"style\":\"<style>#postBody{font-size:20px}</style>\",\"timestamp\":1490764800}## -->

自定义全局文章页面的 style 和 script，config.json 文件添加

1
2
\"style\":\"<style>#postBody{font-size:20px}</style>\",
\"script\":\"<script async src='//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js'></script>\",

置顶文章

Pin issue，手动全局生成一次即可。

删除文章

Close issue 或者 Delete issue，手动全局生成一次即可。

🚀 四、进阶

发表于 更新于

Github Issues 博客项目（不完全统计）

Github Issues Blog List

📖 内容来源

📦 @rena.to/github-blog

🚀 AllanChain/blog

🐹 babilema

⚡ ginb

🐍 gitblog

📜 gitblog

🧩 Gmeek

⚙️ Issue-Blog-With-Github-Action

🎨 qiwihui/blog

🐍 Sep0lkit/git-issues-blog

🖖 ttop5/issue-blog

🔌 whyour/issue-blog

🌐 xizhibei/blog

发表于 更新于

Github Issues Blog Gitblog

Github Issues Blog Gitblog

用过 Jekyll、Hexo，捣鼓了一阵子，都没能长期使用持续写作，现在转头使用 GIthub Issue 搭建的博客系统。后者有两个优点，一来省去了生成、部署的操作；二来解决了图床的需求。只要仓库存在，Issues 可以一直保留，改天也可以换个相似的博客系统。

📖 内容来源

📦 项目地址和安装指南

yihong0618/gitblog
这个博客开源了

🔧 安装方法

1. 克隆仓库

1
git clone git@github.com:yihong0618/gitblog.git

2. 生成tokens

个人首页，Settings -> Developer Settings -> Personal access tokens -> Tokens (classic) -> Generate New Tokens -> Generate new yokens (classic)

或直达链接：
settings/tokens

Gitblog Settings Developer Settings Personal access tokens

3. 仓库 actions

仓库首页，Settings -> Security and quality -> Secrets and variables -> Actions -> New repository secret

Gitblog Settings Security and quality Secrets and variables

直接使用 G_T，就不用修改文件： .github\\workflows\\generate_readme.yml 中的 ${{ secrets.G_T }} 字段。

1
2
3
- name: Generate new md
  run: |
    python main.py ${{ secrets.G_T }} ${{ github.repository }} --issue_number '${{ github.event.issue.number }}'

4. 修改generate_readme.yml

.github/workflows/generate_readme.yml
新版不需要。

❓ 其他问题

原作者后续更新了 *.yml 文件，有些参数不需要修改了。
后续更新补充。

发表于

Hello World 2026

Quick Start

Create a new post

1
$ hexo new \"My New Post\"

More info: Writing

Run server

1
$ hexo server

More info: Server

Generate static files

1
$ hexo generate

More info: Generating

Deploy to remote sites

1
$ hexo deploy

More info: Deployment

发表于

Hello World 2015

Welcome to Hexo! This is your very first post. Check documentation for more info. If you get any problems when using Hexo, you can find the answer in trobuleshooting or you can ask me on GitHub.

Quick Start

Create a new post

1
$ hexo new \"My New Post\"

More info: Writing

Run server

1
$ hexo server

More info: Server

Generate static files

1
$ hexo generate

More info: Generating

Deploy to remote sites

1
$ hexo deploy

More info: Deployment

0%