diff --git a/core/modules/help_topics/help_topics/config_translation.overview.html.twig b/core/modules/help_topics/help_topics/config_translation.overview.html.twig new file mode 100644 index 000000000000..687951a1c78c --- /dev/null +++ b/core/modules/help_topics/help_topics/config_translation.overview.html.twig @@ -0,0 +1,19 @@ +--- +label: 'Translating configuration' +related: + - core.config_overview + - core.translations + - language.add +--- +{% set config_translation = render_var(url('config_translation.mapper_list'))%} +{% set config_overview = render_var(url('help.help_topic', {'id': 'core.config_overview'})) %} +{% set language_add = render_var(url('help.help_topic', {'id': 'language.add'})) %} +

{% trans %}Goal{% endtrans %}

+

{% trans %}Translate your site configuration to another language. See Adding a language if you need to add a new language.{% endtrans %}

+

{% trans %}Steps{% endtrans %}

+
    +
  1. {% trans %}In the Manage administrative menu, navigate to Configuration > Regional and language > Configuration translation.{% endtrans %}
    2. +
  2. {% trans %}Find either the configuration entity type or the simple configuration item that you want to translate in the Label column of the list. Click List under Operations for a configuration entity, or Translate for simple configuration. (See Managing and deploying configuration to learn more about types of configuration and configuration entities.){% endtrans %}
    3. +
  3. {% trans %}For configuration entities, find the specific entity that you want to translate on the next page, and click Translate under Operations.{% endtrans %}
    4. +
  4. {% trans %}Enter translations for the translatable text fields for the configuration item, and save.{% endtrans %}
    5. +
diff --git a/core/modules/help_topics/help_topics/content_translation.overview.html.twig b/core/modules/help_topics/help_topics/content_translation.overview.html.twig new file mode 100644 index 000000000000..ca37878143f3 --- /dev/null +++ b/core/modules/help_topics/help_topics/content_translation.overview.html.twig @@ -0,0 +1,19 @@ +--- +label: 'Configuring content language settings and translation' +related: + - core.translations + - language.add +--- +{% set translation_settings = render_var(url('language.content_settings_page')) %} +{% set entity_overview = render_var(url('help.help_topic', {'id': 'core.content_structure'})) %} +

{% trans %}Goal{% endtrans %}

+

{% trans %}Configure language and translation settings for one or more content entity types (see Managing content structure for an overview of content entities). To do this, you must have at least two languages configured. Afterwards, you will have a Translate operation available for your content entities, either as a tab or link when you are viewing or editing content, or on content administration pages.{% endtrans %}

+

{% trans %}Steps{% endtrans %}

+
    +
  1. {% trans %}In the Manage administrative menu, navigate to Configuration > Regional and language > Content language and translation.{% endtrans %}
    2. +
  2. {% trans %}Under Custom language settings, find the content entity types that should have customized language settings on your site. Check the box next to each one. A section will appear below the list with settings for that entity type.{% endtrans %}
    3. +
  3. {% trans %}For each entity type you checked, in the settings section below check the boxes for each entity sub-type that should be Translatable on your site. If the entity type does not have sub-types, there is just one check box for the entity type as a whole.{% endtrans %}
    4. +
  4. {% trans %}For each entity type or subtype, select the Default language. Also, if you want to have languages other than the default available when you create content, check Show language selector on create and edit pages.{% endtrans %}
    5. +
  5. {% trans %}For each Translatable type or sub-type, look through the list of fields for the type or sub-type, and verify that only the fields that should be translatable are checked. For example, you would probably want to translate a Title field, but you might not want to translate a Start date field.{% endtrans %}
    6. +
  6. {% trans %}Click Save configuration when all of your changes are complete.{% endtrans %}
    7. +
diff --git a/core/modules/help_topics/help_topics/core.translations.html.twig b/core/modules/help_topics/help_topics/core.translations.html.twig new file mode 100644 index 000000000000..9277de16599d --- /dev/null +++ b/core/modules/help_topics/help_topics/core.translations.html.twig @@ -0,0 +1,18 @@ +--- +label: 'Working with languages and translations' +top_level: true +related: + - block.place + - block.configure +--- +{% set config_overview = render_var(url('help.help_topic', {'id': 'core.config_overview'})) %} +{% set content_structure = render_var(url('help.help_topic', {'id': 'core.content_structure'})) %} +

{% trans %}What text can be translated in your site?{% endtrans %}

+

{% trans %}There are three types of text that can be translated:{% endtrans %}

+ +

{% trans %}Working with languages overview{% endtrans %}

+

{% trans %}The core Language module lets you add new languages to your site, provides the Language switcher block, and provides the ability to configure block visibility by language; the block and block visibility settings are only available if you have multiple languages configured. The core Content Translation, Configuration Translation, and Interface Translation modules let you translate content, configuration, and the built-in user interface, respectively. The core Update Manager module manages automatic downloads of community-provided translations of default configuration and user-interface text. See the related topics listed below for specific tasks.{% endtrans %}

diff --git a/core/modules/help_topics/help_topics/language.add.html.twig b/core/modules/help_topics/help_topics/language.add.html.twig new file mode 100644 index 000000000000..31940a7370e1 --- /dev/null +++ b/core/modules/help_topics/help_topics/language.add.html.twig @@ -0,0 +1,17 @@ +--- +label: 'Adding a language' +related: + - core.translations + - language.detect +--- +{% set languages_url = render_var(url('entity.configurable_language.collection')) %} +

{% trans %}Goal{% endtrans %}

+

{% trans %}Add a language to your site.{% endtrans %}

+

{% trans %}Steps{% endtrans %}

+
    +
  1. {% trans %}In the Manage administrative menu, navigate to Configuration > Regional and language > Languages.{% endtrans %}
    2. +
  2. {% trans %}Click Add language.{% endtrans %}
    3. +
  3. {% trans %}If your language is in the Language name list, select it and click Add language.{% endtrans %}
    4. +
  4. {% trans %}If your language is not in the list, select Custom language... and enter the Language code, Language name, and Direction for the language. Click Add custom language.{% endtrans %}
    5. +
  5. {% trans %}Wait for the translation system to be updated. Also, if you have the core Update Manager module installed and translations are available for your language, wait for translations to be downloaded. You should be returned to the Languages page when this completes.{% endtrans %}
    6. +
diff --git a/core/modules/help_topics/help_topics/language.detect.html.twig b/core/modules/help_topics/help_topics/language.detect.html.twig new file mode 100644 index 000000000000..02d435607cda --- /dev/null +++ b/core/modules/help_topics/help_topics/language.detect.html.twig @@ -0,0 +1,33 @@ +--- +label: 'Configuring language detection and selection' +related: +- core.translations +- language.add +--- +{% set detection = render_var(url('language.negotiation')) %} +

{% trans %}Goal{% endtrans %}

+

{% trans %}Configure the methods used to decide which language will be used to display text on your site.{% endtrans %}

+

{% trans %}What is a language detection method?{% endtrans %}

+

{% trans %}A language detection method is a way for your site to decide what language should be used to display text. This decision is made by evaluating a series of detection methods for languages; the first detection method that gets a result will determine which language is used. If you have more than one language on your site, you can configure the detection methods that are used and the order they are evaluated, for both user interface text and content text. Configuration text always uses the interface text method, and most sites use the same detection methods for all types of text.{% endtrans %}

+

{% trans %}What language detection methods are available?{% endtrans %}

+

{% trans %}The available detection methods depend on what modules you have installed. Some of the most commonly-used language detection methods are:{% endtrans %}

+
+
{% trans %}URL{% endtrans %}
+
{% trans %}Use the language from the URL, which can either be in a path prefix like example.com/fr/page_path for French (fr) language, or in a domain like fr.example.com/page_path.{% endtrans %}
+
{% trans %}User{% endtrans %}
+
{% trans %}For logged in users, use the language they have set in their profiles.{% endtrans %}
+
{% trans %}Browser{% endtrans %}
+
{% trans %}Use the language preferences from the user's browser.{% endtrans %}
+
{% trans %}Selected language{% endtrans %}
+
{% trans %}Use the language most recently selected from a Language switcher block.{% endtrans %}
+
{% trans %}Session{% endtrans %}
+
{% trans %}Use the language from a session parameter or a request parameter; for example, adding ?language=fr to the end of the URL.{% endtrans %}
+
+

{% trans %}Steps{% endtrans %}

+
    +
  1. {% trans %}In the Manage administrative menu, navigate to Configuration > Regional and language > Languages > Detection and selection.{% endtrans %}
    2. +
  2. {% trans %}Check the boxes to enable the desired language detection methods, and uncheck boxes for the methods you do not want to use.{% endtrans %}
    3. +
  3. {% trans %}Drag the methods to change their order, if desired.{% endtrans %}
    4. +
  4. {% trans %}Click Save settings.{% endtrans %}
    5. +
  5. {% trans %}Click Configure on each enabled detection method and verify that its configuration is correct (or update the configuration if not).{% endtrans %}
    6. +
diff --git a/core/modules/help_topics/help_topics/locale.import.html.twig b/core/modules/help_topics/help_topics/locale.import.html.twig new file mode 100644 index 000000000000..481f86f2f16d --- /dev/null +++ b/core/modules/help_topics/help_topics/locale.import.html.twig @@ -0,0 +1,16 @@ +--- +label: 'Importing a translation file' +related: +- core.translations +- locale.translation_status +- locale.translate_strings +--- +{% set import = render_var(url('locale.translate_import')) %} +

{% trans %}Goal{% endtrans %}

+

{% trans %}Import a file (.po extension) containing translations for user interface text.{% endtrans %}

+

{% trans %}Steps{% endtrans %}

+
    +
  1. {% trans %}In the Manage administrative menu, navigate to Configuration > Regional and language > User interface translation > Import.{% endtrans %}
    2. +
  2. {% trans %}Browse to find the Translation file you want to import. Select the language and check the desired import options.{% endtrans %}
    3. +
  3. {% trans %}Click Import and wait for your file to be imported.{% endtrans %}
    4. +
diff --git a/core/modules/help_topics/help_topics/locale.translate_strings.html.twig b/core/modules/help_topics/help_topics/locale.translate_strings.html.twig new file mode 100644 index 000000000000..8f4bde4a956b --- /dev/null +++ b/core/modules/help_topics/help_topics/locale.translate_strings.html.twig @@ -0,0 +1,18 @@ +--- +label: 'Translating user interface text' +related: + - core.translations + - locale.import + - locale.translation_status + - language.add +--- +{% set translate = render_var(url('locale.translate_page')) %} +

{% trans %}Goal{% endtrans %}

+

{% trans %}Translate user interface text strings from English into a non-English language that is configured on your site.{% endtrans %}

+

{% trans %}Steps{% endtrans %}

+
    +
  1. {% trans %}In the Manage administrative menu, navigate to Configuration > Regional and language > User interface translation.{% endtrans %}
    2. +
  2. {% trans %}Using the filters, search for a string or set of strings that you want to translate; make sure to select the correct Translation language if you have more than one non-English language on your site.{% endtrans %}
    3. +
  3. {% trans %}Enter new translations and click Save translations.{% endtrans %}
    4. +
  4. {% trans %}Repeat these steps until all of the desired user interface text is translated for all languages on your site.{% endtrans %}
    5. +
diff --git a/core/modules/help_topics/help_topics/locale.translation_status.html.twig b/core/modules/help_topics/help_topics/locale.translation_status.html.twig new file mode 100644 index 000000000000..c46fbc06b5fb --- /dev/null +++ b/core/modules/help_topics/help_topics/locale.translation_status.html.twig @@ -0,0 +1,19 @@ +--- +label: 'Checking interface translation status' +related: +- core.translations +- locale.import +- locale.translate_strings +--- +{% set language = render_var(url('entity.configurable_language.collection')) %} +{% set translation_updates = render_var(url('locale.translate_status')) %} +

{% trans %}Goal{% endtrans %}

+

{% trans %}Check the current status of interface translations, and see if there are any updates available.{% endtrans %}

+

{% trans %}Steps{% endtrans %}

+
    +
  1. {% trans %}In the Manage administrative menu, navigate to Configuration > Regional and language > Languages.{% endtrans %}
    2. +
  2. {% trans %}Look at the Interface translation column in the language table, to find the percentage of user interface text that has been translated for each language.{% endtrans %}
    3. +
  3. {% trans %}In the Manage administrative menu, navigate to Reports > Available translation updates. This report is only available if the core Update Status module is installed.{% endtrans %}
    4. +
  4. {% trans %}Optionally, click Check manually to update the report.{% endtrans %}
    5. +
  5. {% trans %}View the report to find out if any languages have translation updates that you can download.{% endtrans %}
    6. +