<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
</head>
<body text="#000000" bgcolor="#FFFFFF">
<p>Hello,</p>
<p>As a general rule, it is recommended to keep all changes outside
the WebHelp plugin. This allows you to easily upgrade to a new
WebHelp distribution.</p>
<p>The following customization methods are available:</p>
<p>1. Create a WebHelp publishing template</p>
A publishing template It is a self-contained customization package
stored as a ZIP archive or folder that can easily be shared with
others. It provides the primary method for customizing the output
allowing you to:<br>
* Customize various aspects of the output through simple CSS
styling.<br>
* Extend the default processing by specifying one or more XSLT
extension points.<br>
* Specify one or more transformation parameters to customize the
output.
<p>More information is available in our <a moz-do-not-send="true"
href="https://www.oxygenxml.com/doc/versions/21.1/ug-webhelp-responsive/topics/whr-publishing-template.html">documentation</a>
or <a moz-do-not-send="true"
href="https://www.oxygenxml.com/demo/opt.html">video
presentation</a>.<br>
</p>
<p>2. Create DITA-OT extension plugin<br>
</p>
<p>This method allows you to use one of <a moz-do-not-send="true"
href="https://www.oxygenxml.com/doc/versions/21.1/ug-webhelp-responsive/topics/whr-responsive-override-xslt-dita-xslt-import.html">WebHelp
XSLT extension points</a> and it is preferable to use if you
want to affect all WebHelp transformations.</p>
<p>Regarding to your questions to change generated text for task
topic, the single available option is to create a DITA-OT
extension plugin.<br>
</p>
<p>
<blockquote type="cite">If I want to change the task labels that
are used when the arg.gen.task.lbl parameter is specified, how
do I accomplish this?</blockquote>
Please see the <a moz-do-not-send="true"
href="https://www.oxygenxml.com/doc/versions/21.1/ug-webhelp-responsive/topics/localize-webhelp-responsive.html#ariaid-title2">Modifying
the Existing Strings</a> procedure from our manual for this
task.<br>
</p>
<p><br>
<blockquote type="cite">If I want to ensure that a task label is
generated for the <tasktroubleshooting> element, how do I
accomplish this?</blockquote>
For the elements that have not associated a label in the 'strings'
files, like <tasktroubleshooting> element, you need also to
contribute an XSLT template that lookup in the string files. <br>
</p>
<p>
<blockquote type="cite"><xsl:template
match="*[contains(@class,' task/tasktroubleshooting ')]"
mode="dita2html:section-heading"><br>
<xsl:apply-templates select="."
mode="generate-task-label"><br>
<xsl:with-param name="use-label"><br>
<xsl:call-template name="getVariable"><br>
<xsl:with-param name="id"
select="'task_tasktroubleshooting'"/><br>
</xsl:call-template><br>
</xsl:with-param><br>
</xsl:apply-templates><br>
</xsl:template></blockquote>
The XSLT stylesheet can be contributed using the <i>dita.xsl.html5</i>
XSLT extension point:<br>
</p>
<p>
<blockquote type="cite"><feature extension="dita.xsl.html5"
file="task_labels.xsl"/></blockquote>
</p>
Regards,
<pre class="moz-signature" cols="72">Radu
--
Radu Pisoi
<oXygen/> XML Editor, Schema Editor and XSLT Editor/Debugger
<a class="moz-txt-link-freetext" href="http://www.oxygenxml.com">http://www.oxygenxml.com</a></pre>
<div class="moz-cite-prefix">On 12/10/2019 5:56 AM, Kristen James
Eberlein wrote:<br>
</div>
<blockquote type="cite"
cite="mid:55e15a26-4961-b8cc-8fed-f11a22ebdb7f@eberleinconsulting.com">
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<p>I have questions about the best (and best practices) way to
override default Web Help processing.</p>
<ul>
<li>If I want to change the task labels that are used when the
arg.gen.task.lbl parameter is specified, how do I accomplish
this?</li>
<li>If I want to ensure that a task label is generated for the
<tasktroubleshooting> element, how do I accomplish this?</li>
</ul>
<p>I know how to effect these changes in a standard DITA-OT
plug-in, but I am not sure how best to override the logic for
oXygen Web Help. Can this be done in a Web Help template, or do
I need to create a DITA-OT plug-in?</p>
<p>For this client, I want to keep everything as simple and
modular as I can, to make moving to new versions of oXygen
possible. (I am in the midst of unraveling all the many changes
that they hacked into oXygen plug-ins ...)<br>
</p>
<div class="moz-signature">-- <br>
Best,<br>
Kris<br>
<br>
Kristen James Eberlein<br>
Chair, OASIS DITA Technical Committee<br>
Principal consultant, Eberlein Consulting<br>
<a class="moz-txt-link-abbreviated"
href="http://www.eberleinconsulting.com"
moz-do-not-send="true">www.eberleinconsulting.com</a><br>
+1 919 622-1501; kriseberlein (skype)<br>
<br>
</div>
<br>
<fieldset class="mimeAttachmentHeader"></fieldset>
<pre class="moz-quote-pre" wrap="">_______________________________________________
oXygen-user mailing list
<a class="moz-txt-link-abbreviated" href="mailto:oXygen-user@oxygenxml.com">oXygen-user@oxygenxml.com</a>
<a class="moz-txt-link-freetext" href="https://www.oxygenxml.com/mailman/listinfo/oxygen-user">https://www.oxygenxml.com/mailman/listinfo/oxygen-user</a>
</pre>
</blockquote>
</body>
</html>