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