LiaHyphenator 

This is a simple wrapper for Hyphenator: Word-Hyphenation for PHP based on the TeX-Hyphenation algorithm

Installation 

Explains how to install this extension in Composer-based and Classic TYPO3 installations.

Configuration 

Learn how to configure this extension.

ViewHelper 

Learn where to get help and how to report issues you found.

Frequently Asked Questions (FAQ) 

These questions have been frequently asked.

How to get help 

Learn where to get help and how to report issues you found.

Configuration 

After installation you can use the lih:hyphenate ViewHelper in your templates by imporitng the namespace.

in the opening html-Tag of your template-file like this

<html xmlns:f="http://typo3.org/ns/TYPO3/CMS/Fluid/ViewHelpers"
      xmlns:lih="http://typo3.org/ns/LIA/LiaHyphenator/ViewHelpers"
      data-namespace-typo3-fluid="true"
>
Copied!

Use this line in your template before using any Hyphenator-ViewHelper:

{namespace lih=LIA/LiaHyphenator/ViewHelpers}
Copied!

See also Import ViewHelper namespaces

Frequently Asked Questions (FAQ) 

See chapter Installation.

See chapter Configuration.

Check if you correctly imported the namespace. See chapter Configuration.

See chapter Where to get help.

Fluid ViewHelper Documentation 

Rendered

Tue, 05 May 2026 11:40:32 +0000

This is a complete reference of all available Fluid ViewHelpers. This documentation is generated from PHP Source code.

Content 

Hyphenate ViewHelper <lih:hyphenate> 

This ViewHelper can be used to apply hyphenation to text.

Examples 

Usage with simple StringContent 

The ViewHelper can be used as tag as well as with inline syntax, here are some Examples used with a Variable set like this:

<f:variable name="stringContent">Some textcontent to apply hyphention to</f:variable>
Copied!

ViewHelper usage:

{stringContent -> lih:hyphenate()}
Copied!

or

{lih:hyphenate(value: stringContent)}
Copied!

or

<lih:hyphenate value="{stringContent}" />
Copied!

or

<lih:hyphenate>{stringContent}</lih:hyphenate>
Copied!

The output is the same for all examples:

Some text&shy;con&shy;tent to apply hy&shy;phen&shy;ti&shy;on to
Copied!

Example with arguments 

<lih:hyphenate value="{stringContent}" leftMin="2" rightMin="3" wordMin="4" defaultLocale="de_CH"></lih:hyphenate>
Copied!

This will use a german hyphenation dictionary with the settings for leftMin, rightMin and wordMin set as specified.

Inline example:

{stringContent -> lih:hyphenate(leftMin: 2, rightMin: 3, wordMin: 5)}
Copied!

This will set the values for the arguments leftMin, rightMin and wordMin.

Arguments

The following arguments are available for the hyphenate ViewHelper:

defaultLocale

defaultLocale
Type
string
This parameter defines what dictionary to use by default for hyphenation. Defaults to the current locale.

hyphen

hyphen
Type
string
String to use as hyphen (e.g. &shy; / "\xAD" / "\u{00AD}").

leftMin

leftMin
Type
int
How many characters have to be left unhyphenated to the left of the word. This has to be an integer value.

quality

quality
Type
int
How good shal the hyphenation be. The higher the number the better. THis can be any integer from 0 (no Hyphenation at all) through 9 (berst hyphernation). This defaults to 9. .. warning:: Change this only if you know what you do!

rightMin

rightMin
Type
int
How many characters have to be left unhyphenated to the right of the word. This has to be an integer value

value

value
Type
string
Text to apply hyphenation to.

wordMin

wordMin
Type
int
Words under the given length will not be hyphenated altogether. It makes sense to set option to a higher value than the sum of rightMin and leftMin.