简体中文 | English | Русский

Gmeek

一个博客框架，超轻量级个人博客模板。完全基于Github Pages 、 Github Issues 和 Github Actions。

不需额外部署，从搭建到写作，只需要18秒，2步搭建好博客。

• Demo
• Gmeek版本
• Gmeek构建网站（基础篇）
• Gmeek构建网站（进阶篇）
• Gmeek构建网站（发布）

安装

1. 【创建仓库】点击通过模板创建仓库，建议仓库名称为XXX.github.io，其中XXX为你的github用户名。

2. 【启用Pages】在仓库的Settings中Pages->Build and deployment->Source下面选择Github Actions。

Note

在默认情况下，Github Actions是调用 Meekdai/Gmeek 远端程序 如想回避，可以将本驱动本体 Fork在自己帐下，只需修改 Github Action文件即可(.github/workflows/Gmeek.yml)

      - name: Clone source code
      run: |
        GMEEK_VERSION=$(jq -r ".GMEEK_VERSION" config.json)
        git clone https://github.com/Meekdai/Gmeek.git /opt/Gmeek;
        cd /opt/Gmeek/
        lastTag=$(git describe --tags `git rev-list --tags --max-count=1`)
        if [ $GMEEK_VERSION == 'last' ]; then git checkout $lastTag; else git checkout $GMEEK_VERSION; fi;

　　↓

      - name: Clone source code
      run: |
        GMEEK_VERSION=$(jq -r ".GMEEK_VERSION" config.json)
        git clone https://github.com/hst1189/Gmeek.git /opt/Gmeek;
        cd /opt/Gmeek/

　　　　※fork时如果没有clone tag，找不到tag会报错，将最后2行删除即可 （缺点：版本将无法选择，默认取得main下最新）

3. 【开始写作】打开一篇issue，开始写作，并且必须添加一个标签Label（至少添加一个），再保存issue后会自动创建博客内容，片刻后可通过https://XXX.github.io 访问（可进入Actions页面查看构建进度）。

4. 【手动全局生成】这个步骤只有在修改config.json文件或者出现奇怪问题的时候，通过Actions->build Gmeek->Run workflow->里面的按钮全局重新生成一次

提交问题

1. 如果有问题可参考Gmeek构建网站（基础篇）
2. 提交Issues咨询

特性

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

赞赏

鸣谢

• jinja2
• utteranc.es
• primer.style
• gitblog

License

请保留页面底部和console界面版权信息，谢谢！