好不容易通过各种调休得来的5天小长假,大家都在思考如何规划时间。是选择去看看世界,回老家看看长辈,还是宅家好好休息几天?在这里,我要介绍一个适合宅家折腾的新东西——用Github白嫖一个独立个人博客。简单、轻量、自由度很高,你可以用它来记录自己学到的内容,也可以当做自己的日记本。

简介

Gmeek是一个博客框架,超轻量级个人博客模板。完全基于Github PagesGithub IssuesGithub Actions。不需要本地部署,从搭建到写作,只需要18秒,2步搭建好博客,第3步就是写作。

预览图

Demo

安装

  1. 【创建仓库】点击通过模板创建仓库,建议仓库名称为XXX.github.io,其中XXX为你的github用户名。
  2. 【启用Pages】在仓库的`Settings`中`Pages->Build and deployment->Source`下面选择`Github Actions`。
  3. 【开始写作】打开一篇issue,开始写作,并且**必须**添加一个`标签Label`(至少添加一个),再保存issue后会自动创建博客内容,片刻后可通过https://XXX.github.io 访问(可进入Actions页面查看构建进度)。

配置

通过下面的配置参数修改,你可以打造属于你自己的个人博客。甚至可以编写自己的CSS和JavaScript插入到页面中,实现一些个人独有的内容和样式。

配置参数说明
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),aboutlink内置无需定义
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用于设置文章页面右下角显示的内容

 

特性

  • UI界面和Github同源,只引入了Github原生CSS:primer.style
  • 博客写作在Issues中完成后,自动触发Actions执行部署任务
  • 评论系统引入utteranc.es
  • 使用jinja2对html进行渲染,可通过模板自定义UI主题

最后

无论选择何种方式度过假期,祝大家小长假过的开心~