LanguagePrefix

Returns the URL language prefix, if any, for the given site.

Syntax

SITE.LanguagePrefix

Returns

string

Consider this site configuration:

defaultContentLanguage: de
defaultContentLanguageInSubdir: false
languages:
  de:
    languageCode: de-DE
    languageDirection: ltr
    languageName: Deutsch
    title: Projekt Dokumentation
    weight: 1
  en:
    languageCode: en-US
    languageDirection: ltr
    languageName: English
    title: Project Documentation
    weight: 2

defaultContentLanguage = 'de'
defaultContentLanguageInSubdir = false
[languages]
  [languages.de]
    languageCode = 'de-DE'
    languageDirection = 'ltr'
    languageName = 'Deutsch'
    title = 'Projekt Dokumentation'
    weight = 1
  [languages.en]
    languageCode = 'en-US'
    languageDirection = 'ltr'
    languageName = 'English'
    title = 'Project Documentation'
    weight = 2

{
   "defaultContentLanguage": "de",
   "defaultContentLanguageInSubdir": false,
   "languages": {
      "de": {
         "languageCode": "de-DE",
         "languageDirection": "ltr",
         "languageName": "Deutsch",
         "title": "Projekt Dokumentation",
         "weight": 1
      },
      "en": {
         "languageCode": "en-US",
         "languageDirection": "ltr",
         "languageName": "English",
         "title": "Project Documentation",
         "weight": 2
      }
   }
}

When visiting the German language site:

{{ .Site.LanguagePrefix }} → ""

When visiting the English language site:

{{ .Site.LanguagePrefix }} → /en

If you change defaultContentLanguageInSubdir to true, when visiting the German language site:

{{ .Site.LanguagePrefix }} → /de

You may use the LanguagePrefix method with both monolingual and multilingual sites.

Last updated: December 4, 2023 : Squashed 'docs/' changes from 4d936aee6..4dd2d6415 (35dec7c96)

Improve this page