Benoit Maisonny wrote:
>
> When a user customizes a parameter for a docbook conversion, he can
> click on the documentation link which opens the web browser on the
> relevant page in docbook.sourceforge.net.
>
> Is it possible to give our own URL for our own add-ons?
Sure. All this will be documented in next release.
Meanwhile please find here excerpts of this future documentation:
---
<transform
stylesheet = anyURI
cacheStylesheet = boolean : false
file = Path
to = Path
label = Non empty token
documentation = anyURI possibly containing a %{parameter.name} variable
>
Content: [ parameter | parameterGroup ]*
</transform>
label
Specifying this label allows to use the dialog box displayed by
Options -> Customize Configuration -> Change Document
Conversion Parameters in order to easily parametrize the XSLT
style sheet. However, just specifying a label attribute for the
transform element is not sufficient in order to use this
facility. In addition, the last child element of the transform
element must be a parameterGroup. XHTML example:
<transform stylesheet="xsl/fo.xsl"
file="__doc.xml" to="__doc.fo"
label="Convert to PDF, PostScript">
<parameterGroup name="xhtml.toPS.transformParameters" />
</transform>
documentation
Like label, this attribute is also used by the dialog box
displayed by Options -> Customize Configuration -> Change
Document Conversion Parameters. Specifying an URL here allows
the dialog box to display the documentation of the XSLT style
sheet in the web browser of the user.
If the specified URL contains a %{parameter.name} variable,
this variable is replaced by the name of the XSLT style sheet
parameter (e.g. paper.type) currently selected by the user.
If the specified URL contains a
%{parameter.name|fallback_parameter_name} variable, this
variable is replaced by the name of the XSLT style sheet
parameter currently selected by the user. And if the user has not
selected a parameter in the dialog box then
fallback_parameter_name is used instead. DocBook example:
<transform stylesheet="xsl/fo/docbook.xsl"
file="__doc.xml" to="__doc.fo"
label="Convert to RTF, WordprocessingML, OpenDocument, OOXML"
documentation="http://docbook.sourceforge.net/release/xsl/current/doc/fo/%{parameter.name|paper.type}.html">
...
<parameter name="paper.type">A4</parameter>
...
<parameterGroup name="docb.toRTF.transformParameters" />
</transform>
---
> Something related to cfg:help would be great.
I'm sorry but for now, this is not possible. Note that the above URL is
displayed by the web browser of the user and not by the JavaHelp
browser. (To my knowlegde, a web browser cannot open jar:XXX URLs.)
