diff --git a/core/modules/help_topics/help_topics/ckeditor.configure.html.twig b/core/modules/help_topics/help_topics/ckeditor.configure.html.twig new file mode 100644 index 0000000000..f5df0f0ba4 --- /dev/null +++ b/core/modules/help_topics/help_topics/ckeditor.configure.html.twig @@ -0,0 +1,30 @@ +--- +label: 'Configuring CKEditor' +related: +- ckeditor.overview +- editor.overview +--- +{% set layout_url = render_var(url('block.admin_display')) %} +

{% trans %}Goal{% endtrans %}

+

{% trans %}Configure the settings of a block that was previously placed in a region of a theme.{% endtrans %}

+

{% trans %}Steps{% endtrans %}

+
    +
  1. {% trans %}In the Manage administrative menu, navigate to Structure > Block layout.{% endtrans %}
    2. +
  2. {% trans %}Click the name of the theme that contains the block.{% endtrans %}
    3. +
  3. {% trans %}Optionally, click Demonstrate block regions to see the regions of the theme.{% endtrans %}
    4. +
  4. {% 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 Save blocks.{% endtrans %}
    5. +
  5. {% trans %}If you want to change additional settings, find the region where the block you want to update is currently located, and click Configure in the line of the block description.{% endtrans %}
    6. +
  6. {% trans %}Edit the block's settings. The available settings vary depending on the module that provides the block, but for all blocks you can change:{% endtrans %} + +
    7. +
  7. {% trans %}Click Save block.{% endtrans %}
    8. +
+

{% trans %}Additional resources{% endtrans %}

+ diff --git a/core/modules/help_topics/help_topics/ckeditor.overview.html.twig b/core/modules/help_topics/help_topics/ckeditor.overview.html.twig new file mode 100644 index 0000000000..e77a013a63 --- /dev/null +++ b/core/modules/help_topics/help_topics/ckeditor.overview.html.twig @@ -0,0 +1,21 @@ +--- +label: 'Managing CKEditor' +top_level: true +--- +{% set formats = render_var(url('filter.admin_overview')) %} +

{% trans %}What is CKEditor?{% endtrans %}

+

{% trans %}The CKEditor module provides a highly-accessible, highly-usable visual text editor and adds a toolbar to text fields. Users can use buttons to format content and to create semantically correct and valid HTML. The CKEditor module uses the framework provided by the Text Editor module. It requires JavaScript to be enabled in the browser.{% endtrans %}

+

{% trans %}CKEditor only allows users to format content in accordance with the filter configuration of the specific text format. If a text format excludes certain HTML tags, the corresponding toolbar buttons are not displayed to users when they edit a text field in this format.{% endtrans %}

+

{% trans %}Toggling between formatted text and HTML source{% endtrans %}

+

{% trans %}If the Source button is available in the toolbar, users can click this button to disable the visual editor and edit the HTML source directly. After toggling back, the visual editor uses the allowed HTML tags to format the text — independent of whether buttons for these tags are available in the toolbar. If the text format is set to limit the use of HTML tags, then all excluded tags will be stripped out of the HTML source when the user toggles back to the text editor.{% endtrans %}

+

{% trans %}Checking my spelling as I type{% endtrans %}

+

{% trans %}By default, CKEditor is configured to leverage your browser's spell check capability. Make sure your browser's spell checker is enabled in your browser's settings. To access suggested corrections for misspelled words, it may be necessary to hold the Control or command (Mac) key while right-clicking the misspelling.{% endtrans %}

+

{% trans %}Managing Accessibility features{% endtrans %}

+

{% trans %}The built-in WYSIWYG editor (CKEditor) comes with a number of accessibility features. CKEditor comes with built-in keyboard shortcuts, which can be beneficial for both power users and keyboard-only users.{% endtrans %}

+

{% trans %}Generating accessible content{% endtrans %}

+

{% trans %}HTML tables can be created with both table headers as well as caption/summary elements. Alt text is required by default on images added through CKEditor (note that this can be overridden). Semantic HTML5 figure/figcaption are available to add captions to images.{% endtrans %}

+

{% trans %}Additional resources{% 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 new file mode 100644 index 0000000000..f4f169ef70 --- /dev/null +++ b/core/modules/help_topics/help_topics/editor.overview.html.twig @@ -0,0 +1,21 @@ +--- +label: 'Managing text editors' +top_level: true +related: + - ckeditor.overview +--- +{% set ckeditor_overview = render_var(url('help.help_topic', {'id': 'ckeditor.overview'})) %} +

{% trans %}What is Text Editor?{% endtrans %}

+

{% trans %}The Text Editor module provides a framework that other modules (such as CKEditor module) can use to provide toolbars and other functionality that allow users to format text more easily than typing HTML tags directly.{% endtrans %}

+

{% trans %}Installing text editors{% endtrans %}

+

{% trans %}The Text Editor module provides a framework for managing editors. To use it, you also need to enable a text editor. This can either be the core CKEditor module, which can be enabled on the Extend page, or a contributed module for any other text editor. When installing a contributed text editor module, be sure to check the installation instructions, because you will most likely need to download and install an external library as well as the Drupal module.{% endtrans %}

+

{% trans %}Enabling a text editor for a text format{% endtrans %}

+

{% trans %}On the Text formats and editors page, you can see which text editor is associated with each text format. You can change this by clicking on the Configure link, and then choosing a text editor or none from the Text editor drop-down list. The text editor will then be displayed with any text field for which this text format is chosen.{% endtrans %}

+

{% trans %}Configuring a text editor{% endtrans %}

+

{% trans %}Once a text editor is associated with a text format, you can configure it by clicking on the Configure link for this format. Depending on the specific text editor, you can configure it for example by adding buttons to its toolbar. Typically these buttons provide formatting or editing tools, and they often insert HTML tags into the field source. For details, see the help page of the specific text editor.{% endtrans %}

+

{% trans %} Using different text editors and formats{% endtrans %}

+

{% trans %}If you change the text format on a text field, the text editor will change as well because the text editor configuration is associated with the individual text format. This allows the use of the same text editor with different options for different text formats. It also allows users to choose between text formats with different text editors if they are installed.{% endtrans %}

+

{% trans %}Additional resources{% endtrans %}

+