Skip to main content
View on GitHub

absLangURL

言語のプレフィックスがあれば、それを付けた絶対 URL を返します。

この機能は、単一言語構成と多言語構成の両方で使用してください。 この関数によって返される URL は、以下によって異なります。

  • 入力がスラッシュで始まるかどうか
  • サイト設定の baseURL の値
  • 言語プレフィックスがある場合は、その内容

以下の例では、プロジェクトは多言語であり、内容はスペイン語 (es) と英語 (en) の両方です。 デフォルトの言語はスペイン語です。 戻り値は英語サイトのものです。

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

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

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

{{ absLangURL "" }}           →   https://example.org/en/
{{ absLangURL "articles" }}   →   https://example.org/en/articles
{{ absLangURL "style.css" }}  →   https://example.org/en/style.css

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

{{ absLangURL "" }}           →   https://example.org/docs/en/
{{ absLangURL "articles" }}   →   https://example.org/docs/en/articles
{{ absLangURL "style.css" }}  →   https://example.org/docs/en/style.css

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

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

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

{{ absLangURL "/" }}          →   https://example.org/en/
{{ absLangURL "/articles" }}  →   https://example.org/en/articles
{{ absLangURL "/style.css" }} →   https://example.org/en/style.css

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

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