Sha256: eb3ba8338960b380fc432e0ede5ee63350bf12b9cd2be255f584e046c9de6ace

Contents?: true

Size: 1.66 KB

Versions: 20

Compression:

Stored size: 1.66 KB

Contents

<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>

Version data entries

20 entries across 20 versions & 5 rubygems

Version Path
git-scribe-qp-0.1.1 docbook-xsl/params/nominal.image.width.xml
couchbase-git-scribe-0.1.1.2 docbook-xsl/params/nominal.image.width.xml
couchbase-git-scribe-0.1.1.1 docbook-xsl/params/nominal.image.width.xml
booky-0.0.4 lib/stylesheets/params/nominal.image.width.xml
booky-0.0.3 lib/stylesheets/params/nominal.image.width.xml
booky-0.0.2 lib/stylesheets/params/nominal.image.width.xml
booky-0.0.1 lib/stylesheets/params/nominal.image.width.xml
git-scribe-0.1.1 docbook-xsl/params/nominal.image.width.xml
git-scribe-0.1.0 docbook-xsl/params/nominal.image.width.xml
bookshop-0.0.4 lib/bookshop/generators/bookshop/app/tools/xsl/1.76.1/params/nominal.image.width.xml
bookshop-0.0.3 lib/bookshop/generators/bookshop/app/tools/xsl/1.76.1/params/nominal.image.width.xml
git-scribe-0.0.9 docbook-xsl/params/nominal.image.width.xml
git-scribe-0.0.8 docbook-xsl/params/nominal.image.width.xml
git-scribe-0.0.7 docbook-xsl/params/nominal.image.width.xml
git-scribe-0.0.6 docbook-xsl/params/nominal.image.width.xml
git-scribe-0.0.5 docbook-xsl/params/nominal.image.width.xml
git-scribe-0.0.4 docbook-xsl/params/nominal.image.width.xml
bookshop-0.0.2.1 lib/bookshop/generators/bookshop/project/tools/xsl/1.76.1/params/nominal.image.width.xml
bookshop-0.0.2 lib/bookshop/generators/bookshop/project/tools/xsl/1.76.1/params/nominal.image.width.xml
bookshop-0.0.1 lib/bookshop/generators/bookshop/project/tools/xsl/1.76.1/params/nominal.image.width.xml