建站

背景 调研了很多静态博客的评论系统： utterances Giscus(教程)，继承自utterances https://twikoo.js.org/ 评论系统(教程) Gittalk：利用issue直接作为博文 waline 已经装完了utterances，在整理资料的时候发现giscus好像更好：有中文+能回复，所以临时改成了giscus 前置准备 确定仓库：一般选择博客本身即可，比如这里我的 Beeta/beeta.github.io，要确保是公开的 安装giscus(选择上面的仓库) 启用Discussions功能 获取giscus配置 完成上述准备工作后就可以访问 giscus 官网 获取配置信息了 关注点： 仓库要写前面明确的仓库 页面和discussion的映射关系一般用第一个 分类选Announcements，因为这个类型的discussion只有管理员才有权限操作 做完上面的操作后，会在下面生成一个script配置文件： 配置到博客系统 复制上面的script代码段。添加到当前使用主题目录文件nw对应的位置。 我用的Papermod，路径在：themes/PaperMod/layouts/partials/comments.html 提交代码，就可以在博文最下面看到评论框了。

之前在平台上写博文，写完发布拉倒。现在自己建站，虽然自由了些，但牵扯到hugo、github提交和发布，麻烦了点，现在把流程规范和记录下来。 1. 创建博文目录 goblog # alias命令，cd到博客所在的git仓库 # 新建博文markdown # 规范：posts/年份/博文标题目录/index.md -》最中路径在content下 # 年份是便于分类，博文标题做目录是为了让图片和md文件在一块，标题用英文，在url上好看些，md文档的front matter 的title字段可定义中文标题 hugo new posts/2023/博文标题/index.md 2. 使用 wolai + typora 编辑md文件 使用wolai编辑正文，使用 typora 编辑front matter和查看图片引用是否正常 使用 wolai 编辑正文，然后以md格式导出，将该文件与上述index.md文件合并 使用 typora 打开文件并编辑： open -a typora content/posts/2023/博文标题/index.md 编辑front matter： 注意编辑标题、分类、tag等， draft 改为 false， slug 是博文 url 的最后字段，如果为空默认就用当前目录，slug会默认做转换：将所有字母转换为小写字母，「-」替换空格，删除所有特殊字符 另外，还要在typora中设置「图片复制到./assets文件夹」 3. 本地预览 写完后，可用以下命令预览，其中 -D 是显示草稿文章。 hugo server -D 4. 提交到github # 一般情况下 git add -A git cm -m "添加博文xx" git push origin master # 可能需要代理 提交后，会激活github action自动发布，稍后即可在 tubaozi....

一直想着建个自己的网站，顺便折腾点主题。前几天突发奇想注册了这个域名。顺手也把网站搭起来。调研了现在静态博客的情况，之前印象中的流行框架 HEXO 已然被 Hugo 盖住了风头。学习了下 Hugo，够简单，功能也够丰富。虽然网上 Hugo 搭建指南一大把，但我还是记录一下自己的使用过程，也作为第一篇正式博文。 你可以在这篇博客中了解到： Hugo 搭建静态博客方法 利用 github pages 托管网页 利用 github action 自动发布网页 一些建站过程中的 tips 安装Hugo Hugo的官网是https://gohugo.io/，另外有个中文文档网站https://gohugo.org/也可以参考。 官方推荐了很多安装方式，但我觉得直接下载二进制文件最为方便(升级需要手动)，Hugo有标准版、扩展版两个版本，扩展版支持对 WebP 图像进行编码和使用嵌入式 LibSass 转译器将 Sass 转译到 CSS，官方也推荐使用扩展版。 下载后，放到对应路径，添加到 PATH 环境变量，更方便使用。安装完后，使用以下命令进行验证： hugo version 使用Hugo 生成站点 即在指定路径下生成名为 sitename 的文件夹 hugo new site /path/to/sitename 站点目录结构： ▸ archetypes/ ▸ content/ ▸ layouts/ ▸ static/ config.toml 创建文章 在content文件夹下新建posts文件夹并新建xx.md文档 hugo new posts/xx.md 默认生成的 xx.md 内容和解释如下： title: "xx" # 网站显示的文章名字，可以与文件名不同 date: 2021-08-19T15:04:55+08:00 draft: true # 是否为草稿 # 下面两个默认没有，需要自己加 categories: ["互联网"] # 文章分类 tags: ["Hugo", "Github Pages", "Github Actions", "CI/CD"] # 文章标签 一般情况下，我们都要新建这些文件构建网站的骨架：...