summaryrefslogtreecommitdiff
path: root/params/nominal.image.width.xml
diff options
context:
space:
mode:
authorPatrick McCarty <patrick.mccarty@linux.intel.com>2012-06-12 14:05:47 -0700
committerPatrick McCarty <patrick.mccarty@linux.intel.com>2012-06-12 14:58:00 -0700
commit0ebc96393cd7cd5c861276ae733307bd7b8d87f7 (patch)
tree899f86030089e8daa5eaf48af5b8b5b7780998d6 /params/nominal.image.width.xml
parent7f26f4160c974d34117c14272d3e4f56a471e8f1 (diff)
downloaddocbook-xsl-master.tar.gz
docbook-xsl-master.tar.bz2
docbook-xsl-master.zip
Import docbook-xsl packageHEAD2.0_alphamaster2.0alpha1.0_post
Required package for building systemd man pages. Change-Id: I0a200a2340a5aea24898b428b8e9b55da57e3e5b Signed-off-by: Patrick McCarty <patrick.mccarty@linux.intel.com>
Diffstat (limited to 'params/nominal.image.width.xml')
-rw-r--r--params/nominal.image.width.xml43
1 files changed, 43 insertions, 0 deletions
diff --git a/params/nominal.image.width.xml b/params/nominal.image.width.xml
new file mode 100644
index 0000000..bfa989a
--- /dev/null
+++ b/params/nominal.image.width.xml
@@ -0,0 +1,43 @@
+<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="nominal.image.width">
+<refmeta>
+<refentrytitle>nominal.image.width</refentrytitle>
+<refmiscinfo class="other" otherclass="datatype">length</refmiscinfo>
+</refmeta>
+<refnamediv>
+<refname>nominal.image.width</refname>
+<refpurpose>The nominal image width</refpurpose>
+</refnamediv>
+
+<refsynopsisdiv>
+<src:fragment xml:id="nominal.image.width.frag">
+<xsl:param name="nominal.image.width" select="6 * $pixels.per.inch"/>
+</src:fragment>
+</refsynopsisdiv>
+
+<refsection><info><title>Description</title></info>
+
+<para>Graphic widths expressed as a percentage are problematic. In the
+following discussion, we speak of width and contentwidth, but
+the same issues apply to depth and contentdepth.</para>
+
+<para>A width of 50% means "half of the available space for the image."
+That's fine. But note that in HTML, this is a dynamic property and
+the image size will vary if the browser window is resized.</para>
+
+<para>A contentwidth of 50% means "half of the actual image width".
+But what does that mean if the stylesheets cannot assess the image's
+actual size? Treating this as a width of 50% is one possibility, but
+it produces behavior (dynamic scaling) that seems entirely out of
+character with the meaning.</para>
+
+<para>Instead, the stylesheets define a
+<parameter>nominal.image.width</parameter> and convert percentages to
+actual values based on that nominal size.</para>
+
+</refsection>
+</refentry>