[2] | 1 | <refentry id="refentry.source.fallback.profile">
|
---|
| 2 | <refmeta>
|
---|
| 3 | <refentrytitle>refentry.source.fallback.profile</refentrytitle>
|
---|
| 4 | <refmiscinfo role="type">string</refmiscinfo>
|
---|
| 5 | </refmeta>
|
---|
| 6 | <refnamediv>
|
---|
| 7 | <refname>refentry.source.fallback.profile</refname>
|
---|
| 8 | <refpurpose>Specifies profile of "fallback" for refentry "source" data</refpurpose>
|
---|
| 9 | </refnamediv>
|
---|
| 10 |
|
---|
| 11 | <refsynopsisdiv>
|
---|
| 12 | <src:fragment id='refentry.source.fallback.profile.frag'>
|
---|
| 13 | <xsl:param name="refentry.source.fallback.profile">
|
---|
| 14 | refmeta/refmiscinfo[1]/node()</xsl:param>
|
---|
| 15 | </src:fragment>
|
---|
| 16 | </refsynopsisdiv>
|
---|
| 17 |
|
---|
| 18 | <refsect1><title>Description</title>
|
---|
| 19 |
|
---|
| 20 | <para>The value of
|
---|
| 21 | <parameter>refentry.source.fallback.profile</parameter> is a string
|
---|
| 22 | representing an XPath expression. It is evaluated at run-time and used
|
---|
| 23 | only if no "source" data can be found by other means (that is, either
|
---|
| 24 | using the <tag>refentry</tag> metadata-gathering logic "hard coded" in
|
---|
| 25 | the stylesheets, or the value of the
|
---|
| 26 | <parameter>refentry.source.name.profile</parameter> and
|
---|
| 27 | <parameter>refentry.version.profile</parameter> parameters, if those
|
---|
| 28 | are enabled).</para>
|
---|
| 29 |
|
---|
| 30 | <important>
|
---|
| 31 | <para>Depending on which XSLT engine you run, either the EXSLT
|
---|
| 32 | <function>dyn:evaluate</function> extension function (for xsltproc or
|
---|
| 33 | Xalan) or <function>saxon:evaluate</function> extension function (for
|
---|
| 34 | Saxon) are used to dynamically evaluate the value of
|
---|
| 35 | <parameter>refentry.source.fallback.profile</parameter> at
|
---|
| 36 | run-time. If you don't use xsltproc, Saxon, Xalan -- or some other
|
---|
| 37 | XSLT engine that supports <function>dyn:evaluate</function> -- you
|
---|
| 38 | must manually disable fallback processing by setting an empty value
|
---|
| 39 | for the <parameter>refentry.source.fallback.profile</parameter>
|
---|
| 40 | parameter.</para>
|
---|
| 41 | </important>
|
---|
| 42 |
|
---|
| 43 | </refsect1>
|
---|
| 44 | </refentry>
|
---|