Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view

This file was deleted.

15 changes: 12 additions & 3 deletions 14/umbraco-cms/extending-backoffice/localization/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,15 +11,24 @@ Localization files are used to translate:
* The Umbraco backoffice user interface so that end users can use Umbraco in their native language. This is particularly important for content editors who do not speak English.
* The member identity errors in an Umbraco website enable end users to use Umbraco in the website language.

### [.NET Localization](net-localization.md)
You can also:

* Override existing language files.
* Include translations for your own package. Read [Add translations for your packages](../../extending-cms/packages/language-files-for-packages.md) to see how to you can achieve this.

## [.NET Localization](net-localization.md)

Defines how to use the .NET Core Umbraco Localization files.

### [UI Localization](ui-localization.md)
## [UI Localization](ui-localization.md)

Defines how to use the UI Umbraco Localization files.

## Supported Languages
{% hint style="info" %}
You can use localization files for Document and Media Types as well. You can find more information about this in the [Document Type Localization](../../fundamentals/data/defining-content/document-type-localization.md) article.
{% endhint %}

# Supported Languages

Current [languages](https://github.com/umbraco/Umbraco-CMS/tree/contrib/src/Umbraco.Core/EmbeddedResources/Lang) with their ISO codes that are included in new Umbraco installations are:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -28,6 +28,10 @@ If you want to override Umbraco Core translations or translations shipped with p
/config/lang/{language}.user.xml
```

{% hint style="info" %}
The `/config/lang/` folders do not exist on a clean installation of the CMS. You will need to create them at the root of your project. 
{% endhint %}

By default, these files are empty but you can add any new keys you want or override existing ones with your own translations. The nice part about the user files is that they will not get overwritten by the installer when you upgrade your Umbraco versions.

In order for these files to deploy when you do a `dotnet publish`, you need to add the following to your `.csproj` file:
Expand All @@ -51,7 +55,7 @@ public MyClass(ILocalizedTextService textservice)

### Package localization files

If you are a package developer, see the article for[ UI Localization](ui-localization.md).
If you are a package developer, see the article for[UI Localization](ui-localization.md).

## Help keep the language files up to date

Expand All @@ -70,7 +74,7 @@ The language files are XML files with a straight-forward layout as seen below.
<language alias="en" intName="English (UK)" localName="English (UK)" lcid="" culture="en-GB">
<creator>
<name>The Umbraco community</name>
<link>https://our.umbraco.com</link>
<link>https://community.umbraco.com</link>
</creator>
<area alias="actions">
<key alias="assignDomain">Culture and Hostnames</key>
Expand All @@ -88,7 +92,7 @@ In the above example of a missing translation for "**assignDomain**", locate thi
<language alias="es" intName="Spanish" localName="español" lcid="10" culture="es-ES">
<creator>
<name>The Umbraco community</name>
<link>https://our.umbraco.com</link>
<link>https://community.umbraco.com</link>
</creator>
<area alias="actions">
<key alias="assignDomain">Administrar hostnames</key>
Expand Down
201 changes: 0 additions & 201 deletions 14/umbraco-cms/extending-cms/language-files.md

This file was deleted.