Gmeek Deploy

发表于

Gmeek Deploy

Gmeek 部署

内容来源

Gmeek 博客框架

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

一、资源

Gmeek

Markdown 语法

在线编辑工具

二、安装

创建仓库

启用 Pages

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

<img src="https://cdn.jsdelivr.net/gh/shenjuexiao/shenjuexiao@main/Github_png/Gmeek_Settings_Github-Pages_Github-Actions.png\“ />

开始写作

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

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

手动全局生成（修改 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，手动全局生成一次即可。

四、进阶