stylesheets/styleguide/docbook-xsl-1.75.2/params/refentry.source.fallback.profile.xml

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