mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-14 20:37:55 -05:00
da16527896
4c1309cdf Fix broken link to front matter page (#1923) 8181fff20 Add footnote to Quick Start guide for Win users (#1922) 4fd934f61 Fix abslangurl.md (#1919) bf2c45617 Quick start guide: fix broken links (#1915) 201b568df Update theme 874db199d Hide the news stripe on front page for now aaf59e3e2 netlify: Hugo 0.107.0 79654c301 Merge branch 'tempv107' 8345e0347 docs: Regen docs helper b5b4f15f9 Add assets directory to directory structure diagram (#1917) 76dd3a82a Follow-up: improve function signatures (#1914) (#1916) 656dc72ba Improving function signatures (#1914) b715e8407 Explain how to create multilingual content (#1912) 8500ee417 Fix typo in Quick Start guide ce60bb572 Add docu for undocumented functions (#1907) 372bf5e88 Improve Quick Start tutorial 71e81ec5f Remove asciicast from site 1e56c653f Update hosting-on-cloudflare-pages.md (#1903) 1686f60b1 Adding documentation page for function 'strings.FirstUpper' (#1901) d533f7c9c Fixing typos (#1900) 2563eee45 Update multilingual.md (#1899) 2173ed799 Update theme 5591b8875 Update urls.md (#1897) 4a88890b5 netlify: Hugo 0.106.0 512879fdd docs: Regen CLI docs f74b1d87d docs: Regenerate docs helper 9feacb48f Merge commit '00c4484c7092181729f6f470805bc7d72e8ad17b' git-subtree-dir: docs git-subtree-split: 4c1309cdfe9858434684352f9d544bf0c5c9d646
57 lines
1.5 KiB
Markdown
57 lines
1.5 KiB
Markdown
---
|
|
title: i18n
|
|
linktitle: i18n
|
|
description: Translates a piece of content based on your i18n configuration files.
|
|
date: 2017-02-01
|
|
publishdate: 2017-02-01
|
|
lastmod: 2017-02-01
|
|
categories: [functions]
|
|
menu:
|
|
docs:
|
|
parent: "functions"
|
|
keywords: [internationalization,i18n,multilingual]
|
|
signature:
|
|
- "i18n KEY"
|
|
- "T KEY"
|
|
- "lang.Translate KEY"
|
|
workson: []
|
|
hugoversion:
|
|
relatedfuncs: []
|
|
deprecated: false
|
|
aliases: []
|
|
---
|
|
|
|
This translates a piece of content based on your `i18n/en-US.toml` files. You can use the [go-i18n](https://github.com/nicksnyder/go-i18n) tools to manage your translations. The translations can exist in both the theme and at the root of your repository.
|
|
|
|
```
|
|
{{ i18n "translation_id" }}
|
|
```
|
|
|
|
{{% note "Alias `T`" %}}
|
|
`T` is an alias to `i18n`. E.g. `{{ T "translation_id" }}`.
|
|
{{% /note %}}
|
|
|
|
### Query a flexible translation with variables
|
|
|
|
Often you will want to use the page variables in the translation strings. To do so, pass the `.` context when calling `i18n`:
|
|
|
|
```
|
|
{{ i18n "wordCount" . }}
|
|
```
|
|
|
|
The function will pass the `.` context to the `"wordCount"` id:
|
|
|
|
{{< code-toggle file="i18n/en-US" >}}
|
|
[wordCount]
|
|
other = "This article has {{ .WordCount }} words."
|
|
{{< /code-toggle >}}
|
|
|
|
Assume `.WordCount` in the context has value is 101. The result will be:
|
|
|
|
```
|
|
This article has 101 words.
|
|
```
|
|
|
|
For more information about string translations, see [Translation of Strings in Multilingual Mode][multistrings].
|
|
|
|
[multistrings]: /content-management/multilingual/#translation-of-strings
|