Issue #3307691 by smustgrave, asad_ahmed, Amber Himes Matz: Update breadcrumbs...

Issue #3307691 by smustgrave, asad_ahmed, Amber Himes Matz: Update breadcrumbs in ban, block, block_content, book, config, config_translation help topics to use help_route_link function

core/modules/help_topics/help_topics/ban.banning_ips.html.twig

@@ -3,12 +3,13 @@ label: 'Banning IP addresses'
 related:
   - user.overview
 ---
-{% set ban = render_var(url('ban.admin_page')) %}
+{% set ban_link_text %}{% trans %}IP address bans{% endtrans %}{% endset %}
+{% set ban_link = render_var(help_route_link(ban_link_text, 'ban.admin_page')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Ban visitors from one or more IP addresses from accessing and viewing 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>People</em> &gt; <a href="{{ ban }}"><em>IP address bans</em></a>{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>People</em> &gt; <em>{{ ban_link }}</em>{% endtrans %}</li>
   <li>{% trans %}Enter an <em>IP address</em> and click <em>Add</em>.{% endtrans %}</li>
   <li>{% trans %}You should see the IP address you entered listed under <em>Banned IP addresses</em>. Repeat the above steps to ban additional IP addresses.{% endtrans %}</li>
 </ol>

core/modules/help_topics/help_topics/block.configure.html.twig

@@ -4,12 +4,13 @@ related:
   - block.overview
   - core.ui_accessibility
 ---
-{% set layout_url = render_var(url('block.admin_display')) %}
+{% set layout_link_text %}{% trans %}Block layout{% endtrans %}{% endset %}
+{% set layout_link = render_var(help_route_link(layout_link_text, 'block.admin_display')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Configure the settings of a block that was previously placed in a region of a theme.{% 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="{{ layout_url }}"><em>Block layout</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <em>{{ layout_link }}</em>.{% endtrans %}</li>
   <li>{% trans %}Click the name of the theme that contains the block.{% endtrans %}</li>
   <li>{% trans %}Optionally, click <em>Demonstrate block regions</em> to see the regions of the theme.{% endtrans %}</li>
   <li>{% trans %}If you only want to change the region where a block is located, or the ordering of blocks within a region, drag blocks to their desired positions and click <em>Save blocks</em>.{% endtrans %}</li>

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

@@ -6,12 +6,13 @@ related:
   - block.place
   - block_content.type
 ---
-{% set content_url = render_var(url('entity.block_content.collection')) %}
+{% set library_link_text %}{% trans %}Custom block library{% endtrans %}{% endset %}
+{% set library_link = render_var(help_route_link(library_link_text, 'entity.block_content.collection')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Create a custom block, which can later be placed on the site.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <em>Block layout</em> &gt; <a href="{{ content_url }}"><em>Custom block library</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <em>Block layout</em> &gt; {{ library_link }}.{% endtrans %}</li>
   <li>{% trans %}Click  <em>Add custom block</em>. If you have more than one custom block type defined on your site, click the name of the type you want to create.{% endtrans %}</li>
   <li>{% trans %}Enter a description of your block (to be shown to administrators) and the body text for your block.{% endtrans %}</li>
   <li>{% trans %}Click <em>Save</em>.{% endtrans %}</li>

core/modules/help_topics/help_topics/block_content.type.html.twig

@@ -9,12 +9,13 @@ related:
   - field_ui.manage_form
   - field_ui.manage_display
 ---
-{% set types_url = render_var(url('entity.block_content_type.collection')) %}
+{% set types_link_text %}{% trans %}Block types{% endtrans %}{% endset %}
+{% set types_link = render_var(help_route_link(types_link_text, 'entity.block_content_type.collection')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Define a custom block type and its fields.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <em>Block layout</em> &gt; <em>Custom block library</em> &gt; <a href="{{ types_url }}"><em>Block types</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <em>Block layout</em> &gt; <em>Custom block library</em> &gt; <em>{{ types_link }}</em>.{% endtrans %}</li>
   <li>{% trans %}Click  <em>Add custom block type</em>.{% endtrans %}</li>
   <li>{% trans %}Enter a label for this block type (shown in the administrative interface). Optionally, edit the automatically-generated machine name or the description.{% endtrans %}</li>
   <li>{% trans %}Click <em>Save</em>. You will be returned to the <em>Block types</em> page.{% endtrans %}</li>

core/modules/help_topics/help_topics/book.adding.html.twig

@@ -6,13 +6,14 @@ related:
   - book.creating
   - book.organizing
 ---
-{% set node_add = render_var(url('node.add_page')) %}
+{% set node_add_link_text %}{% trans %}Add content{% endtrans %}{% endset %}
+{% set node_add_link = render_var(help_route_link(node_add_link_text, 'node.add_page')) %}
 {% set configuring_topic = render_var(help_topic_link('book.configuring')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Add a page to an existing book.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Content</em> &gt; <a href="{{ node_add }}"><em>Add content</em></a> &gt; <em>Book page</em>. If you have configured additional content types that can be added to books, you can substitute a different content type for <em>Book page</em>; see {{ configuring_topic }} for more information.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Content</em> &gt; <em>{{ node_add_link }}</em> &gt; <em>Book page</em>. If you have configured additional content types that can be added to books, you can substitute a different content type for <em>Book page</em>; see {{ configuring_topic }} for more information.{% endtrans %}</li>
   <li>{% trans %}Enter a title for the page and some text for the body of the page.{% endtrans %}</li>
   <li>{% trans %}In the vertical tabs area, click <em>Book Outline</em>. Select the book you want to add the page to in the <em>Book</em> select list. If you want to insert this page into the book hierarchy, also select the desired parent page in the <em>Parent item</em> select list.{% endtrans %}</li>
   <li>{% trans %}Select the desired weight for the page in the <em>Weight</em> select list (pages with the same parent item are ordered from lowest to highest weight).{% endtrans %}</li>

core/modules/help_topics/help_topics/book.configuring.html.twig

@@ -6,12 +6,13 @@ related:
   - book.creating
   - book.organizing
 ---
-{% set settings = render_var(url('book.settings')) %}
+{% set settings_link_text %}{% trans %}Settings{% endtrans %}{% endset %}
+{% set settings_link = render_var(help_route_link(settings_link_text, 'book.settings')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Configure settings related to books.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <em>Books</em> &gt; <a href="{{ settings }}"><em>Settings</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <em>Books</em> &gt; <em>{{ settings_link }}</em>.{% endtrans %}</li>
   <li>{% trans %}Check all of the content types that you would like to use as book pages in the <em>Content types allowed in book outlines</em> field.{% endtrans %}</li>
   <li>{% trans %}In the <em>Content type for the Add child page link</em> field, select the content type that will be created from the <em>Add child page</em> link on a book page.{% endtrans %}</li>
   <li>{% trans %}Click <em>Save configuration</em>.{% endtrans %}</li>

core/modules/help_topics/help_topics/book.organizing.html.twig

@@ -6,12 +6,13 @@ related:
   - book.creating
   - book.configuring
 ---
-{% set overview = render_var(url('book.admin')) %}
+{% set overview_link_text %}{% trans %}Books{% endtrans %}{% endset %}
+{% set overview_link = render_var(help_route_link(overview_link_text, 'book.admin')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Change the order and titles of pages within a book.{% 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="{{ overview }}"><em>Books</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> &gt; <em>{{ overview_link }}</em>.{% endtrans %}</li>
   <li>{% trans %}Click <em>Edit order and titles</em> for the book you would like to change.{% endtrans %}</li>
   <li>{% trans %}Drag the book pages to the desired order.{% endtrans %}</li>
   <li>{% trans %}If desired, enter new text for one or more of the page titles within the book.{% endtrans %}</li>

core/modules/help_topics/help_topics/config.export_full.html.twig

@@ -6,12 +6,13 @@ related:
 - config.export_single
 - config.import_single
 ---
-{% set export = render_var(url('config.export_full')) %}
+{% set export_link_text %}{% trans %}Export{% endtrans %}{% endset %}
+{% set export_link = render_var(help_route_link(export_link_text, 'config.export_full')) %}
 {% set config_overview_topic = render_var(help_topic_link('core.config_overview')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Create and download an archive containing all your site's configuration, exported as YAML files. See {{ config_overview_topic }} for more information about configuration.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Development</em> &gt; <em>Configuration synchronization</em> &gt; <a href="{{ export }}"><em>Export</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Development</em> &gt; <em>Configuration synchronization</em> &gt; <em>{{ export_link }}</em>.{% endtrans %}</li>
   <li>{% trans %}Click <em>Export</em> and save the archive file.{% endtrans %}</li>
 </ol>

core/modules/help_topics/help_topics/config.export_single.html.twig

@@ -6,13 +6,14 @@ related:
 - config.import_full
 - config.import_single
 ---
-{% set single_export = render_var(url('config.export_single')) %}
+{% set single_export_link_text %}{% trans %}Single item{% endtrans %}{% endset %}
+{% set single_export_link = render_var(help_route_link(single_export_link_text, 'config.export_single')) %}
 {% set config_overview_topic = render_var(help_topic_link('core.config_overview')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Export a single configuration item to a file. See {{ config_overview_topic }} for more information about configuration.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Development</em> &gt; <em>Configuration synchronization</em> &gt; <em>Export</em> &gt; <em><a href="{{ single_export }}">Single item</a></em>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Development</em> &gt; <em>Configuration synchronization</em> &gt; <em>Export</em> &gt; <em>{{ single_export_link }}</em>.{% endtrans %}</li>
   <li>{% trans %}Select the <em>Configuration type</em> that you want to export, and then select the specific <em>Configuration name</em> to export.{% endtrans %}</li>
   <li>{% trans %}Use your browser to copy the text in the box marked <em>Here is your configuration</em> to the clipboard.{% endtrans %}</li>
   <li>{% trans %}Paste the copied text into a plain-text editor on your computer or other device, and save it using the suggested file name below the text box.{% endtrans %}

core/modules/help_topics/help_topics/config.import_full.html.twig

@@ -6,14 +6,15 @@ related:
 - config.import_single
 - config.export_single
 ---
-{% set import_page = render_var(url('config.import_full')) %}
+{% set import_link_text %}{% trans %}Import{% endtrans %}{% endset %}
+{% set import_link = render_var(help_route_link(import_link_text, 'config.import_full')) %}
 {% set export_full_topic = render_var(help_topic_link('config.export_full')) %}
 {% set config_overview_topic = render_var(help_topic_link('core.config_overview')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Import the complete configuration of your site from an archive file, such as one that was previously exported (see {{ export_full_topic }}). See {{ config_overview_topic }} for more information about configuration.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Development</em> &gt; <em>Configuration synchronization</em> &gt; <em><a href="{{ import_page }}">Import</a></em>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Development</em> &gt; <em>Configuration synchronization</em> &gt; <em>{{ import_link }}</em>.{% endtrans %}</li>
   <li>{% trans %}Browse to find the <em>Configuration archive</em> that you want to import.{% endtrans %}</li>
   <li>{% trans %}Click <em>Upload</em>. Your configuration archive will be unpacked and placed in the configuration synchronization directory, and you will be redirected to the <em>Synchronize</em> page.{% endtrans %}</li>
   <li>{% trans %}Review the differences between your uploaded configuration and the active configuration, if any, and click <em>Import all</em> to import the changes.{% endtrans %}</li>

core/modules/help_topics/help_topics/config.import_single.html.twig

@@ -6,14 +6,15 @@ related:
 - config.import_full
 - config.export_single
 ---
-{% set single_import = render_var(url('config.import_single')) %}
+{% set single_import_link_text %}{% trans %}Single item{% endtrans %}{% endset %}
+{% set single_import_link = render_var(help_route_link(single_import_link_text, 'config.import_single')) %}
 {% set export_single_topic = render_var(help_topic_link('config.export_single')) %}
 {% set config_overview_topic = render_var(help_topic_link('core.config_overview')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Import a single configuration item in YAML format, such as one that was previously exported (see {{ export_single_topic }}). See {{ config_overview_topic }} for more information about configuration.{% endtrans %}</p>
 <h2>{% trans %}Steps{% endtrans %}</h2>
 <ol>
-  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Development</em> &gt; <em>Configuration synchronization</em> &gt; <em>Import</em> &gt; <a href="{{ single_import }}"><em>Single item</em></a>.{% endtrans %}</li>
+  <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> &gt; <em>Development</em> &gt; <em>Configuration synchronization</em> &gt; <em>Import</em> &gt; <em>{{ single_import_link }}</em>.{% endtrans %}</li>
   <li>{% trans %}Select the <em>Configuration type</em> that you want to import.{% endtrans %}</li>
   <li>{% trans %}On your computer or other device, copy the YAML-format configuration that you want to import to the clipboard.{% endtrans %}</li>
   <li>{% trans %}Paste the clipboard text into the box labeled <em>Paste your configuration here</em>.{% endtrans %}</li>

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

@@ -5,14 +5,15 @@ related:
   - core.translations
   - language.add
 ---
-{% set config_translation = render_var(url('config_translation.mapper_list'))%}
+{% set config_translation_link_text %}{% trans %}Configuration translation{% endtrans %}{% endset %}
+{% set config_translation_link = render_var(help_route_link(config_translation_link_text, 'config_translation.mapper_list'))%}
 {% set config_overview_topic = render_var(help_topic_link('core.config_overview')) %}
 {% set language_add_topic = render_var(help_topic_link('language.add')) %}
 <h2>{% trans %}Goal{% endtrans %}</h2>
 <p>{% trans %}Translate your site configuration to another language. See {{ language_add_topic }} if you need to add a new language.{% 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="{{ config_translation }}"><em>Configuration 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; <em>{{ config_translation_link }}</em>.{% endtrans %}</li>
   <li>{% trans %}Find either the configuration entity type or the simple configuration item that you want to translate in the <em>Label</em> column of the list. Click <em>List</em> under <em>Operations</em> for a configuration entity, or <em>Translate</em> for simple configuration. (See {{ config_overview_topic }} to learn more about types of configuration and configuration entities.){% endtrans %}</li>
   <li>{% trans %}For configuration entities, find the specific entity that you want to translate on the next page, and click <em>Translate</em> under <em>Operations</em>.{% endtrans %}</li>
   <li>{% trans %}Enter translations for the translatable text fields for the configuration item, and save.{% endtrans %}</li>