TYPO3 Extension ``hyphen_dictionary``
=====================================
1 Motivation
------------
In the past years we have created many TYPO3 websites with mobile
versions. Depending on the design, the mobile versions often had
headlines with quite a large font size. Using long words leads to either
cut of headlines or weird word breaks because of the browsers decision
where to break the word. To also support defining optional word breaks
() for header fields, we have created this extension.
2 What is does
--------------
This extension allows editors to define a dictionary of word and where
to put optionally word breaks.
Using a ViewHelper in fluid templates replaces the given input with in
the dictionary defined words.
3 How to use
------------
Install this extension with
``composer reg neues-studio/hyphen-dictionary``
3.1 Creating the dictionary
~~~~~~~~~~~~~~~~~~~~~~~~~~~
Create a sys folder in the TYPO3 backend and add words with optional
word breaks to it. To set the optional word breaks use ``[-]`` at the
position the words break should be.
**Be aware that the defined words are case-sensitive.**
3.2 Using the ViewHelper
~~~~~~~~~~~~~~~~~~~~~~~~
To add the optional word breaks to a given string (e.g. headline) use
the ``HyphenateViewHelper``.
**Example**
::
or
{data.header}
or
{data.header -> h:format.hyphenate()}
You can use the ``minWordLength`` argument to define that only words
with that length should be hyphenated.