ulink.hyphenate.xml 1.5 KB

123456789101112131415161718192021222324252627282930313233343536373839
  1. <refentry xmlns="http://docbook.org/ns/docbook"
  2. xmlns:xlink="http://www.w3.org/1999/xlink"
  3. xmlns:xi="http://www.w3.org/2001/XInclude"
  4. xmlns:src="http://nwalsh.com/xmlns/litprog/fragment"
  5. xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
  6. version="5.0" xml:id="ulink.hyphenate">
  7. <refmeta>
  8. <refentrytitle>ulink.hyphenate</refentrytitle>
  9. <refmiscinfo class="other" otherclass="datatype">string</refmiscinfo>
  10. </refmeta>
  11. <refnamediv>
  12. <refname>ulink.hyphenate</refname>
  13. <refpurpose>Allow URLs to be automatically hyphenated</refpurpose>
  14. </refnamediv>
  15. <refsynopsisdiv>
  16. <src:fragment xml:id="ulink.hyphenate.frag">
  17. <xsl:param name="ulink.hyphenate"></xsl:param>
  18. </src:fragment>
  19. </refsynopsisdiv>
  20. <refsection><info><title>Description</title></info>
  21. <para>If not empty, the specified character (or more generally,
  22. content) is added to URLs after every character included in the string
  23. in the <parameter>ulink.hyphenate.chars</parameter> parameter (default
  24. is <quote>/</quote>) to enable hyphenation of ulinks. If the character
  25. in this parameter is a Unicode soft hyphen (0x00AD) or Unicode
  26. zero-width space (0x200B), some FO processors will be able to
  27. reasonably hyphenate long URLs.</para>
  28. <para>Note that this hyphenation process is only applied when the
  29. ulink element is empty and the url attribute is reused as the link
  30. text. It is not applied if the ulink has literal text content. The
  31. same applies in in DocBook 5, where ulink was replaced with link with
  32. an xlink:href attribute.</para>
  33. </refsection>
  34. </refentry>