diff --git a/core/modules/language/language.module b/core/modules/language/language.module
index c616837..09c4b8d 100644
--- a/core/modules/language/language.module
+++ b/core/modules/language/language.module
@@ -22,13 +22,27 @@ function language_help($path, $arg) {
case 'admin/help#language':
$output = '';
$output .= '' . t('About') . '
';
- $output .= '' . t('The Language module allows you to maintain a list of languages used on your Drupal site for providing language information for content and for interface translation (using the Locale module). For more information, see the online handbook entry for Language module.', array('@language' => 'http://drupal.org/documentation/modules/language')) . '
';
+ $output .= '' . t('The Language module allows you to maintain a list of languages used on your site for content and interface elements. It provides language information to the Content Translation and Interface Translation modules. For more information, see the online documentation for the Language module.', array('!doc_url' => 'https://drupal.org/documentation/modules/language', '!content_translation' => \Drupal::url('help.page', array('name' => 'content_translation')), '!interface_translation' => \Drupal::url('help.page', array('name' => 'locale')))) . '
';
$output .= '' . t('Uses') . '
';
$output .= '';
- $output .= '- ' . t('Configuring the list of languages') . '
';
- $output .= '- ' . t('Configure the list of languages either using the built-in language list or providing any custom languages you wish.', array('@configure-languages' => url('admin/config/regional/language'))) . '
';
- $output .= '- ' . t('Configuring a multilingual site') . '
';
- $output .= '- ' . t("Language negotiation allows your site to automatically change language based on the domain or path used for each request. Users may (optionally) select their preferred language on their My account page, and your site can be configured to honor a web browser's preferred language settings. Site content can be translated using the Content Translation module.", array('@content-help' => url('admin/help/translation'))) . '
';
+ $output .= '- ' . t('Adding languages') . '
';
+ $output .= '- ' . t('You can add languages on the Languages List page by clicking on Add language and choosing a language from the drop-down menu. This language is then displayed in the Languages List, where it can be configured further. If the Interface Translation module is installed, then interface translation for this language is automatically downloaded as well.' , array('!language_list' => \Drupal::url('language.admin_overview'), '!interface' => \Drupal::url('help.page', array('name' => 'locale')))) . '
';
+ $output .= '- ' . t('Adding custom languages') . '
';
+ $output .= '- ' . t('You can add a language that is not provided in the drop-down list by choosing Custom language at the end of the list. You then have to configure its language code, name and direction in the form provided.') . '
';
+ $output .= '- ' . t('Customizing content languages settings') . '
';
+ $output .= '- ' . t('By default content is created in the site\'s default language and no language selector is displayed on the content creation pages. On the Content Language page you can customize the language settings for any supported content element of your site (for example for content types or user profiles). After choosing a content element, you are provided with a drop-down menu to set the default language and a tick box to display language selectors.', array('!content_language' => \Drupal::url('language.content_settings_page'))) . '
';
+ $output .= '- ' . t('Making blocks visible per language') . '
';
+ $output .= '- ' . t('The Language module adds an option to toggle the visibilty of a block based on selected languages when you configure a block on the Block layout page.', array('!blocks' => \Drupal::url('block.admin_display'))) . '
';
+ $output .= '- ' . t('Setting the default or fallback language') . '
';
+ $output .= '- ' . t('The default language for the site is set during the initial installation. It is not recommended to change this on a production site, but it is possible to do so at the Regional settings page. The better option is to select a language as fallback option on the Detection and selection page.', array('!detection' => \Drupal::url('language.negotiation'), '!regional' => \Drupal::url('system.regional_settings'))) . '
';
+ $output .= '- ' . t('Language detection and selection');
+ $output .= '
- ' . t('The Detection and Selection page provides several methods by which the site detects in which language to display interface text. Your can arrange the methods so that your prefered method is applied first, and a fallback option last.');
+ $output .= '
- ' . t('URL sets the interface language based on a path prefix or domain. (For example specifing de for German would result in URLs like example.com/de/contact.) The default language does not require a path prefix, but can have one assigned as well. If the language detection is done by domain name, a URL needs to be specified for each language. ') . '
';
+ $output .= '- ' . t('Session determines the interface language for a request or session parameter. (For example example.com?language=de would set the language to German based on the use of de within the language parameter.)') . '
';
+ $output .= '- ' . t('User follows the user\'s language settings as specified on the user\'s profile page.') . '
';
+ $output .= '- ' . t('Browser sets the interface language based on the browser\'s language settings. Since browsers use different language codes to refer to the same languages, you can add and edit languages codes to map the browser language codes to the language codes used on your site.', array('!language_list' => \Drupal::url('language.admin_overview'))) . '
';
+ $output .= '- ' . t('Account administration pages ') . '
';
+ $output .= '- ' . t('Selected language allows you to specify the site\'s default language or a specific language as fallback language. This method should be listed last.') . '
';
$output .= '
';
return $output;