Unverified Commit 3434dee1 authored by Alex Pott's avatar Alex Pott
Browse files

Issue #3090257 by jhodgdon, andypost: Add additional tests for help topic syntax

parent c9466a93

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

+4 −7
Original line number Diff line number Diff line
@@ -13,16 +13,13 @@ top_level: true 
  <dt>{% trans %}Add content and child pages to books and manage their hierarchies{% endtrans %}</dt>

  <dd>{% trans %}Allows users to add configured types of content to existing books.{% endtrans %}</dd>

  <dt>{% trans %}Administer book outlines{% endtrans %}</dt>

  <dd>{% trans %}Allows users to add <em>any</em> type of content to a book, use the book overview administration page, and rearrange the pages of a book from the book outline page.{% endtrans %}

  <dd>{% trans %}Allows users to add <em>any</em> type of content to a book, use the book overview administration page, and rearrange the pages of a book from the book outline page.{% endtrans %}</dd>

  <dt>{% trans %}Administer site configuration (in the System module section){% endtrans %}</dt>

  <dd>{% trans %}Allows users to do many site configuration tasks, including configuring books. This permission has security implications.{% endtrans %}

  </dd>

  <dd>{% trans %}Allows users to do many site configuration tasks, including configuring books. This permission has security implications.{% endtrans %}</dd>

  <dt>{% trans %}View printer-friendly books{% endtrans %}</dt>

  <dd>{% trans %}Allows users to click the <em>printer-friendly version</em> link to generate a printer-friendly display of the page, which includes pages below it in the book outline.{% endtrans %}

  </dd>

  <dd>{% trans %}Allows users to click the <em>printer-friendly version</em> link to generate a printer-friendly display of the page, which includes pages below it in the book outline.{% endtrans %}</dd>

  <dt>{% trans %}<em>Book page</em> content permissions (in the Node module section){% endtrans %}</dt>

  <dd>{% trans %}Like other content types, the <em>Book page</em> content type has separate permissions for creating, editing, and deleting a user's own and any content items of this type.{% endtrans %}

  </dd>

  <dd>{% trans %}Like other content types, the <em>Book page</em> content type has separate permissions for creating, editing, and deleting a user's own and any content items of this type.{% endtrans %}</dd>

</dl>

<h2>{% trans %}Managing books{% endtrans %}</h2>

<p>{% trans %}Book management is handled by the core Book module. The topics listed below will help you create, edit, and configure books.{% endtrans %}</p>

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

+1 −2
Original line number Diff line number Diff line
@@ -5,8 +5,7 @@ related: 
  - block.overview

---

<h2>{% trans %}Goal{% endtrans %}</h2>

<p>{% trans %}Use contextual links to access administrative tasks without navigating the administrative menu.{%

  endtrans %}</p>

<p>{% trans %}Use contextual links to access administrative tasks without navigating the administrative menu.{% endtrans %}</p>

<h2>{% trans %}What are contextual links?{% endtrans %}</h2>

<p>{% trans %}<em>Contextual links</em> give users with the <em>Use contextual links</em> permission quick access to administrative tasks related to areas of non-administrative pages. For example, if a page on your site displays a block, the block would have a contextual link that would allow users with permission to configure the block. If the block contains a menu or a view, it would also have a contextual link for editing the menu links or the view. Clicking a contextual link takes you to the related administrative page directly, without needing to navigate through the administrative menu system.{% endtrans %}</p>

<h2>{% trans %}Steps{% endtrans %}</h2>

core/modules/help_topics/help_topics/core.web_services.html.twig

+1 −1
Original line number Diff line number Diff line
@@ -27,7 +27,7 @@ related: 
  <dt>{% trans %}HTTP Basic Authentication module{% endtrans %}</dt>

  <dd>{% trans %}Provides a way for web services to be authenticated using HTTP Basic authentication against Drupal user accounts.{% endtrans %}</dd>

  <dt>{% trans %}RDF module{% endtrans %}</dt>

  <dd>{% trans %}Enriches your content with metadata to let other applications (e.g., search engines, aggregators, and so on) better understand its relationships and attributes. This semantically enriched, machine-readable output for your website uses the <a href="'http://www.w3.org/TR/xhtml-rdfa-primer/">RDFa specification</a>, which allows RDF data to be embedded in HTML markup.{% endtrans %}</dd>

  <dd>{% trans %}Enriches your content with metadata to let other applications (e.g., search engines, aggregators, and so on) better understand its relationships and attributes. This semantically enriched, machine-readable output for your website uses the <a href="http://www.w3.org/TR/xhtml-rdfa-primer/">RDFa specification</a>, which allows RDF data to be embedded in HTML markup.{% endtrans %}</dd>

</dl>

<p>{% trans %}There are also contributed modules that provide web services.{% endtrans %}</p>

<h2>{% trans %}Additional resources{% endtrans %}</h2>

core/modules/help_topics/help_topics/forum.concept.html.twig

+1 −1
Original line number Diff line number Diff line
@@ -5,7 +5,7 @@ top_level: true 
<h2>{% trans %}What is a forum?{% endtrans %}</h2>

<p>{% trans %}A forum is nested hierarchy of discussions, where users post topics and comment on them.{% endtrans %}</p>

<h2>{% trans %}What is the forum hierarchy?{% endtrans %}</h2>

<p>{% trans %}The forum hierarchy consists of:{% endtrans %}

<p>{% trans %}The forum hierarchy consists of:{% endtrans %}</p>

<ul>

    <li>{% trans %}<em>Forums</em> (for example, <em>Recipes for cooking vegetables</em>){% endtrans %}</li>

    <li>{% trans %}Optional <em>containers</em> can be used to group similar forums (for example, <em>Recipes</em>). Forums can be inside containers and vice versa.{% endtrans %}</li>

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

+2 −3
Original line number Diff line number Diff line
@@ -6,7 +6,7 @@ top_level: true 
<p>{% trans %}<em>Updating</em> is the process of changing from one minor version of the software to a newer version, such as from version 8.3.4 to 8.3.5, or 8.3.5 to 8.4.0. Starting with version 8.x, you can also update to major versions 9, 10, and beyond if your add-on modules, themes, and install profiles are compatible. <em>Upgrading</em> is the process of changing from an older major version of the software to a newer version, such as from version 7 to 8. <em>Migrating</em> is the process of importing data into a site.{% endtrans %}</p>

<p>{% trans %}To upgrade a site from Drupal 6 or 7 to Drupal 8 or later, keeping the content and configuration the same, you will install the new version of the software and add-on modules and themes in a new site, and then migrate the content and other data from your old site into the new site.{% endtrans %}</p>

<h2>{% trans %}Overview of Migrating{% endtrans %}</h2>

<p>{% trans %}You can use the <em>Migration</em> group of modules to perform the migration step of upgrading from Drupal 6 or 7 to Drupal 8 or later, as well as other migrations. These modules also provide APIs that can be used by programmers to write custom software for migrations. Here are the functions of the core migration modules:</p>{% endtrans %}

<p>{% trans %}You can use the <em>Migration</em> group of modules to perform the migration step of upgrading from Drupal 6 or 7 to Drupal 8 or later, as well as other migrations. These modules also provide APIs that can be used by programmers to write custom software for migrations. Here are the functions of the core migration modules:{% endtrans %}</p>

<dl>

<dt>{% trans %}Migrate{% endtrans %}</dt>

<dd>{% trans %}Provides the underlying API for migrating data.{% endtrans %}</dd>
@@ -15,8 +15,7 @@ top_level: true 
<dt>{% trans %}Migrate Drupal UI{% endtrans %}</dt>

<dd>{% trans %}Provides a user interface for performing data migration from older versions of the Drupal software into a new site.{% endtrans %}</dd>

</dl>

<p>{% trans %}If the source of the data you want to migrate is a different content management system, or if the data source is a Drupal site that was built using contributed modules that the core migration modules do not support, then you will also need one or more contributed or custom modules in order to migrate your data.{% endtrans %}</dd>

</dl>

<p>{% trans %}If the source of the data you want to migrate is a different content management system, or if the data source is a Drupal site that was built using contributed modules that the core migration modules do not support, then you will also need one or more contributed or custom modules in order to migrate your data.{% endtrans %}</p>

<h2>{% trans %}Additional Resources{% endtrans %}</h2>

<ul>

<li>{% trans %}<a href="https://www.drupal.org/docs/upgrading-drupal">Upgrading Drupal</a>{% endtrans %}</li>