主题不再走 git submodule:改成 npm 依赖后,克隆少一步
站点从建站起就用 git submodule 引主题,理由很实在:主题源码在独立仓库,站点不该再存一份。这套做法跑了两个月,昨天还是换掉了。 换完最直观的差别是这句话——克隆不用再带 --recurse-submodules。
10 篇文章
站点从建站起就用 git submodule 引主题,理由很实在:主题源码在独立仓库,站点不该再存一份。这套做法跑了两个月,昨天还是换掉了。 换完最直观的差别是这句话——克隆不用再带 --recurse-submodules。
v1.4.0 把导航栏做成了三级菜单,功能面基本齐了。所以这一版没加任何新东西——7 个提交里,1 个修 bug,4 个砍开销,1 个补文案,1 个发版。改动量也很小:12 个文件、+172 −39。 但那个唯一的 bug 挺值得写:它看起来像「按钮坏了」,实际是一行本该防重复的标记写成了永久生效。
之前写更新日志,都是「今天改了什么」的流水账。这次换个角度:把主题仓库里 tag 之间的提交全部拉出来,按版本重新读一遍,看看这五个版本到底在解决什么。 从 10-11 首版到 10-19 的 v1.4.0,一共 5 个版本、24 个提交,累计 49 个文件、+4212 −610 行。有意思的是,主线并不是「功能越堆越多」,而是一条不断把站点层补丁收回主题本体的线。
这两天的主线是和上游主题的一次往返:10-13 我在站点层临时规避的问题,10-14 就被上游收编成原生修复,补丁随之退役。同时新版本带来两个新能力,需要站点侧各补一行配置。
两项收尾工作:让文档侧栏的分组默认收起、点击再展开,并把 xongyi 文档重写成与 xfm 一致的分组结构。
这一轮做了两件事:把 xfm 文档收进主题子目录,以及补齐站点的订阅、编辑、评论能力。
导航栏从「首页 文档 归档 关于」扩展为信息架构更完整的 七项,并新增了「笔记」分区入口。
本站不再是一份纯粹的文档站,而是一个默认博客形态、按需在文档页切到三栏形态的站点。同时把此前手写的 xfm 文档替换为官方整理的完整文档集。
两处调整:站点名称确定为 「XFM开源官方文档」;同时把主题的引入方式从「内嵌源码」改为「git submodule 引用官方仓库」,让仓库不再携带主题源码。
从零搭建文档站的第一步:初始化 Hexo 站点、接入远程仓库、把主题配置为 docs 模式,再把两套主题的官方资料解析成结构化文档发布上线。