Skip to main content

相対 URL を返します。

多言語設定では、代わりに relLangURL 関数を使用してください。 この関数によって返される URL は、以下によって異なります。

  • 入力がスラッシュで始まるかどうか
  • サイト設定の baseURL の値

入力がスラッシュで始まらない場合

入力がスラッシュで始まらない場合は、baseURL に関係なく、結果の URL は正しくなります。

baseURL = https://example.org/ の場合

{{ relURL "" }}           →   /
{{ relURL "articles" }}   →   /articles
{{ relURL "style.css" }}  →   /style.css

baseURL = https://example.org/docs/ の場合

{{ relURL "" }}           →   /docs/
{{ relURL "articles" }}   →   /docs/articles
{{ relURL "style.css" }}  →   /docs/style.css

入力がスラッシュで始まる場合

入力がスラッシュで始まる場合、 baseURL にサブディレクトリが含まれると、結果の URL が正しくなくなります。 先頭にスラッシュがある場合、この関数は baseURL の protocol+host セクションからの相対的な URL を返します。

baseURL = https://example.org/ の場合

{{ relURL "/" }}          →   /
{{ relURL "/articles" }}  →   /articles
{{ relURL "style.css" }}  →   /style.css

baseURL = https://example.org/docs/ の場合

{{ relURL "/" }}          →   /
{{ relURL "/articles" }}  →   /articles
{{ relURL "/style.css" }} →   /style.css
最後の 3 つの例は、ほとんどの場合において望ましいものではありません。ベストプラクティスとして、この関数を使うときは、絶対に先頭のスラッシュを含めないでください。