diff options
Diffstat (limited to 'kdoctools/docbook/xsl/params/nominal.image.width.xml')
| -rw-r--r-- | kdoctools/docbook/xsl/params/nominal.image.width.xml | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/kdoctools/docbook/xsl/params/nominal.image.width.xml b/kdoctools/docbook/xsl/params/nominal.image.width.xml new file mode 100644 index 000000000..f630af9c0 --- /dev/null +++ b/kdoctools/docbook/xsl/params/nominal.image.width.xml @@ -0,0 +1,38 @@ +<refentry id="nominal.image.width"> +<refmeta> +<refentrytitle>nominal.image.width</refentrytitle> +<refmiscinfo role="type">length</refmiscinfo> +</refmeta> +<refnamediv> +<refname>nominal.image.width</refname> +<refpurpose>The nominal image width</refpurpose> +</refnamediv> + +<refsynopsisdiv> +<src:fragment id='nominal.image.width.frag'> +<xsl:param name="nominal.image.width" select="6 * $pixels.per.inch"/> +</src:fragment> +</refsynopsisdiv> + +<refsect1><title>Description</title> + +<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> + +</refsect1> +</refentry> |