reverted: --- b/core/modules/help_topics/help_topics/ckeditor.configure.html.twig +++ /dev/null @@ -1,30 +0,0 @@ ---- -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 %}

{% trans %}In the Manage administrative menu, navigate to Structure > Block layout.{% endtrans %}
{% trans %}Click the name of the theme that contains the block.{% endtrans %}
{% trans %}Optionally, click Demonstrate block regions to see the regions of the theme.{% endtrans %}
{% 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 %}
{% 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 %}
{% 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 %} -
- {% trans %}Block title: The heading for the block on your site. For some blocks, you will need to check the Override title checkbox to enter a title.{% endtrans %}
- {% trans %}Display title: Check the box if you want the title displayed{% endtrans %}
- {% trans %}Visibility: Add conditions for when the block should be displayed{% endtrans %}
- {% trans %}Region: Change the theme region the block is displayed in{% endtrans %}
-
{% trans %}Click Save block.{% endtrans %}

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

{% trans %} User guide section on text formats and editors {% endtrans %}

diff -u b/core/modules/help_topics/help_topics/ckeditor.overview.html.twig b/core/modules/help_topics/help_topics/ckeditor.overview.html.twig --- b/core/modules/help_topics/help_topics/ckeditor.overview.html.twig +++ b/core/modules/help_topics/help_topics/ckeditor.overview.html.twig @@ -2,18 +2,24 @@ label: 'Managing CKEditor' top_level: true --- -{% set formats = render_var(url('filter.admin_overview')) %} +{% set filters = render_var(url('filter.admin_overview')) %} +

{% trans %}Goal{% endtrans%}

{% trans %}Manage CKEditor for text formats on the site.{% endtrans%}

{% 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 %}CKEditor only allows users to format content in accordance with the text filters 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 %}Steps{% endtrans%}

{% trans %}In the Configuration administrative menu, navigate to Content Authoring > Text editors and formats. The Text Editor column on the page displays the configured text editor for each text format.{% endtrans%}
{% trans %}Click Configure next to the text format to configure, or click + Add text format button to create a new text format.{% endtrans%}
{% trans %}Complete or update the options of the configuration form.{% endtrans%}
{% trans %}Select CKEditor in the Text editor select list.{% endtrans%}
{% trans %}The Toolbar configuration section shows Available buttons and Active toolbar.{% endtrans%}
{% trans %}To make an available button active, drag the button from Available buttons and place it into Active toolbar in the desired location. When dragging a button, the Active toolbar shows available button groups.{% endtrans%}
{% trans %}Use the Add group button to add additional groups for buttons.{% endtrans%}
{% trans %}To remove a button, drag the button from Active toolbar and place it into Available buttons.{% endtrans%}
{% trans %}Any active buttons that have configurable settings, such as Image button, are configurable in the CKEditor plugin settings section that appears below the Toolbar configuration section.{% endtrans%}

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

{% trans %} Online documentation for the CKEditor module {% endtrans %}

{% trans %}Goal{% endtrans%}

{% trans %}Manage text editors used on the site.{% endtrans%}

{% 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 %}Steps{% endtrans%}

{% trans %}In the Configuration administrative menu, navigate to Content Authoring > Text editors and formats. The Text Editor column on the page displays the configured text editor for each text format.{% endtrans%}
{% trans %}Click Configure next to the text format to configure.{% endtrans%}
{% trans %}The Text editor shows the active text editor for this text format.{% endtrans%}
{% trans %}Any available text editor options specific to this text format will appear on this form. Refer to the contributed module's documentation for information on configuration options.{% endtrans%}

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

{% trans %} Online documentation for the Text Editor module {% endtrans %}

{% trans %}Goal{% endtrans%}

{% trans %}Install a new text editor for use on the site.{% endtrans%}

{% trans %}About installing text editors{% endtrans%}

{% trans %}Drupal core provides CKEditor as a module (which can be enabled in the Extend administrative menu). The Text Editor module provides a framework for other modules to provide alternative text editors.{% endtrans%}

{% trans %}Steps{% endtrans%}

{% trans %}Enable the desired text editor module on the Extend administrative menu. This can be either the core CKEditor module, or an editor provided by a Drupal contributed module. If enabling the core CKEditor, proceed to Managing CKEditor in related topics below. The following steps are for editors other than CKEditor.{% endtrans%}
{% trans %}When installing a contributed text editor module, refer to that module's installation instructions or readme file for complete installation information. Many modules require external libraries to be installed in addition to the module.{% endtrans%}
{% trans %}After the text editor is installed, it may provide configuration options specific to the editor . Refer to the contributed module's documentation for information on configuration options.{% endtrans%}

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

{% trans %} Online documentation for the Text Editor module {% endtrans %}

{% trans %}Goal{% endtrans %}

{% trans %}Configure text filters and text formats on the site.{% endtrans %}

{% trans %}What are text filters and text formats?{% endtrans %}

{% trans %}The Filter module allows administrators to configure text formats. Text formats change how HTML tags and other text will be processed and displayed in the site. They are used to transform text, and also help to defend your web site against potentially damaging input from malicious users. Visual text editors can be associated with text formats by using the Text Editor module.

{% trans %}Using text fields with text formats{% endtrans%}

{% trans %}Text fields that allow text formats are those with "formatted" in the description. These are Text (formatted, long, with summary), Text (formatted), and Text (formatted, long). You cannot change the type of field once a field has been created.{% endtrans%}

{% trans %}Steps{% endtrans%}

{% trans %}In the Configuration administrative menu, navigate to Content Authoring > Text editors and formats.{% endtrans%}
{% trans %}Click Configure next to the text format to configure, or click + Add text format button to create a new text format.{% endtrans%}
{% trans %}Complete or update the options on the configuration form.{% endtrans%}
{% trans %}The Name field is the human name for this text format.{% endtrans%}
{% trans %}The Roles checkboxes indicate the user 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. This is because HTML tags can allow embedding malicious links or scripts in text. More trusted registered users may be granted permission to use less restrictive text formats in order to create rich text. Improper text format configuration is a security risk.{% endtrans%}
{% trans %}The Text editor select list allows you to choose if users will see a text editor (such as CKEditor) when using this text format.{% endtrans%}
{% trans %}The Enabled filters section allows you to select one or more text filters to apply when transforming text. Each text format uses filters that add, remove, or transform elements within user-entered text. For example, one filter removes unapproved HTML tags, while another transforms URLs into clickable links. Filters are applied in a specific order. They do not change the stored content: they define how it is processed and displayed.{% endtrans%}
{% trans %}The Filter processing order section allows you to choose the order that the enabled filters are applied to transform the text. Change the order of filters using the draggable handles or row weights.{% endtrans%}
{% trans %}If any enabled filters with configurable settings will appear in the Filter settings section.{% endtrans%}

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

{% trans %}Filter module overview{% endtrans %}