1 files changed, 44 insertions, 0 deletions
diff --git a/content/content/multilingual.md b/content/content/multilingual.md
new file mode 100644
index 0000000..cd697ff
--- /dev/null
+++ b/content/content/multilingual.md
@@ -0,0 +1,44 @@
++++
+title = "Multilingual sites"
+weight = 130
++++
+
+Zola supports having a site in multiple languages.
+
+## Configuration
+To get started, you will need to add the languages you want to support
+to your `config.toml`. For example:
+
+```toml
+languages = [
+    {code = "fr", feed = true}, # there will be a feed for French content
+    {code = "fr", search = true}, # there will be a Search Index for French content
+    {code = "it"}, # there won't be a feed for Italian content
+]
+```
+
+If you want to use per-language taxonomies, ensure you set the `lang` field in their
+configuration.
+
+Note: By default, Chinese and Japanese search indexing is not included. You can include
+the support by building `zola` using `cargo build --features search/indexing-ja search/indexing-zh`.
+Please also note that, enabling Chinese indexing will increase the binary size by approximately
+5 MB while enabling Japanese indexing will increase the binary size by approximately 70 MB 
+due to the incredibly large dictionaries.
+
+## Content
+Once the languages have been added, you can start to translate your content. Zola
+uses the filename to detect the language:
+
+- `content/an-article.md`: this will be the default language
+- `content/an-article.fr.md`: this will be in French
+
+If the language code in the filename does not correspond to one of the languages or
+the default language configured, an error will be shown.
+
+If your default language has an `_index.md` in a directory, you will need to add an `_index.{code}.md`
+file with the desired front-matter options as there is no language fallback.
+
+## Output
+Zola outputs the translated content with a base URL of `{base_url}/{code}/`.
+The only exception to this is if you are setting a translated page `path` directly in the front matter.