You are here

README.txt in CKEditor Font Size and Family 8

CONTENTS OF THIS FILE
---------------------

 * Introduction
 * Requirements
 * Installation
 * Configuration


INTRODUCTION
------------

The CKEditor Font Size and Family module enables the CKEditor Font Size and
Family plugin (https://ckeditor.com/cke4/addon/font) in your WYSIWYG editor.

This plugin adds Font Size and Font Family dropdowns that default apply as
inline element styles. The default collection of fonts includes most popular
serif fonts (Times New Roman, Georgia), sans-serif fonts (Arial, Verdana,
Tahoma), and monospaced fonts (Courier New).

The list of font sizes and styles can be easily customized for each text filter.

 * For a full description of the module, visit the project page:
   https://www.drupal.org/project/ckeditor_font

 * To submit bug reports and feature suggestions, or track changes:
   https://www.drupal.org/project/issues/ckeditor_font

 * For additional resources, visit the community documentation:
   https://www.drupal.org/docs/8/modules/ckeditor-font-size-and-family


REQUIREMENTS
------------

This module requires no modules outside of Drupal core.

This module requires the CKEditor font plugin (http://ckeditor.com/addon/font).


INSTALLATION
------------

Local installation (non-composer):

    1. Download the CKEditor font plugin (v4.13.x to be compatible with Drupal
       8) from http://ckeditor.com/addon/font.
    2. Place the plugin in the root libraries folder (/libraries).
    3. Install as you would normally install a contributed Drupal module. Visit
       https://www.drupal.org/node/895232/ for further information.

Composer installation:

    1. CKEditor Font Size and Family's composer.json will automatically install
       the library into `base_path()/libraries/font`. To add the library,
       type `composer require drupal/ckeditor_font` at your Drupal project root.


CONFIGURATION
-------------

    1. When enabled, navigate to Administration > Configuration >
       Text formats and editors.
    2. Select the filter you want to add the Font functionality to, and click
       'Configure'.
    3. From the 'Toolbar configuration', drag the 'f' (font families) and/or
       'S' (font size) buttons from the 'Available buttons' into the
       'Active toolbar'.
    4. Configure the options under CKEditor plugin settings > Font Settings.
    5. Under 'Font families', provide a list of approved font sizes:
       `Primary font, fallback1, fallback2|Font Label`
    6. Under 'Font sizes', provide a list of approved font sizes:
       `123px|Size label
       123em|Size label
       123%|Size label`
    7. Click 'Save Configuration'.
    8. The Font Family and Font Size buttons will appear in CKEditor modals
       for the configured text filter.

File

README.txt
View source
  1. CONTENTS OF THIS FILE
  2. ---------------------
  3. * Introduction
  4. * Requirements
  5. * Installation
  6. * Configuration
  7. INTRODUCTION
  8. ------------
  9. The CKEditor Font Size and Family module enables the CKEditor Font Size and
  10. Family plugin (https://ckeditor.com/cke4/addon/font) in your WYSIWYG editor.
  11. This plugin adds Font Size and Font Family dropdowns that default apply as
  12. inline element styles. The default collection of fonts includes most popular
  13. serif fonts (Times New Roman, Georgia), sans-serif fonts (Arial, Verdana,
  14. Tahoma), and monospaced fonts (Courier New).
  15. The list of font sizes and styles can be easily customized for each text filter.
  16. * For a full description of the module, visit the project page:
  17. https://www.drupal.org/project/ckeditor_font
  18. * To submit bug reports and feature suggestions, or track changes:
  19. https://www.drupal.org/project/issues/ckeditor_font
  20. * For additional resources, visit the community documentation:
  21. https://www.drupal.org/docs/8/modules/ckeditor-font-size-and-family
  22. REQUIREMENTS
  23. ------------
  24. This module requires no modules outside of Drupal core.
  25. This module requires the CKEditor font plugin (http://ckeditor.com/addon/font).
  26. INSTALLATION
  27. ------------
  28. Local installation (non-composer):
  29. 1. Download the CKEditor font plugin (v4.13.x to be compatible with Drupal
  30. 8) from http://ckeditor.com/addon/font.
  31. 2. Place the plugin in the root libraries folder (/libraries).
  32. 3. Install as you would normally install a contributed Drupal module. Visit
  33. https://www.drupal.org/node/895232/ for further information.
  34. Composer installation:
  35. 1. CKEditor Font Size and Family's composer.json will automatically install
  36. the library into `base_path()/libraries/font`. To add the library,
  37. type `composer require drupal/ckeditor_font` at your Drupal project root.
  38. CONFIGURATION
  39. -------------
  40. 1. When enabled, navigate to Administration > Configuration >
  41. Text formats and editors.
  42. 2. Select the filter you want to add the Font functionality to, and click
  43. 'Configure'.
  44. 3. From the 'Toolbar configuration', drag the 'f' (font families) and/or
  45. 'S' (font size) buttons from the 'Available buttons' into the
  46. 'Active toolbar'.
  47. 4. Configure the options under CKEditor plugin settings > Font Settings.
  48. 5. Under 'Font families', provide a list of approved font sizes:
  49. `Primary font, fallback1, fallback2|Font Label`
  50. 6. Under 'Font sizes', provide a list of approved font sizes:
  51. `123px|Size label
  52. 123em|Size label
  53. 123%|Size label`
  54. 7. Click 'Save Configuration'.
  55. 8. The Font Family and Font Size buttons will appear in CKEditor modals
  56. for the configured text filter.