🔗 编程指南的构建方式
🔗 数据
主要内容位于 https://github.com/squid-cache/programming-guide.github.io 这个 github 仓库中,并通过 github pages 发布,网址为 https://programming-guide.squid-cache.org/
这些页面是根据 squid 源码的每日更新自动生成的,通过一个 github 工作流。
squid 源码中的 doxyfile 未被使用,因为它严格绑定在嵌入 squid 主站的编程指南版本上。不幸的是,这意味着图形主题与 squid 站点不匹配。
为了保留链接和引用,通过 mod_rewrite 在 master.squid-cache.org.conf 中设置了 apache 重定向规则,以确保没有失效链接。
为了能够发布 github pages 站点,自动化流程需要依赖 PUSH_TOKEN 仓库 secret,该 secret 需要至少每年刷新一次。
🔗 过渡措施
squid 主站仍然包含完整的编程指南,并且它仍然根据源码每日更新。但它没有被提供服务,因为它被 github pages 的重定向所覆盖。一旦我们完全确信它不再需要,我们就可以移除 squid 源码中的生成逻辑、内容副本以及相关的配置文件。
导航:站点搜索,站点页面,分类,🔼 向上