Maverick搭建wiki站点

ZGGSONG

发布于 2022-09-09 10:08:08

1.3K0

发布于 2022-09-09 10:08:08

文章被收录于专栏：日志

前言

在日常学习过程中，知识细小琐碎，有时甚至只是一句话，却时常有很重要的学习意义，放在博客一方面日后查找起来不方便，另一方面就像风也 / KAYGB所说：小题大做了。既然是存储日常学习的琐碎知识，那么稳定就是重中之重了，所以Github就是首选了。

AlanDecode大佬的主题VOID非常好看，还开发了一系列的插件及工具，而这款静态博客生成器Maverick实际使用之后，感受十分良好，不过可能对新手不是那么友好，不像hexo等有非常丰富的新手教程，而针对~~~Maverick~~~(所有的程序)来说，仔细看源码能解决 99% 的问题。同时AlanDecode也开发了一个wiki主题Kpeler，在wiki系统里面个人认为是很漂亮 (qieshiyong) 的了。

搭建

Maverick是用的是git actions自动构建，这就很方便了，这就意味着你只需要完成一套git操作啥都不用做，网站就自动构建发布成功了，同时还集成了Jsdeliver，一键开启，填写发布页面的仓库名+分支名即可实现cdn加速（虽然偶有抽风

不过问题不大）

首先fork示例仓库,跟着README操作一遍就可以大体了解他的过程了，默认使用https://github.com/AlanDecode/Maverick-Theme-Galileo，适合作为个人博客站点，随后修改主题Kpeler及其他内容即可，生成个人wiki站点。

如果想要深入了解Maverick的原理过程，请查看 https://blog.imalan.cn/blog-now-powered-by-maverick

一些个人踩过的坑，总之就是看文档看文档看文档！

概念

Maverick只是一款静态网页生成器，需要搭配主题（默认自带一款博客主题）使用，生成的静态网站文件都在dist(或test_dist)下

python版本

python版本要高于3.5，而一般python都是2.7版本，所以需要使用python3，同理pip3。当然这只是对Maverick的一些说明

token

填写token时名字必须是PERSONAL_TOKEN（对，我就是那个不仔细看说明的人/ku）

发布至*.github.io

发布至*.github.io要求必须是发布至master分支，只需要修改仓库名为*.github.io并且修改.github/workflows/ci.yml中发布分支名为master即可

使用Jsdelivr

读文档！！！修改发布分支名，勿忘修改cdn分支名

site_prefix

默认：site_prefix = "/Blog-With-GitHub-Boilerplate/"
网站：//*.github.io/Blog-With-GitHub-Boilerplate/
修改1：site_prefix = "/"
网站：//*.github.io/
修改2：site_prefix = "/wiki/"
网站：//*.github.io/wiki/

成功

预览：https://wiki.zggsong.cn

后期部署至腾讯云开发，国内访问速度大大提升

部署腾讯云

由于腾讯云开发已经针对git action提供了扩展，直接使用即可: https://github.com/marketplace/actions/tencent-cloudbase-github-action

#只需要以下字符串
secret_Id
secret_Key
env_Id

获取API秘钥，访问https://console.cloud.tencent.com/cam/capi新建即可

控制台搜索进入云开发CloudBase新建一个开发环境复制env_Id

填写secret

配置action

腾讯云开发参考示例

将如下信息添加进.github/workflows/ci.yml末尾即可注意缩进

- name: Deploy static to Tencent CloudBase
  id: deployStatic
  uses: TencentCloudBase/cloudbase-action@v1.1.0
  env:
    PERSONAL_TOKEN: ${{ secrets.PERSONAL_TOKEN }}
    PUBLISH_BRANCH: gh-pages
    PUBLISH_DIR: ./dist
  with:
    secretId: ${{ secrets.SECRET_ID }}
    secretKey: ${{ secrets.SECRET_KEY }}
    envId: ${{ secrets.ENV_ID }}
    staticSrcPath: dist

等待action自动构建，完成后即可在腾讯云开发后台看到如下界面