建站日志

• 文档维护：Obsidian（同步插件：Digital Garden）
• 网页代码：GitHub，部署：Vercel
• 评论系统：Twikoo，代码：MongoDB，部署：Vercel
• 域名&DNS解析：阿里云

技术

• 2025/10/9：试用Twikoo，很简洁的评论留言框，又解锁了新的代码部署。
• 2025/10/8：用Disqus评论做了评论栏，并把过去的留言导入，发现不翻墙无法访问，而且翻墙访问速度也很慢，弃。
• 2025/10/7：增加了全局页脚，增加上下的各种元素，要参考这里Adding custom components
• 2025/10/5：在front-matter中增加属性dg-permalink可以实现短网址，更新了大部分页面的链接，名字不能重复。
• 2025/9/30：绑定了域名 https://mysubi.com ，算是正式上线了！虽然完成度一般，还是希望总有个节点上线吧。
• 2025/9/5：测试一下Vercel部署速度，速度感人。几百个网页几秒钟就部署完成了。
• 2025/8/27：通读了Digital Garden的官方文件，了解了一下都可以实现啥，基本功能比较完整。
• 2025/8/26：解决了Vercal部署失败的问题。原来只要front-matter里有错误，网页就没办法部署上去。
• 2025/8/25：用Obsidian的Digital Garden插件，通过Vercel将网站部署在GitHub上推送成功！
• 2025/8/24：尝试一下Obsidian官方的Publish服务，速度超级快，但跟Quartz比是另一个极端，功能超级少，生成的网站起来像说明书，而且$10/月的价格确实不太美丽，弃。
• 2025/8/23：试用Obisidian的Quartz插件，结果也要Node.js，试用后觉得不够简单和直接，需要个人配置和学习的东西太多，弃。
• 2024/10：前期研究了Hexo和Hugo，需要Node.js，虽然已经折腾成功，但是离成品遥遥无期，后还是放弃。
• SEO优化（可以考虑用dg-metatags）

内容

• 2025/10/12：基本整理完了作家列表和主要内容。
• 2025/9/23：整理完读书记录页面和自2020年以来的已读书目。
• 2025/9/21：做好关于我的页面，还整理了网站历史，古早网站都需要的东西。
• 2025/9/14：规整了的读书报告页面，发现需要很多内容还需要整理。
• 2025/9/1：梳理了一遍图书页面的模版，顺便学会怎么用AI来编写DataviewJS。
• 2025/8/31：基本完成主页的内容，虽然只是草稿，但思路逐渐清晰了，这个方法的更新成本比传统建站方式真的低太多了，绝大部分时间都可以留给整理和创作。
• 2025/8/29：初步搭建了内容框架。发现与个人做笔记最大的不同是，网站每个子分类的导航页都需要一个单独页面，而笔记一般是用文件夹来实现类似的分类。

美化

• 2025/10/9：搞定了全局字体，选了霞鹜文楷屏幕阅读版，不过因为要先加载字体，初次访问速度有点慢。
• 2025/9/20：优化CSS代码，解决了手机访问栏宽太窄、网页访问sidebar太窄的问题。
• 2025/9/14：安装了Github Desktop试着修改源文件和CSS，程序突然简化了很多。
• 2025/8/28：主要尝试了Obsidian和Minimal和Blue Topaz的主题，加上Style Settings插件。但推送到网站时跟在软件中的显示仍有不少区别。暂时选用两个主题的混搭，居然出现了更神奇的效果。
• 设计logo及svg
• 做单独的网页固定头部
• 用卡片做导航页
• 卡片图式显示元素

经验

网站渲染

• 双链的双括号]]和半角括号(之间要加空格，否则链接会渲染失败，因为方括号和半角括号连接会被识别为其他的链接形式。
• 文件属性（YAML）中不能出现|字符，当然属性中最好也别加双链，否则部署会直接不成功（显示推送成功，Github中也有更新，但网页无法渲染）。
• 文件名中 汉字+"》"+汉字的组合会导致渲染失败。
• 在front-matter中增加属性dg-permalink实现短网址时，属性格式必须是文本，如果是数字等形式，会导致持续停留在计算推送的页面。批量转换该类格式，可以用linter插件的强制YAML转义的功能（Force YAML Escape），将数字属性加上""转换成文本格式。

CSS

• 增加@media (max-width: 600px)代码，解决手机访问栏宽太窄。
• 调整.sidebar 和.sidebar-container的宽度至300px以上，解决网页访问侧边栏太窄。
• 进一步调整侧边栏元素，需要修改site/_includes/components/文件夹里的sidebar.njk文件，需要做好备份。
• css日志中常见的/* 注释 */格式不能有一点变化。比如将注释结束符号写成了* /，而正确的写法是*/，空格使得注释关闭失败，导致后续代码无法正确解析，全站部署失败。

插件配置

• Slugify Note URL选项一定要关闭，否则如果文件路径中有中文字符会推送不成功。
• Custum Filter选项很好用，可以隐藏或替换相对应的内容，支持正则表达式，比如 ::: hidden (.*\n)*?:::，就是隐藏符号中间的内容：::: hidden 这里的内容会被隐藏 :::。
• 显示页面创建与修改时间要定义Timestamp settings里的字段从YAML属性中取，否则会取文件的创建和修改时间。
• 使用不同电脑每次都需要重复发布的bug，可能原因是：网页有任何不同都会造成重复发布。比如digital garden插件Appearance里页面创建日期的格式设置不一致（该设置obisidian无法同步），一台电脑认为应该显示为YYYY年MM月DD日，一台电脑认为应该显示为yyyy/m/d，这些都会被视为页面的改动。

_________