]> git.stg.codes - stg.git/blob - doc/xslt/params/page.margin.outer.xml
Help book chapter 1 complete
[stg.git] / doc / xslt / params / page.margin.outer.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="page.margin.outer">
7 <refmeta>
8 <refentrytitle>page.margin.outer</refentrytitle>
9 <refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
10 </refmeta>
11 <refnamediv>
12 <refname>page.margin.outer</refname>
13 <refpurpose>The outer page margin</refpurpose>
14 </refnamediv>
15
16 <refsynopsisdiv>
17 <src:fragment xml:id="page.margin.outer.frag"><xsl:param name="page.margin.outer">
18   <xsl:choose>
19     <xsl:when test="$double.sided != 0">0.75in</xsl:when>
20     <xsl:otherwise>1in</xsl:otherwise>
21   </xsl:choose>
22 </xsl:param></src:fragment>
23 </refsynopsisdiv>
24
25 <refsection><info><title>Description</title></info>
26
27 <para>The outer page margin is the distance from non-bound edge of the
28 page to the outer edge of the last column of text.</para>
29
30 <para>In left-to-right text direction,
31 this is the right margin of recto (front side) pages.
32 For single-sided output, it is the right margin
33 of all pages.</para>
34
35 <para>In right-to-left text direction,
36 this is the left margin of recto pages.
37 For single-sided output, this is the
38 left margin of all pages.</para>
39
40 <note>
41 <para>Current versions (at least as of version 4.13)
42 of the XEP XSL-FO processor do not
43 correctly handle these margin settings for documents
44 with right-to-left text direction.
45 The workaround in that situation is to reverse
46 the values for <parameter>page.margin.inner</parameter>
47 and <parameter>page.margin.outer</parameter>, until
48 this bug is fixed by RenderX.  It does not affect documents
49 with left-to-right text direction.</para>
50 </note>
51
52 </refsection>
53 </refentry>