diff --git a/core/modules/help_topics/help_topics/ban.banning_ips.html.twig b/core/modules/help_topics/help_topics/ban.banning_ips.html.twig
index ef10c82e644627ee7a43dc62d298074901a871b4..160b02773f912da0b94c72c2255c1ba92afb1f9d 100644
--- a/core/modules/help_topics/help_topics/ban.banning_ips.html.twig
+++ b/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> > <em>People</em> > <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> > <em>People</em> > <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>
diff --git a/core/modules/help_topics/help_topics/block.configure.html.twig b/core/modules/help_topics/help_topics/block.configure.html.twig
index 8b5e8f851cd95524a81a960832848b326cd268d1..cd95c8b77b560af285663dc6c6725d60f5fe78ef 100644
--- a/core/modules/help_topics/help_topics/block.configure.html.twig
+++ b/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> > <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> > <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>
diff --git a/core/modules/help_topics/help_topics/block_content.add.html.twig b/core/modules/help_topics/help_topics/block_content.add.html.twig
index 19f3133c5924adbd449085ba8d96755c4243e606..002a47ba1bc51fc63d582433ce4222d8420adca0 100644
--- a/core/modules/help_topics/help_topics/block_content.add.html.twig
+++ b/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> > <em>Block layout</em> > <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> > <em>Block layout</em> > {{ 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>
diff --git a/core/modules/help_topics/help_topics/block_content.type.html.twig b/core/modules/help_topics/help_topics/block_content.type.html.twig
index 5b7400db08407d2888053dd199c2f9146ef68ae2..1b91c6366fcd6b4f1b7b77edd5cfbc7da5b5dac2 100644
--- a/core/modules/help_topics/help_topics/block_content.type.html.twig
+++ b/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> > <em>Block layout</em> > <em>Custom block library</em> > <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> > <em>Block layout</em> > <em>Custom block library</em> > <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>
diff --git a/core/modules/help_topics/help_topics/book.adding.html.twig b/core/modules/help_topics/help_topics/book.adding.html.twig
index 84e17b6ddbcbb2aa6bb3a23dea08888d65594e05..3ef60009e2ebe20e0d29f99857b2869b93eaf54d 100644
--- a/core/modules/help_topics/help_topics/book.adding.html.twig
+++ b/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> > <a href="{{ node_add }}"><em>Add content</em></a> > <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> > <em>{{ node_add_link }}</em> > <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>
diff --git a/core/modules/help_topics/help_topics/book.configuring.html.twig b/core/modules/help_topics/help_topics/book.configuring.html.twig
index e92143fc6955731b9558d21d288f08809c0725f7..74bd6e105b88a73eb1712697caa781e79c9b4432 100644
--- a/core/modules/help_topics/help_topics/book.configuring.html.twig
+++ b/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> > <em>Books</em> > <a href="{{ settings }}"><em>Settings</em></a>.{% endtrans %}</li>
+ <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> > <em>Books</em> > <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>
diff --git a/core/modules/help_topics/help_topics/book.organizing.html.twig b/core/modules/help_topics/help_topics/book.organizing.html.twig
index a07774b4c28b66ed4d7c5ec10d80e2b1d5f71413..abda65fa74ed3e94827ce32a3f97d2e1e9334029 100644
--- a/core/modules/help_topics/help_topics/book.organizing.html.twig
+++ b/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> > <a href="{{ overview }}"><em>Books</em></a>.{% endtrans %}</li>
+ <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Structure</em> > <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>
diff --git a/core/modules/help_topics/help_topics/config.export_full.html.twig b/core/modules/help_topics/help_topics/config.export_full.html.twig
index cc8f0b772d146bc5a9d20c0670e7e67c1f5ea0a6..ed07aa9d6368063e644af00caf000f83a3829456 100644
--- a/core/modules/help_topics/help_topics/config.export_full.html.twig
+++ b/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> > <em>Development</em> > <em>Configuration synchronization</em> > <a href="{{ export }}"><em>Export</em></a>.{% endtrans %}</li>
+ <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> > <em>Development</em> > <em>Configuration synchronization</em> > <em>{{ export_link }}</em>.{% endtrans %}</li>
<li>{% trans %}Click <em>Export</em> and save the archive file.{% endtrans %}</li>
</ol>
diff --git a/core/modules/help_topics/help_topics/config.export_single.html.twig b/core/modules/help_topics/help_topics/config.export_single.html.twig
index 290197a3c88d6eecb5b2ae1de04ea52a3dc93d26..c05aca091d66105ecfa4fab93a838f751bfaabce 100644
--- a/core/modules/help_topics/help_topics/config.export_single.html.twig
+++ b/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> > <em>Development</em> > <em>Configuration synchronization</em> > <em>Export</em> > <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> > <em>Development</em> > <em>Configuration synchronization</em> > <em>Export</em> > <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 %}
diff --git a/core/modules/help_topics/help_topics/config.import_full.html.twig b/core/modules/help_topics/help_topics/config.import_full.html.twig
index 302de56db290052a1efec2a5641e157ebce0af80..c9ce262280d97c235f4f0d872d99b4f3a8db1e81 100644
--- a/core/modules/help_topics/help_topics/config.import_full.html.twig
+++ b/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> > <em>Development</em> > <em>Configuration synchronization</em> > <em><a href="{{ import_page }}">Import</a></em>.{% endtrans %}</li>
+ <li>{% trans %}In the <em>Manage</em> administrative menu, navigate to <em>Configuration</em> > <em>Development</em> > <em>Configuration synchronization</em> > <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>
diff --git a/core/modules/help_topics/help_topics/config.import_single.html.twig b/core/modules/help_topics/help_topics/config.import_single.html.twig
index 0593963c86204ba84801ec647524151f16c56150..759eca3adf3ad92bad3517df49f02fafb5af6a07 100644
--- a/core/modules/help_topics/help_topics/config.import_single.html.twig
+++ b/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> > <em>Development</em> > <em>Configuration synchronization</em> > <em>Import</em> > <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> > <em>Development</em> > <em>Configuration synchronization</em> > <em>Import</em> > <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>
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
index 1d899e1e47fad639eaf6c4fa86f21d0fb4554e50..d543aedf9a811d023634b05d33ad931b3702eff9 100644
--- a/core/modules/help_topics/help_topics/config_translation.overview.html.twig
+++ b/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> > <em>Regional and language</em> > <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> > <em>Regional and language</em> > <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>