diff --git a/core/modules/help_topics/help_topics/core.content_structure.html.twig b/core/modules/help_topics/help_topics/core.content_structure.html.twig index 6eff9ee904..5fb1209ff6 100644 --- a/core/modules/help_topics/help_topics/core.content_structure.html.twig +++ b/core/modules/help_topics/help_topics/core.content_structure.html.twig @@ -20,13 +20,13 @@ top_level: true
  • {% trans %}Date range (Datetime range module): Stores time/date periods with a start and and an end{% endtrans %}
  • {% trans %}Email (core system): Stores email addresses{% endtrans %}
  • {% trans %}Link (Link module): Stores URLs and link text{% endtrans %}
    • -
  • {% trans %}List (Options module): Stores values chosen from pre-defined lists, where the values can be numbers or text; see section below for more on list fields{% endtrans %}
    • +
  • {% trans %}List (Options module): Stores values chosen from pre-defined lists, where the values can be numbers or text; see section below for more on list fields.{% endtrans %}
  • {% trans %}Reference (core system): Stores entity references; see section above{% endtrans %}
  • {% trans %}Telephone (Telephone module): Stores telephone numbers{% endtrans %}
  • {% trans %}Text (Text module): Stores formatted and unformatted text; see section below for more on text fields.{% endtrans %}

    • {% trans %}What settings are available for List field types?{% endtrans %}

    -

    {% trans %}List fields associate pre-defined keys (or value codes) with labels that the user sees. For example, you might define a list field that shows the user the names of several locations, while behind the scenes a location code is stored in the database. There are different list field types depending on the type of the value code; for example, a List (integer) field has integer values, while the values of a List (text) field are text strings. Once you have chosen the field type, the main setting for a list field is the Allowed values list, which associates the keys with the labels.{% endtrans %}

    +

    {% trans %}List fields associate pre-defined keys (or value codes) with labels that the user sees. For example, you might define a list field that shows the user the names of several locations, while behind the scenes a location code is stored in the database. Different list field types depend on the type of the value code; for example, a List (integer) field has integer values, while the values of a List (text) field are text strings. Once you have chosen the field type, the main setting for a list field is the Allowed values list, which associates the keys with the labels.{% endtrans %}

    {% trans %}What types of Text fields are available?{% endtrans %}

    {% trans %}There are several types of text fields, with different characteristics. Text fields can be either plain or formatted: plain text fields do not contain HTML, while formatted fields can contain HTML and are processed through text filters (these are provided by the core Filter module; if you have that module enabled, see the related topic below on filters for more information). Text fields can also be regular-length (with a limit of 255 characters) or long (with a very large character limit), and long formatted text fields can include a summary attribute. All possible combinations of these characteristics exist as text field types; for example, Text (plain) and Text (formatted, long, with summary) are two examples of text field types. {% endtrans %}

    {% trans %}What is a formatter?{% endtrans %}

    diff --git a/core/modules/help_topics/help_topics/editor.overview.html.twig b/core/modules/help_topics/help_topics/editor.overview.html.twig index 9724b69628..600048e1cc 100644 --- a/core/modules/help_topics/help_topics/editor.overview.html.twig +++ b/core/modules/help_topics/help_topics/editor.overview.html.twig @@ -10,14 +10,14 @@ related:

    {% trans %}Goal{% endtrans %}

    {% trans %}Configure a text format so that when a user is editing text and selects this text format, a text editor installed on your site is shown. Configure the text editor, such as choosing which buttons and functions are available. See Managing text filters and text formats for more about text formats.{% endtrans %}

    {% trans %}What is a text editor?{% endtrans %}

    -

    {% trans %}A text editor is software (typically, a JavaScript library) that provides buttons and other command mechanisms to make editing HTML text easier. Some editors are called visual or WYSIWYG (What You See Is What You Get) editors; these editors hide the details of HTML from the user, and instead show formatted output on the screen. The core Text Editor module provides a framework for deploying text editors on your site. The core CKEditor module provides CKEditor, which is a widely-used JavaScript WYSIWYG editor that creates clean and valid HTML; the module also enforces the HTML tag restrictions in the associated text format. Various contributed modules provide other editors; to install a new editor, besides installing the module, you may need to download the editor software from a third-party site.{% endtrans %}

    +

    {% trans %}A text editor is software (typically, a JavaScript library) that provides buttons and other command mechanisms to make editing HTML text easier. Some editors are called visual or WYSIWYG (What You See Is What You Get) editors; these editors hide the details of HTML from the user, and instead show formatted output on the screen. The core Text Editor module provides a framework for deploying text editors on your site. The core CKEditor module provides CKEditor, which is a widely-used JavaScript WYSIWYG editor that creates clean and valid HTML; the module also enforces the HTML tag restrictions in the associated text format. Various contributed modules provide other editors; to install a new editor, besides installing the module, you may need to download the editor library from a third-party site.{% endtrans %}

    {% trans %}Steps{% endtrans %}

    1. {% trans %}In the Manage administrative menu, navigate to Configuration > Content Authoring > Text formats and editors. The Text editor column in the table shows the text editor that is currently connected to each text format, if any.{% endtrans %}
    2. {% trans %}Follow the steps on Managing text filters and text formats to add a new text format or configure an existing text format; when you reach the step about text editors, return to this topic.{% endtrans %}
    3. {% trans %}Select CKEditor as the Text editor, or another text editor that you have installed. The rest of these steps assume you selected CKEditor.{% endtrans %}
      4. -
    4. {% trans %}Under Toolbar configuration, drag buttons between Available buttons and Active toolbar; only buttons in Active toolbar will be shown to the user. If you are using a mouse, you can hover over a button to see a tool tip explaining what the button does.{% endtrans %}
      5. +
    5. {% trans %}Under Toolbar configuration, drag buttons between Available buttons and Active toolbar; only buttons in Active toolbar will be shown to the user. If you are using a mouse, you can hover over a button to see a tooltip explaining what the button does.{% endtrans %}
    6. {% trans %}Drag buttons within Active toolbar to the desired order, and group buttons by dragging them into the grouping boxes; click Add group to add additional groups.{% endtrans %}
      7. -
    7. {% trans %}Under CKEditor plugin settings, configure any buttons that have configuration. This section will not be present if there are no active buttons with configuration.{% endtrans %}
      8. +
    8. {% trans %}Under CKEditor plugin settings, configure any buttons that have the configuration. This section will not be present if there are no active buttons with configuration.{% endtrans %}
    9. {% trans %}Return to Managing text filters and text formats to complete the text format configuration, and be sure to save the text format.{% endtrans %}
    diff --git a/core/modules/help_topics/help_topics/filter.overview.html.twig b/core/modules/help_topics/help_topics/filter.overview.html.twig index c8295c887c..e4a88c7269 100644 --- a/core/modules/help_topics/help_topics/filter.overview.html.twig +++ b/core/modules/help_topics/help_topics/filter.overview.html.twig @@ -23,14 +23,14 @@ related:
    {% trans %}Convert URLs into links{% endtrans %}
    {% trans %}Takes plain URLs in text and turns them into HTML links.{% endtrans %}
    {% trans %}Restrict images to this site{% endtrans %}
    -
    {% trans %}For text formats that allow HTML image tags, restricts images to URLs within this site.{% endtrans %}
    +
    {% trans %}For text formats that allow HTML image tags, restrict images to URLs within this site.{% endtrans %}

    {% trans %}Steps{% endtrans %}

    1. {% trans %}In the Manage administrative menu, navigate to Configuration > Content Authoring > Text formats and editors. If you do not have the core Text Editor module installed, the menu link and page title will instead be Text formats.{% endtrans %}
    2. {% trans %}Click Configure to configure an existing text format, or + Add text format to create a new text format.{% endtrans %}
    3. {% trans %}Enter the desired Name for the text format.{% endtrans %}
      4. -
    4. {% trans %}Check the Roles that can use this text format. To ensure security, anonymous and untrusted users should only have access to text formats that restrict them to either plain text or a safe set of HTML tags, because HTML tags can allow embedding malicious links or scripts in text. Improper text format configuration is a security risk.{% endtrans %}
      5. +
    5. {% trans %}Check the Roles that can use this text format. To ensure security, anonymous and untrusted users should only have access to text formats that restrict them to either plain text or a safe set of HTML tags because HTML tags can allow embedding malicious links or scripts in text. Improper text format configuration is a security risk.{% endtrans %}
    6. {% trans %}If the core Text Editor module is installed, see the related topic to connect a text editor to this text format.{% endtrans %}
    7. {% trans %}Under Enabled filters, check the text filters that you want to use.{% endtrans %}
    8. {% trans %}Under Filter processing order, drag the filters to the correct order. Choose the order carefully; for example, if you have a filter that results in a particular HTML tag being added to the text, that should run after a filter that restricts HTML tags, to avoid deleting the new tags the first filter added.{% endtrans %}