Open szwnba opened 1 month ago
Gmeek 一个博客框架,超轻量级个人博客模板,完全基于Github Pages 、 Github Issues 和 Github Actions,可以称作All in Github。不需要本地部署,从搭建到写作,只需要18秒,2步搭建好博客,第3步就是写作。
Github Pages
Github Issues
Github Actions
All in Github
Important
安装及其简单,但是也要认真看下面的步骤,一步一步来。
【创建仓库】点击通过模板创建仓库,建议仓库名称为XXX.github.io,其中XXX为你的github用户名。
XXX.github.io
XXX
【启用Pages】在仓库的设置Settings中Pages->Build and deployment->Source下面选择Github Actions。
Settings
Pages->Build and deployment->Source
【开始写作】打开一篇issue,开始写作,并且必须添加一个标签Label(至少添加一个),再保存issue后会自动创建博客内容,片刻后可通过https://XXX.github.io 访问(可进入Actions页面查看构建进度)。
标签Label
【手动全局生成】这个步骤只有在修改config.json 文件或者出现奇怪问题的时候,需要执行。
config.json
通过Actions->build Gmeek->Run workflow->里面的按钮全局重新生成一次
Tip
按照安装步骤成功搭建好后,就可以阅读下面的内容修改配置文件啦。 注意修改配置文件后一定要手动全局生成一次,不然会报错。 如果对json格式不熟悉,建议先简单学习一下。
json
config.json 文件就是配置文件,在创建的仓库内可以找到,对应修改为自己的即可。
{ "title":"Meekdai", "subTitle":"童话是一种生活态度,仅此而已。", "avatarUrl":"https://github.githubassets.com/favicons/favicon.svg", "GMEEK_VERSION":"last" }
以上是必须的字段,下面是可以自定义字段的描述,可以选择加入到config.json中。
"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":"", "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,
Caution
最后一行配置末尾不需要逗号,其他行末尾都需要逗号(英文逗号)
last
title
about
link
EN
CN
RU
manual
fix
pinyin
issue
ru_translit
sentence
多半是没有按照安装步骤来,其实搭建就这2步,不要自己乱点乱设置,就不会有问题。
修改了config.json配置文件后,需要全局生成。另外label标签没有打会出现这个问题。 建议通过Actions->build Gmeek->Run workflow->里面的按钮全局重新生成一次
label
如需修改发布时间,可以在文章最后一行添加如下代码。里面的时间是采用时间戳的形式,可以用如下网站转换。
<!-- ##{"timestamp":1490764800}## -->
style
script
<!-- ##{"style":"<style>#postBody{font-size:20px}</style>"}## -->
<!-- ##{"script":"<script async src='//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js'></script>"}## -->
<!-- ##{"script":"<script async src='//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js'></script>","style":"<style>#postBody{font-size:20px}</style>","timestamp":1490764800}## -->
在config.json文件中添加
"style":"<style>#postBody{font-size:20px}</style>", "script":"<script async src='//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js'></script>",
Pin issue
utteranc app
Error: utterances is not installed on xxx/xxx.github.io. If you own this repo, install the app. Read more about this change in the PR.
只需要Close issue或者Delete issue后,再手动全局生成一次即可。
Close issue
Delete issue
Gmeek的可定制化功能非常高,下面的链接是一些更加高级的设置教程,还有插件的使用等。 https://meekdai.github.io/tag.html#Gmeek
Gmeek 一个博客框架,超轻量级个人博客模板,完全基于
Github Pages
、Github Issues
和Github Actions
,可以称作All in Github
。不需要本地部署,从搭建到写作,只需要18秒,2步搭建好博客,第3步就是写作。一、安装
Important
安装及其简单,但是也要认真看下面的步骤,一步一步来。
【创建仓库】点击通过模板创建仓库,建议仓库名称为
XXX.github.io
,其中XXX
为你的github用户名。【启用Pages】在仓库的设置
Settings
中Pages->Build and deployment->Source
下面选择Github Actions
。【开始写作】打开一篇issue,开始写作,并且必须添加一个
标签Label
(至少添加一个),再保存issue后会自动创建博客内容,片刻后可通过https://XXX.github.io 访问(可进入Actions页面查看构建进度)。【手动全局生成】这个步骤只有在修改
config.json
文件或者出现奇怪问题的时候,需要执行。二、配置文件
Tip
按照安装步骤成功搭建好后,就可以阅读下面的内容修改配置文件啦。
注意修改配置文件后一定要手动全局生成一次,不然会报错。
如果对
json
格式不熟悉,建议先简单学习一下。config.json
文件就是配置文件,在创建的仓库内可以找到,对应修改为自己的即可。以上是必须的字段,下面是可以自定义字段的描述,可以选择加入到
config.json
中。Caution
最后一行配置末尾不需要逗号,其他行末尾都需要逗号(英文逗号)
last
也可以用具体tag版本title
一致则不用添加about
或者link
等about
和link
内置无需定义EN
/CN
/RU
manual
,也可选择fix
详细说明pinyin
/issue
/ru_translit
sentence
为第一句话,可配置其他特殊符号三、常见问题
1. 搭建不成功
多半是没有按照安装步骤来,其实搭建就这2步,不要自己乱点乱设置,就不会有问题。
2. Actions执行失败
修改了
config.json
配置文件后,需要全局生成。另外label
标签没有打会出现这个问题。建议通过Actions->build Gmeek->Run workflow->里面的按钮全局重新生成一次
3. 如果要导入以前的文章,如何设置发布时间呢?
如需修改发布时间,可以在文章最后一行添加如下代码。里面的时间是采用时间戳的形式,可以用如下网站转换。
4. 自定义单篇文章页面的
style
和script
5. 可同时一起添加多种自定义参数:
6. 添加全局文章页面的
style
和script
在
config.json
文件中添加7. 置顶博客文章,只需要
Pin issue
即可。8. 如果在评论里面登录后评论报错,可直接按照提示安装
utteranc app
即可9. 如何删除一篇文章呢?
只需要
Close issue
或者Delete issue
后,再手动全局生成一次即可。四、进阶教程
Gmeek的可定制化功能非常高,下面的链接是一些更加高级的设置教程,还有插件的使用等。
https://meekdai.github.io/tag.html#Gmeek