文档章节

URL 函数

用这些函数处理 URL。

这一页解决什么问题

这一章收录模板里处理 URL 的全部函数:把站内路径变成可用的地址、在绝对与相对之间切换、拼接片段、解析与编码、生成锚点与 slug、以及在页面之间做经过校验的链接。上游这些页原来只有签名和几行说明,本站为每页补上了「什么时候用 / 什么时候别用」「可直接粘贴的实测示例」与「返回值边界」。

读完本章你应该能够

建议阅读顺序

  1. 先分清「绝对 / 相对」与「是否带语言前缀」:urls.AbsURL、urls.RelURL、urls.AbsLangURL、urls.RelLangURL;
  2. 页面之间的链接(会校验目标):urls.Ref、urls.RelRef;
  3. 拼接与解析:urls.JoinPath、urls.Parse;
  4. 编码与清理:urls.PathEscape、urls.PathUnescape、urls.Anchorize、urls.URLize。

本站在这些页里反复强调一条经验:能交给 ref/relref 的页面链接,就不要手工拼路径——手工拼出来的地址不会在校验期报错,只会在线上 404。

本章内容

  • urls.AbsLangURL 返回带语言前缀(如果有)的绝对 URL。 (今天)
  • urls.AbsURL 返回绝对 URL。 (今天)
  • urls.Anchorize 返回给定字符串,并把它清理为可用于 HTML id 属性的形式。 (今天)
  • urls.JoinPath 把给定的元素拼接成一个 URL 字符串,并清理结果中的 ./ 与 ../ 元素;参数列表为空时返回空字符串。 (今天)
  • urls.Parse 解析给定 URL,返回一个 URL 结构体。 (今天)
  • urls.PathEscape 返回给定字符串,并对特殊字符与保留分隔符做百分号编码,使其可以安全地用作 URL 路径中的一个片段。 (今天)
  • urls.PathUnescape 返回给定字符串,并把所有百分号编码序列替换为对应的未转义字符。 (今天)
  • urls.Ref 返回具有给定路径、语言与输出格式的页面的绝对 URL。 (今天)
  • urls.RelLangURL 返回带语言前缀(如果有)的相对 URL。 (今天)
  • urls.RelRef 返回具有给定路径、语言与输出格式的页面的相对 URL。 (今天)
  • urls.RelURL 返回相对 URL。 (今天)
  • urls.URLize 返回给定字符串,并把它清理为可用于 URL 的形式。 (今天)