| <refentry xmlns="http://docbook.org/ns/docbook" |
| xmlns:xlink="http://www.w3.org/1999/xlink" |
| xmlns:xi="http://www.w3.org/2001/XInclude" |
| xmlns:src="http://nwalsh.com/xmlns/litprog/fragment" |
| xmlns:xsl="http://www.w3.org/1999/XSL/Transform" |
| version="5.0" xml:id="ulink.hyphenate"> |
| <refmeta> |
| <refentrytitle>ulink.hyphenate</refentrytitle> |
| <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo> |
| </refmeta> |
| <refnamediv> |
| <refname>ulink.hyphenate</refname> |
| <refpurpose>Allow URLs to be automatically hyphenated</refpurpose> |
| </refnamediv> |
| |
| <refsynopsisdiv> |
| <src:fragment xml:id="ulink.hyphenate.frag"> |
| <xsl:param name="ulink.hyphenate"></xsl:param> |
| </src:fragment> |
| </refsynopsisdiv> |
| |
| <refsection><info><title>Description</title></info> |
| |
| <para>If not empty, the specified character (or more generally, |
| content) is added to URLs after every character included in the string |
| in the <parameter>ulink.hyphenate.chars</parameter> parameter (default |
| is <quote>/</quote>) to enable hyphenation of ulinks. If the character |
| in this parameter is a Unicode soft hyphen (0x00AD) or Unicode |
| zero-width space (0x200B), some FO processors will be able to |
| reasonably hyphenate long URLs.</para> |
| |
| <para>Note that this hyphenation process is only applied when the |
| ulink element is empty and the url attribute is reused as the link |
| text. It is not applied if the ulink has literal text content. The |
| same applies in in DocBook 5, where ulink was replaced with link with |
| an xlink:href attribute.</para> |
| |
| </refsection> |
| </refentry> |