Issue #3307696 by _shY, smustgrave, Amber Himes Matz: Update breadcrumbs in...

Issue #3307696 by _shY, smustgrave, Amber Himes Matz: Update breadcrumbs in help, image, language, layout_builder, locale, media, and menu_ui help topics to use help_route_link function

(cherry picked from commit 818cdde3)

core/modules/help_topics/help_topics/help.help_topic_search.html.twig

@@ -6,20 +6,22 @@ related:
   - core.cron
   - search.overview
 ---
-{% set extend_url = render_var(url('system.modules_list')) %}
-{% set help_url = render_var(url('help.main')) %}
+{% set extend_link_text %}{% trans %}Extend{% endtrans %}{% endset %}
+{% set help_link_text %}{% trans %}Help{% endtrans %}{% endset %}
+{% set extend_link = render_var(help_route_link(extend_link_text, 'system.modules_list')) %}
+{% set help_link = render_var(help_route_link(help_link_text, 'help.main')) %}
 {% set cache_topic = render_var(help_topic_link('system.cache')) %}
 {% set cron_topic = render_var(help_topic_link('core.cron')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Set up your site so that users can search for help.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em><a href="{{ extend_url }}">Extend</a></em>. Verify that the Search, Help, Help Topics, and Block modules are installed (or install them if they are not already installed).{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>{{ extend_link }}</em>. Verify that the Search, Help, Help Topics, and Block modules are installed (or install them if they are not already installed).{% endtrans %}</li>
   <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Search and metadata</em> &gt; <em>Search pages</em>.{% endtrans %}</li>
   <li>{% trans %}Verify that a Help search page is listed in the <em>Search pages</em> section. If not, add a new page of type <em>Help</em>.{% endtrans %}</li>
   <li>{% trans %}Check the indexing status of the Help search page. If it is not fully indexed, see {{ cron_topic }} about how to run Cron until indexing is complete.{% endtrans %}</li>
   <li>{% trans %}In the future, you can click <em>Rebuild search index</em> on this page, or {{ cache_topic }}, in order to force help topic text to be reindexed for searching. This should be done whenever a module, theme, language, or string translation is updated.{% endtrans %}</li>
   <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <em>Block layout</em>.{% endtrans %}</li>
   <li>{% trans %}Click the link for your administrative theme (such as the core Claro theme), near the top of the page, and verify that there is already a search block for help located in the Help region. If not, follow the steps in the related topic to place the <em>Search form</em> block in the Help region. When configuring the block, choose <em>Help</em> as the search page, and in the <em>Pages</em> tab under <em>Visibility</em>, enter <em>/admin/help</em> to make the search form only visible on the main <em>Help</em> page.{% endtrans %}</li>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em><a href="{{ help_url }}">Help</a></em>. Verify that the search block is visible, and try a search.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>{{ help_link }}</em>. Verify that the search block is visible, and try a search.{% endtrans %}</li>
 </ol>

core/modules/help_topics/help_topics/image.style.html.twig

@@ -6,12 +6,13 @@ related:
   - layout_builder.overview
 ---
 {% set media_topic = render_var(help_topic_link('core.media')) %}
-{% set styles = render_var(url('entity.image_style.collection')) %}
+{% set styles_text %}{% trans %}Image styles{% endtrans %}{% endset %}
+{% set styles_link = render_var(help_route_link(styles_text, 'entity.image_style.collection')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Add a new image style, which can be used to process and display images. See {{ media_topic }} for an overview of image styles.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Media</em> &gt; <a href="{{ styles }}"><em>Image styles</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Media</em> &gt; {{ styles_link }}.{% endtrans %}</li>
   <li>{% trans %}Click <em>Add image style</em>.{% endtrans %}</li>
   <li>{% trans %}Enter a descriptive <em>Image style name</em>, and click <em>Create new style</em>.{% endtrans %}</li>
   <li>{% trans %}Under <em>Effect</em>, choose an effect to apply and click <em>Add</em>.{% endtrans %}</li>

core/modules/help_topics/help_topics/language.add.html.twig

@@ -4,12 +4,13 @@ related:
   - core.translations
   - language.detect
 ---
-{% set languages_url = render_var(url('entity.configurable_language.collection')) %}
+{% set languages_text %}{% trans %}Languages{% endtrans %}{% endset %}
+{% set languages_link = render_var(help_route_link(languages_text, 'entity.configurable_language.collection')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Add a language to your site.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Regional and language</em> &gt; <a href="{{ languages_url }}"><em>Languages</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Regional and language</em> &gt; {{ languages_link }}.{% endtrans %}</li>
   <li>{% trans %}Click <em>Add language</em>.{% endtrans %}</li>
   <li>{% trans %}If your language is in the <em>Language name</em> list, select it and click <em>Add language</em>.{% endtrans %}</li>
   <li>{% trans %}If your language is not in the list, select <em>Custom language...</em> and enter the <em>Language code</em>, <em>Language name</em>, and <em>Direction</em> for the language. Click <em>Add custom language</em>.{% endtrans %}</li>

core/modules/help_topics/help_topics/language.detect.html.twig

@@ -4,7 +4,8 @@ related:
 - core.translations
 - language.add
 ---
-{% set detection = render_var(url('language.negotiation')) %}
+{% set detection_text %}{% trans %}Detection and selection{% endtrans %}{% endset %}
+{% set detection_link = render_var(help_route_link(detection_text, 'language.negotiation')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Configure the methods used to decide which language will be used to display text on your site.{% endtrans %}</p>
 <h2>{% trans %}What is a language detection method?{% endtrans %}</h2>
@@ -25,7 +26,7 @@ related:
 </dl>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-    <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Regional and language</em> &gt; <em>Languages</em> &gt; <a href="{{ detection }}"><em>Detection and selection</em></a>.{% endtrans %}</li>
+    <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Regional and language</em> &gt; <em>Languages</em> &gt; {{ detection_link }}.{% endtrans %}</li>
     <li>{% trans %}Check the boxes to enable the desired language detection methods, and uncheck boxes for the methods you do not want to use.{% endtrans %}</li>
     <li>{% trans %}Drag the methods to change their order, if desired.{% endtrans %}</li>
     <li>{% trans %}Click <em>Save settings</em>.{% endtrans %}</li>

core/modules/help_topics/help_topics/layout_builder.overview.html.twig

@@ -6,7 +6,8 @@ related:
   - field_ui.manage_display
   - block.overview
 ---
-{% set content_types = render_var(url('entity.node_type.collection')) %}
+{% set content_types_text %}{% trans %}Content types{% endtrans %}{% endset %}
+{% set content_types_link = render_var(help_route_link(content_types_text, 'entity.node_type.collection')) %}
 {% set content_structure_topic = render_var(help_topic_link('core.content_structure')) %}
 {% set block_overview_topic = render_var(help_topic_link('block.overview')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
@@ -15,7 +16,7 @@ related:
 <p>{% trans %}A layout consists of one or more <em>sections</em>. Each section can have from one to four <em>columns</em>. You can place blocks, including special blocks for the fields on the entity sub-type, in each column of each section (see {{ block_overview_topic }} for more on blocks).{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}Navigate to the page for managing the entity type you want to add the field to. For example, to add a field to a content type, in the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <a href="{{ content_types }}"><em>Content types</em></a>.{% endtrans %}</li>
+  <li>{% trans %}Navigate to the page for managing the entity type you want to add the field to. For example, to add a field to a content type, in the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; {{ content_types_link }}.{% endtrans %}</li>
   <li>{% trans %}Find the particular sub-type that you want to create a layout for, and click <em>Manage display</em> in the <em>Operations</em> list.{% endtrans %}</li>
   <li>{% trans %}Under <em>Layout options</em>, check <em>Use Layout Builder</em>. You can also check the box below to allow each entity item to have its layout individually customized (if it is left unchecked, the site will use the same layout for all items of this entity sub-type).{% endtrans %}</li>
   <li>{% trans %}Click <em>Save</em>. You will be returned to the <em>Manage display</em> page, but you will no longer see the table of fields of the classic display manager.{% endtrans %}</li>

core/modules/help_topics/help_topics/locale.import.html.twig

@@ -5,12 +5,13 @@ related:
 - locale.translation_status
 - locale.translate_strings
 ---
-{% set import = render_var(url('locale.translate_import')) %}
+{% set import_text %}{% trans %}Import{% endtrans %}{% endset %}
+{% set import_link = render_var(help_route_link(import_text, 'locale.translate_import')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Import a file (.po extension) containing translations for user interface text.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Regional and language</em> &gt; <em>User interface translation</em> &gt; <a href="{{ import }}"><em>Import</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Regional and language</em> &gt; <em>User interface translation</em> &gt; {{ import_link }}.{% endtrans %}</li>
   <li>{% trans %}Browse to find the <em>Translation file</em> you want to import. Select the language and check the desired import options.{% endtrans %}</li>
   <li>{% trans %}Click <em>Import</em> and wait for your file to be imported.{% endtrans %}</li>
 </ol>

core/modules/help_topics/help_topics/locale.translate_strings.html.twig

@@ -6,12 +6,13 @@ related:
   - locale.translation_status
   - language.add
 ---
-{% set translate = render_var(url('locale.translate_page')) %}
+{% set translate_text %}{% trans %}User interface translation{% endtrans %}{% endset %}
+{% set translate_link = render_var(help_route_link(translate_text, 'locale.translate_page')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Translate user interface text strings from English into a non-English language that is configured on your site.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Regional and language</em> &gt; <a href="{{ translate }}"><em>User interface translation</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Regional and language</em> &gt; {{ translate_link }}.{% endtrans %}</li>
   <li>{% trans %}Using the filters, search for a string or set of strings that you want to translate; make sure to select the correct <em>Translation language</em> if you have more than one non-English language on your site.{% endtrans %}</li>
   <li>{% trans %}Enter new translations and click <em>Save translations</em>.{% endtrans %}</li>
   <li>{% trans %}Repeat these steps until all of the desired user interface text is translated for all languages on your site.{% endtrans %}</li>

core/modules/help_topics/help_topics/locale.translation_status.html.twig

@@ -5,15 +5,17 @@ related:
 - locale.import
 - locale.translate_strings
 ---
-{% set language = render_var(url('entity.configurable_language.collection')) %}
-{% set translation_updates = render_var(url('locale.translate_status')) %}
+{% set language_text %}{% trans %}Languages{% endtrans %}{% endset %}
+{% set translation_updates_text %}{% trans %}Available translation updates{% endtrans %}{% endset %}
+{% set language_link = render_var(help_route_link(language_text, 'entity.configurable_language.collection')) %}
+{% set translation_updates_link = render_var(help_route_link(translation_updates_text, 'locale.translate_status')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Check the current status of interface translations, and see if there are any updates available.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Regional and language</em> &gt; <a href="{{ language }}"><em>Languages</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Regional and language</em> &gt; {{ language_link }}.{% endtrans %}</li>
   <li>{% trans %}Look at the <em>Interface translation</em> column in the language table, to find the percentage of user interface text that has been translated for each language.{% endtrans %}</li>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Reports</em> &gt; <em><a href="{{ translation_updates }}">Available translation updates</a></em>. This report is only available if the core Update Status module is installed.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Reports</em> &gt; <em>{{ translation_updates_link }}</em>. This report is only available if the core Update Status module is installed.{% endtrans %}</li>
   <li>{% trans %}Optionally, click <em>Check manually</em> to update the report.{% endtrans %}</li>
   <li>{% trans %}View the report to find out if any languages have translation updates that you can download.{% endtrans %}</li>
 </ol>

core/modules/help_topics/help_topics/media.media_type.html.twig

@@ -7,12 +7,13 @@ related:
 ---
 {% set content_structure_topic = render_var(help_topic_link('core.content_structure')) %}
 {% set media_topic = render_var(help_topic_link('core.media')) %}
-{% set media = render_var(url('entity.media_type.collection')) %}
+{% set media_text %}{% trans %}Media types{% endtrans %}{% endset %}
+{% set media_link = render_var(help_route_link(media_text, 'entity.media_type.collection')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Add a new media type that can be referenced in Media reference fields; media types are a content entity type. See {{ media_topic }} for an overview of media items and media types, and {{ content_structure_topic }} for more information on content entities and fields.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <a href="{{ media }}"><em>Media types</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; {{ media_link }}.{% endtrans %}</li>
   <li>{% trans %}If there is not already a media type for the type of media you want to use on your site, click <em>Add media type</em>.{% endtrans %}</li>
   <li>{% trans %}Enter a <em>Name</em> and <em>Description</em> for your media type, and select the <em>Media source</em>.{% endtrans %}</li>
   <li>{% trans %}For most media sources, there is additional information that will need to be stored with your media item, in a field on your media type. Under <em>Media source configuration</em>, select an existing field to re-use to store this information, or select <em> - Create -</em> to create a new field.{% endtrans %}</li>

core/modules/help_topics/help_topics/menu_ui.content_type_configuration.html.twig

@@ -5,12 +5,13 @@ related:
   - menu_ui.menu_operations
   - core.menus
 ---
-{% set content_types = render_var(url('entity.node_type.collection')) %}
+{% set content_types_text %}{% trans %}Content types{% endtrans %}{% endset %}
+{% set content_types_link = render_var(help_route_link(content_types_text, 'entity.node_type.collection')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}For an existing content type, configure the available menus that will be shown as options on content editing screens; links to content items of this type can be added to these menus during editing.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <a href="{{ content_types }}"><em>Content types</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; {{ content_types_link }}.{% endtrans %}</li>
   <li>{% trans %}Locate the content type you want to configure, and click <em>Edit</em> in the <em>Operations</em> list.{% endtrans %}</li>
   <li>{% trans %}Under <em>Menu settings</em>, check the menus that you want to be available when editing a content item of this type.{% endtrans %}</li>
   <li>{% trans %}Optionally, select the <em>Default parent item</em>, to put links to content items under a default location in the menu structure.{% endtrans %}</li>

core/modules/help_topics/help_topics/menu_ui.menu_item_add.html.twig

@@ -5,12 +5,13 @@ related:
   - menu_ui.menu_operations
   - core.menus
 ---
-{% set structure_menu = render_var(url('entity.menu.collection')) %}
+{% set structure_menu_text %}{% trans %}Menus{% endtrans %}{% endset %}
+{% set structure_menu_link = render_var(help_route_link(structure_menu_text, 'entity.menu.collection')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Add a link to a menu. Note that you can also add a link to a menu from the content edit page if menu settings have been configured for the content type.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administration menu, navigate to <em>Structure</em> &gt; <a href="{{ structure_menu }}"><em>Menus</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administration menu, navigate to <em>Structure</em> &gt; {{ structure_menu_link }}.{% endtrans %}</li>
   <li>{% trans %}Locate the desired menu and click <em>Add link</em> in the <em>Operations</em> list.{% endtrans %}</li>
   <li>{% trans %}Enter the <em>Menu link title</em> to be displayed.{% endtrans %}</li>
   <li>{% trans %}Enter the <em>Link</em>, one of the following:{% endtrans %}
@@ -27,7 +28,7 @@ related:
   <li>{% trans %}Optionally, check <em>Show as expanded</em> to automatically show the children of this link (if any) when this link is shown.{% endtrans %}</li>
   <li>{% trans %}Optionally, select the <em>Parent link</em>, if this menu link should be a child of another menu link.{% endtrans %}</li>
   <li>{% trans %}Click <em>Save</em>. You will be returned to the <em>Add link</em> page to add another link.{% endtrans %}</li>
-  <li>{% trans %}In the <em>Manage</em> administration menu, navigate to <em>Structure</em> &gt; <a href="{{ structure_menu }}"><em>Menus</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administration menu, navigate to <em>Structure</em> &gt; {{ structure_menu_link }}.{% endtrans %}</li>
   <li>{% trans %}Locate the menu you just added a link to and click <em>Edit</em> in the <em>Operations</em> list.{% endtrans %}</li>
   <li>{% trans %}Verify that the order of links is correct. If it is not, drag menu links until the order is correct, and click <em>Save</em>.{% endtrans %}</li>
 </ol>

core/modules/help_topics/help_topics/menu_ui.menu_operations.html.twig

@@ -4,12 +4,13 @@ related:
   - menu_ui.content_type_configuration
   - core.menus
 ---
-{% set structure_menu = render_var(url('entity.menu.collection')) %}
+{% set structure_menu_text %}{% trans %}Menus{% endtrans %}{% endset %}
+{% set structure_menu_link = render_var(help_route_link(structure_menu_text, 'entity.menu.collection')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Create a new menu.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administration menu, navigate <em>Structure</em> &gt; <a href="{{ structure_menu }}"> <em>Menus</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administration menu, navigate <em>Structure</em> &gt; {{ structure_menu_link }}.{% endtrans %}</li>
   <li>{% trans %}Click <em>Add menu</em>.{% endtrans %}</li>
   <li>{% trans %}Enter the title for the menu, which is used as the default block title if the menu is displayed as a block. If desired, also edit the machine name of the menu, which is by default derived from the title.{% endtrans %}</li>
   <li>{% trans %}Enter an administrative summary, which is displayed on the <em>Menus</em> page.{% endtrans %}</li>

core/modules/help_topics/help_topics/menu_ui.overriding.html.twig

@@ -5,12 +5,13 @@ related:
   - menu_ui.menu_operations
   - core.menus
 ---
-{% set structure_menu = render_var(url('entity.menu.collection')) %}
+{% set structure_menu_text %}{% trans %}Menus{% endtrans %}{% endset %}
+{% set structure_menu_link = render_var(help_route_link(structure_menu_text, 'entity.menu.collection')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Disable menu links or change the order and hierarchy of menu links.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administration menu, navigate to <em>Structure</em> &gt; <a href="{{ structure_menu }}"><em>Menus</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administration menu, navigate to <em>Structure</em> &gt; {{ structure_menu_link }}.{% endtrans %}</li>
   <li>{% trans %}Click <em>Edit menu</em> for the menu that you want to edit.{% endtrans %}</li>
   <li>{% trans %}Drag menu links into a new order, or check/uncheck <em>Enabled</em> to enable or disable menu links.{% endtrans %}</li>
   <li>{% trans %}Click <em>Save</em> to save your changes.{% endtrans %}</li>