We read every piece of feedback, and take your input very seriously.
To see all available qualifiers, see our documentation.
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Gmeek 一个博客框架,超轻量级个人博客模板,完全基于Github Pages 、 Github Issues 和 Github Actions,可以称作All in Github。不需要本地部署,从搭建到写作,只需要18秒,2步搭建好博客,第3步就是写作。
Github Pages
Github Issues
Github Actions
All in Github
安装及其简单,但是也要认真看下面的步骤,一步一步来。
XXX.github.io
XXX
Settings
Pages->Build and deployment->Source
标签Label
config.json
通过Actions->build Gmeek->Run workflow->里面的按钮全局重新生成一次
按照安装步骤成功搭建好后,就可以阅读下面的内容修改配置文件啦。 注意修改配置文件后一定要手动全局生成一次,不然会报错。 如果对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号", "yearColorList":["#bc4c00", "#0969da", "#1f883d", "#A333D0"], "i18n":"CN", "UTC":8, "themeMode":"manual", "nightTheme":"dark_colorblind", "urlMode":"pinyin", "style":"", "script":"", "showPostSource":1, "bottomText":"转载请注明出处",
配置参数 说明 title 【必填】博客标题 subTitle 【必填】博客描述&自述 avatarUrl 【必填】博客头像 GMEEK_VERSION 【必填】Gmeek版本,一般写last也可以用具体tag版本 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 showPostSource 设置为1则在文章页显示issue链接按钮,设置为0则不显示 rssSplit 设置RSS输出的截断符号,默认sentence为第一句话,可配置其他特殊符号 bottomText 用于设置文章页面右下角显示的内容
last
title
about
link
EN
CN
RU
manual
fix
pinyin
issue
ru_translit
sentence
label
案例一:无法输出文章 Gmeek#1 案例二:能帮忙看下为什么action失败吗? Gmeek#10 3. 如果要导入以前的文章,如何设置发布时间呢? 如需修改发布时间,可以在文章最后一行添加如下代码。里面的时间是采用时间戳的形式,可以用如下网站转换。 <!-- ##{"timestamp":1490764800}## --> 4. 自定义单篇文章页面的style和script <!-- ##{"style":"<style>#postBody{font-size:20px}</style>"}## --> <!-- ##{"script":"<script async src='//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js'></script>"}## --> 5. 可同时一起添加多种自定义参数: <!-- ##{"script":"<script async src='//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js'></script>","style":"<style>#postBody{font-size:20px}</style>","timestamp":1490764800}## --> 6. 添加全局文章页面的style和script 在config.json文件中添加 "style":"<style>#postBody{font-size:20px}</style>", "script":"<script async src='//busuanzi.ibruce.info/busuanzi/2.3/busuanzi.pure.mini.js'></script>", 7. 置顶博客文章,只需要Pin issue即可。 8. 如果在评论里面登录后评论报错,可直接按照提示安装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. 9. 如何删除一篇文章呢? 只需要Close issue或者Delete issue后,再手动全局生成一次即可。 如何魔改 如果有朋友想修改博客的主题,或者添加一些东西,这个框架是支持魔改的。所有的UI都在templates文件中,可进行修改,如果合适,我会合并到主线,通过配置文件让用户选择哪个主题。
如需修改发布时间,可以在文章最后一行添加如下代码。里面的时间是采用时间戳的形式,可以用如下网站转换。
<!-- ##{"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
如果有朋友想修改博客的主题,或者添加一些东西,这个框架是支持魔改的。所有的UI都在templates文件中,可进行修改,如果合适,我会合并到主线,通过配置文件让用户选择哪个主题。
转自: https://blog.meekdai.com/post/Gmeek-kuai-su-shang-shou.html
The text was updated successfully, but these errors were encountered:
No branches or pull requests
Gmeek 一个博客框架,超轻量级个人博客模板,完全基于
Github Pages
、Github Issues
和Github Actions
,可以称作All in Github
。不需要本地部署,从搭建到写作,只需要18秒,2步搭建好博客,第3步就是写作。一、安装
XXX.github.io
,其中XXX
为你的github用户名。Settings
中Pages->Build and deployment->Source
下面选择Github Actions
。标签Label
(至少添加一个),再保存issue后会自动创建博客内容,片刻后可通过https://XXX.github.io 访问(可进入Actions页面查看构建进度)。config.json
文件或者出现奇怪问题的时候,需要执行。二、配置文件
config.json
文件就是配置文件,在创建的仓库内可以找到,对应修改为自己的即可。以上是必须的字段,下面是可以自定义字段的描述,可以选择加入到
config.json
中。配置参数 说明
title 【必填】博客标题
subTitle 【必填】博客描述&自述
avatarUrl 【必填】博客头像
GMEEK_VERSION 【必填】Gmeek版本,一般写
last
也可以用具体tag版本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
showPostSource 设置为1则在文章页显示issue链接按钮,设置为0则不显示
rssSplit 设置RSS输出的截断符号,默认
sentence
为第一句话,可配置其他特殊符号bottomText 用于设置文章页面右下角显示的内容
三、常见问题>> 修改了
config.json
配置文件后,需要全局生成。另外label
标签没有打会出现这个问题。 建议通过Actions->build Gmeek->Run workflow->里面的按钮全局重新生成一次转自:
https://blog.meekdai.com/post/Gmeek-kuai-su-shang-shou.html
The text was updated successfully, but these errors were encountered: