diff options
author | Christoph Helma <helma@in-silico.ch> | 2011-03-11 14:29:13 +0100 |
---|---|---|
committer | Christoph Helma <helma@in-silico.ch> | 2011-03-11 14:29:13 +0100 |
commit | 96d500e9691eedbfdd57ec35a2572b59641377f3 (patch) | |
tree | 211391f36e269bf36ca09d54aab0d93ababfa412 /docbook-xsl-1.76.1/params/use.role.for.mediaobject.xml | |
parent | 5f243f1e9e0a8e12cd8a2267bcec3140d21bf445 (diff) | |
parent | 7cd9c9656010b88b7e41477e1571cb7e722650c4 (diff) |
Merge branch 'release/v1.0.1'v1.0.1
Diffstat (limited to 'docbook-xsl-1.76.1/params/use.role.for.mediaobject.xml')
-rw-r--r-- | docbook-xsl-1.76.1/params/use.role.for.mediaobject.xml | 56 |
1 files changed, 56 insertions, 0 deletions
diff --git a/docbook-xsl-1.76.1/params/use.role.for.mediaobject.xml b/docbook-xsl-1.76.1/params/use.role.for.mediaobject.xml new file mode 100644 index 0000000..9241ace --- /dev/null +++ b/docbook-xsl-1.76.1/params/use.role.for.mediaobject.xml @@ -0,0 +1,56 @@ +<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="use.role.for.mediaobject"> +<refmeta> +<refentrytitle>use.role.for.mediaobject</refentrytitle> +<refmiscinfo class="other" otherclass="datatype">boolean</refmiscinfo> +</refmeta> +<refnamediv> +<refname>use.role.for.mediaobject</refname> +<refpurpose>Use <tag class="attribute">role</tag> attribute +value for selecting which of several objects within a mediaobject to use. +</refpurpose> +</refnamediv> + +<refsynopsisdiv> +<src:fragment xml:id="use.role.for.mediaobject.frag"> +<xsl:param name="use.role.for.mediaobject" select="1"/> +</src:fragment> +</refsynopsisdiv> + +<refsection><info><title>Description</title></info> + +<para>If non-zero, the <tag class="attribute">role</tag> attribute on +<tag>imageobject</tag>s or other objects within a <tag>mediaobject</tag> container will be used to select which object will be +used. +</para> +<para> +The order of selection when then parameter is non-zero is: +</para> +<orderedlist> +<listitem> + <para>If the stylesheet parameter <parameter>preferred.mediaobject.role</parameter> has a value, then the object whose role equals that value is selected.</para> +</listitem> +<listitem> +<para>Else if an object's role attribute has a value of +<literal>html</literal> for HTML processing or +<literal>fo</literal> for FO output, then the first +of such objects is selected. +</para> +</listitem> +<listitem> +<para>Else the first suitable object is selected.</para> +</listitem> +</orderedlist> +<para> +If the value of +<parameter>use.role.for.mediaobject</parameter> +is zero, then role attributes are not considered +and the first suitable object +with or without a role value is used. +</para> +</refsection> +</refentry> |