diff options
author | Patrick McCarty <patrick.mccarty@linux.intel.com> | 2012-06-12 14:05:47 -0700 |
---|---|---|
committer | Patrick McCarty <patrick.mccarty@linux.intel.com> | 2012-06-12 14:58:00 -0700 |
commit | 0ebc96393cd7cd5c861276ae733307bd7b8d87f7 (patch) | |
tree | 899f86030089e8daa5eaf48af5b8b5b7780998d6 /params/nominal.image.width.xml | |
parent | 7f26f4160c974d34117c14272d3e4f56a471e8f1 (diff) | |
download | docbook-xsl-master.tar.gz docbook-xsl-master.tar.bz2 docbook-xsl-master.zip |
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.xml | 43 |
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> |