Differences

This shows you the differences between two versions of the page.

--- plugin:hyphenation [2012-05-12 11:25] – 77.34.113.162
+++ plugin:hyphenation [2023-12-21 18:33] (current) – [How it works] Aleksandr
@@ Line 1: / Line 1: @@
-====== hyphenation plugin ======
+====== hyphenation Plugin ======
 ---- plugin ----
@@ Line 7: / Line 7: @@
 type       : Action
 lastupdate : 2009-02-27
-compatible : 2009-02-16, previous and newer
+compatible : 2009-02-14+
 depends    :
 conflicts  :
@@ Line 13: / Line 13: @@
 tags       : hyphen, html
-downloadurl: http://wiki.birth-online.de/_media/software/php/hyphenation.tar.gz
+downloadurl: https://trello.com/1/cards/5afdde754e0bfcedf5969204/attachments/5afddf2f097c67d916983321/download/hyphenation.zip
+bugtracker :
+sourcerepo :
+donationurl:
+screenshot_img:
 ----
-[[http://wiki.birth-online.de/software/php/dw-hyphenation-plugin|Info and Download]]
+===== Requirement =====
-More language libraries! http://phphyphenator.yellowgreen.de/phpHyphenator.zip
+Please, note that this Plugin requires PHP 5!
-===== Problems =====
+===== How it works =====
-  * The hyphenation plugin seems to conflict with the blog plugin, as it interferes with html entities like <code> &nbsp; </code> or <code> &middot </code> and transforms them to <code> &nb&shy;sp; </code> and <code> &mid&shy;dot </code>
+The plugin registers hooks for the ''RENDERER_CONTENT_POSTPROCESS'' event and runs hyphenation over the text. DokuWiki caches the result so this process should run only once per change of a wiki page. So you might have to clear your cache to see the new soft-hyphens!
-  * messes up lower/upper case with words in custom hypenation: e.g. "Kon/fir/manden/frei/zeit" in custom hyph the plugin renders all occurences of **K**onfirmandenfreizeit as **k**onfirmandenfreizeit
+For hyphenation it uses the {{https://trello.com/1/cards/5afdde754e0bfcedf5969204/attachments/5afddea1919024c22dd421ba/download/phpHyphenator.zip|phpHyphenation}} library which makes use of the TeX-algorithms which are considered the best available. The language for hyphenation can be set in the Configuration Manager. The libary is able to also hyphenate Dutch, French, German, Spanish and Swedish.
+===== Alternatives =====
+Since this plugin breaks other plugins and renders other contents empty, I use CSS3 hyphenation instead as described in https://css-tricks.com/almanac/properties/h/hyphenate/. I edited my theme's design.css to
+<code css>
+* {
+  hyphens: auto;
+};
+</code>
+and removed the hyphenation plugin.
+===== Problems =====
+  * The hyphenation plugin seems to conflict with the [[plugin:blog|blog plugin]], as it interferes with html entities like ''%%&nbsp;%%'' or ''%%&middot%%'' and transforms them to ''%%&nb&shy;sp;%%'' and ''%%&mid&shy;dot%%''
+  * messes up lower/upper case with words in custom hypenation: e.g. "Kon/fir/manden/frei/zeit" in custom hyph the plugin renders all occurences of **K**onfirmandenfreizeit as **k**onfirmandenfreizeit
   * messes up with dokuwiki's email addresses hex encoding scheme (mailguard): if hyphenation plugin is enabled it seems that pages with large amounts of html hex sequences are not shown at all. Loading seems to stall and after some time an empty page is shown with no error message at all. You can start with 2-3 email addresses (and it works) add more adresses... and after some lines the page won't show anymore.
-====== Requirement ======
-Please, note that this Plugin requires PHP 5!
+===== Problem =====
-=====Problem=====
 Hello, I have a fatal error, maybe due to the restrictie php settings of my provider cwcity.
 Fatal error: Call to undefined function mb_split() in /home/www/cwcity/hosting/r/o/roomsixhu/htdocs/lib/plugins/hyphenation/phpHyphenation/phpHyphenation.class.php on line 142