跳到主要内容

用 Swift 构建静态网站:类型化路由能防住哪些坏链接?

· 阅读需 3 分钟
GoSwiftUI
goswiftui.com

改了页面路径,站内有多少链接会一起坏掉?Sindre Sorhus 把个人网站从 Astro 迁到 Swift 后,把一部分原本要等到浏览器里才能发现的错误提前到了编译阶段。这个案例最值得借鉴的,不一定是换语言,而是把不同的错误交给合适的检查。

本文是中文摘要解读,并非完整译文。

写法像 SwiftUI,交付的仍是网页​

Sindre 用 Elementary 在构建时生成 HTML,并在它之上实现自己的路由和样式层。组件可以写成带 body 的 Swift 结构体,样式也可以像修饰符一样附加到元素上。访客拿到的仍是 HTML、CSS 和少量 JavaScript:这里借的是 SwiftUI 的组件写法,并不是让 SwiftUI 在浏览器里运行。

编译器认识路由,不认识所有最终链接​

站内页面可以通过命名的路由成员引用,而不是在各处手写路径。比如应用列表用一个成员表示,引用了不存在的成员就会编译失败。不过,Markdown 里手写的链接、页面渲染出的锚点,并不会因为路由有类型就自动正确。为此,作者还校验生成 HTML 中的链接和页面 ID。一个步骤检查代码引用,另一个步骤检查访客实际拿到的产物。

本站建议:不换技术栈,也可以加这两道检查​

  • 先挑最常被引用的页面,例如下载页和帮助页,把路径集中到一处。修改路径时,同时检查旧链接是否需要保留重定向。
  • 部署前用生成后的 HTML 验证站内路径和锚点,不只查源文件。若产品页还展示最低系统版本,可把它作为单独的发布检查,与应用商店页面核对。作者也提到了这类不靠编译器就能发现的错配。

博文来源​