MENU

Maverick搭建wiki站点

July 14, 2020 • Read: 507 • 建站

前言

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

图片来自作者博客

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

wiki

搭建

Maverick是用的是git action自动构建,这就很方便了,这就意味着你只需要完成一套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版本要高于3.5,而一般python都是2.7版本,所以需要使用python3,同理pip3。当然这只是对Maverick的一些说明
填写token时名字必须是PERSONAL_TOKEN(对,我就是那个不仔细看说明的人/ku)
发布至*.github.io要求必须是发布至master分支,只需要修改仓库名为*.github.io并且修改.github/workflows/ci.yml中发布分支名为master即可
读文档!!!修改发布分支名,勿忘修改cdn分支名
  • 默认: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

console

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

cloudbase

  • 填写secret

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自动构建,完成后即可在腾讯云开发后台看到如下界面

file

  • 最后在腾讯云开发绑定域名即可

自定义域名

部署至腾讯云开发参考 风也 / KAYGB-使用GitHub Action自动部署WIKI站点(Maverick)至腾讯云开发

那么这就需要在git pages和腾讯云之间选择一个,因为site_prefix的问题,若是/则可以成功部署在腾讯云开发,否则仅可在git pages上成功访问
wiki可以让我们细化添加我们以前记录的内容,方便查找再学习巩固,Tp2MD这款插件可以直接提取出typecho博客所有的md文件,方便整理与保存

本文作者:ZGGSONG
本文链接:https://www.zggsong.cn/archives/wiki.html
版权声明:本站所有未注明转载的文章均为原创,并采用CC BY-NV-SA 4.0授权协议,转载请注明来源

Archives Tip
QR Code for this page
Tipping QR Code
Leave a Comment

6 Comments
  1. LOGI LOGI     Windows 10 /    Google Chrome

    每篇文章都很用心@(大拇指)

    1. ZGGSONG ZGGSONG     Windows 10 /    Google Chrome

      @LOGI感谢老哥的肯定@(哈哈)

  2. 特厉害 特厉害     Windows 10 /    Google Chrome

    既然都是 Typecho 干嘛还要弄个新站?改下解析不就好了吗?@(疑问)

    1. ZGGSONG ZGGSONG     MacOS /    Google Chrome

      @特厉害静态站点

    2. 特厉害 特厉害     Windows 10 /    Google Chrome

      @ZGGSONG我看你 blog 和 www 都是 Typecho,从 blog 的“新站”链接过来的。

    3. ZGGSONG ZGGSONG     Android /    Google Chrome

      @特厉害原站点内容有点杂,并且主题做了很多修改,就不想动它#(观察)