]> git.stg.codes - stg.git/blob - doc/help/xslt/params/hyphenate.verbatim.xml
--stringparam base.path replaces with -o
[stg.git] / doc / help / xslt / params / hyphenate.verbatim.xml
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="hyphenate.verbatim">
7 <refmeta>
8 <refentrytitle>hyphenate.verbatim</refentrytitle>
9 <refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo>
10 </refmeta>
11 <refnamediv>
12 <refname>hyphenate.verbatim</refname>
13 <refpurpose>Should verbatim environments be hyphenated on space characters?</refpurpose>
14 </refnamediv>
15
16 <refsynopsisdiv>
17 <src:fragment xml:id="hyphenate.verbatim.frag"><xsl:param name="hyphenate.verbatim" select="0"/></src:fragment>
18 </refsynopsisdiv>
19
20 <refsection><info><title>Description</title></info>
21
22 <para>If the lines of program listing are too long to fit into one
23 line it is quite common to split them at space and indicite by hook
24 arrow that code continues on the next line. You can turn on this
25 behaviour for <tag>programlisting</tag>,
26 <tag>screen</tag> and <tag>synopsis</tag> elements by
27 using this parameter.</para>
28
29 <para>Note that you must also enable line wrapping for verbatim environments and
30 select appropriate hyphenation character (e.g. hook arrow). This can
31 be done using <parameter>monospace.verbatim.properties</parameter>
32 attribute set:</para>
33
34 <programlisting>&lt;xsl:attribute-set name="monospace.verbatim.properties" 
35                    use-attribute-sets="verbatim.properties monospace.properties"&gt;
36   &lt;xsl:attribute name="wrap-option"&gt;wrap&lt;/xsl:attribute&gt;
37   &lt;xsl:attribute name="hyphenation-character"&gt;&amp;#x25BA;&lt;/xsl:attribute&gt;
38 &lt;/xsl:attribute-set&gt;</programlisting>
39
40 <para>For a list of arrows available in Unicode see <uri xlink:href="http://www.unicode.org/charts/PDF/U2190.pdf">http://www.unicode.org/charts/PDF/U2190.pdf</uri> and <uri xlink:href="http://www.unicode.org/charts/PDF/U2900.pdf">http://www.unicode.org/charts/PDF/U2900.pdf</uri> and make sure that
41 selected character is available in the font you are using for verbatim
42 environments.</para>
43
44 </refsection>
45 </refentry>