heimrichhannot/contao-hyphenator-bundle

Word-Hyphenation for the contao content-management-system.

Contao Hyphenator Bundle

, _(*1)

A contao bundle that grants server-side hyphenation (thanks to vanderlee/phpSyllable). It does support headlines and paragraphs by default., _(*2)

This module also handles line break exceptions, in order to keep words like company names together and prevent line break (see tl_page backend entity)., _(*3)

Options

To extend the functionality, all options can be adjusted within your localconfig., _(*4)

Skip hyphenation

If you want to skip several tags from hyphenation simply add hyphen-none as css-class to the appropriate element or use the tl_page.hyphenation field., _(*5)

You also can add tags to be skipped to your project configuration. See configuration reference below, _(*6)

Configuration reference

# Default configuration for extension with alias: "huh_hyphenator"
huh_hyphenator:

  # Add tags you want to be skipped from hyphenating, to array (string without <>)
  skip_tags: []

Line break exceptions

Hyphenator comes with line break exception handling. Simply add lineBreakExceptions on tl_page and prevent line break for connected word groups like:, _(*7)

• Company Names (search: Heimrich & Hannot(?:\sGmbH)|Heimrich & Hannot(?:s)?, will be replaced to: <span class="text-nowrap">Heimrich&nbsp;&amp;&nbsp;Hannot&nbsp;GmbH</span>)
• Prices and other units (search: (\d|€)(\s)(\w), replace: $1[nbsp]$3, Example: 160.000 m² -> 160.00<span class="text-nowrap">0&nbsp;m</span>², 167 Mio. € -> 16<span class="text-nowrap">7&nbsp;M</span>io.&nbsp;€)

As you can see, if you provide an replace pattern, than an regular expression will handle the replacement, otherwise if only an search pattern is provided, spaces will be protected with  ., _(*8)

Requirements

• vanderlee/phpSyllable
• wa72/htmlpagedom