diff --git a/core/modules/editor/editor.module b/core/modules/editor/editor.module index af2b8ea..0f91b27 100644 --- a/core/modules/editor/editor.module +++ b/core/modules/editor/editor.module @@ -17,17 +17,18 @@ function editor_help($path, $arg) { case 'admin/help#editor': $output = ''; $output .= '

' . t('About') . '

'; - $output .= '

' . t('The Text Editor module provides a framework to extend the user interface on text fields that allow HTML input. Without Text Editor module, fields accept only text where formatting must be typed manually, such as entering a <strong> tag to make text bold or an <em> tag to italicize text. The Text Editor module allows these fields to be enhanced with rich text editors (WYSIWYGs) or toolbars, which make entering and formatting content easier. For more information, see the online handbook entry for Editor module.', array('@editor' => 'http://drupal.org/documentation/modules/editor/')) . '

'; + $output .= '

' . t('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. For more information, see the online documentation for the Text Editor module.', array('@documentation' => 'https://drupal.org/documentation/modules/editor', '@ckeditor' => url('admin/help/ckeditor'))) . '

'; $output .= '

' . t('Uses') . '

'; $output .= '
'; - $output .= '
' . t('Enabling or configuring a text editor') . '
'; - $output .= '
' . t('The Text Editor module does not have its own configuration page. Instead it enhances existing configuration pages with additional options. Text editors are attached to individual text formats, which can be configured on the Text formats page. Each text format may be associated with a single text editor. When entering content with that text format, the associated text editor will automatically be enabled.', array('@formats' => url('admin/config/content/formats'))) . '
'; - $output .= '
' . t('Allowing a user to choose a text editor') . '
'; - $output .= '
' . t('Because text editor configurations are bound to a text format, users with access to more than one text format may switch between available text editors by changing the text format for a field. For more information about text formats, see the Filter module help page, which describes text formats in more detail.', array('@filter' => url('admin/help/filter'))) . '
'; - // @todo: Mention the availability of the built-in core WYSIWYG (CKEditor) - // when it becomes available. See http://drupal.org/node/1878344. - $output .= '
' . t('Installing additional text editor libraries') . '
'; - $output .= '
' . t('The Text Editor module does not provide any text editor libraries itself. Most installations of Drupal include a module that provides a text editor library which may be enabled on the Modules page. Additional modules that provide text editor libraries may be downloaded from Drupal.org.', array('@modules' => url('admin/modules'), '@download' => 'http://drupal.org/search/site/wysiwyg%20module')) . '
'; + $output .= '
' . t('Installing text editors') . '
'; + $output .= '
' . t('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 at the Extend page, or a contributed module for any other text editor. +When installing a contributed 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.', array('@ckeditor' => url('admin/help/ckeditor'), '@extend' => url('admin/modules'))) . '
'; + $output .= '
' . t('Enabling a text editor for a text format') . '
'; + $output .= '
' . t('On the Text formats and editors page you can see which text editor is attached each text format. You can change this by clicking on the Configure link, and then choosing an 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.', array('@formats' => url('admin/config/content/formats'))) . '
'; + $output .= '
' . t('Configuring a text editor') . '
'; + $output .= '
' . t('Once a text editor is attached to 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. The buttons are typically for functions like inserting links, making bullet lists, and other formatting tasks, and they typically insert HTML tags into the field source. It is important to match the buttons to the text format. For instance, if a text format filters out link tags, do not include a link button in the editor configuration for that format. For more details, see the specific help page of that editor and the Filters help page.', array('@filters' => url('admin/help/filters'))) . '
'; + $output .= '
' . t('Using different text editors and formats') . '
'; + $output .= '
' . t('If you switch the text format on a field, the editor will change as well because the text editor configuration is attached to 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 formats with different text editors if they are installed.') . '
'; $output .= '
'; return $output; }