DITA domain highlighting not working for <uicontrol>,

[Charlie Williams]

Hello,

In the library of DITA references is states this:
The bold (<b>) element is used to apply bold highlighting to the content of the element. Use this element only when there is not some other more proper element. For example, for specific items such as GUI controls, use the <uicontrol> element. This element is part of the DITA highlighting domain.

I'm using <uicontrol> and <wintitle> in a DITA task, and I'm using the ../dita/css/task.css file. The transformation is successful, but the bolded items inside the <wintitle> and <uicontrol> tags are not bold unless I enclose them in <b></b>. Why isn't the DITA highlighting domain working in this case?

Thanks,
Charlie

[sorin_ristache]

Hello,

If you allow oXygen to match your DITA Task XML document automatically with the predefined DITA document type defined in Options -> Preferences -> Document Type Association -- DITA then your document is based automatically on the dita.css stylesheet instead of the task.css one. The dita.css stylesheet already renders uicontrol and wintitle with a bolded font weight because it imports a special CSS module for defining the rendering of UI elements like uicontrol and wintitle. oXygen matches your DITA Task document with the predefined document type when you create the DITA Task document from menu File -> New -- From templates -- DITA Task or when you create a new document that has a task root element.

If you want to associate a CSS stylesheet explicitly in your DITA Task document you have to make sure that the elements will be rendered as you want.


Regards,
Sorin

[Charlie Williams]

Hello,
I created a new DITA Task document from menu File -> New -- From templates -- DITA Task with "task" as the root element. I did not attach a .css file. I clicked DITA to HTML transformation, and it "Failed to parse styhseet." I understood that creating a file from New > From Template would attach the correct .css stylesheet.

I'm sorry, but I guess I don't get it yet. Can you provide a little more information?
Here is what the From Temlpate inserts
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "http://docs.oasis-open.org/dita/v1.1/OS/dtd/task.dtd">

Regards,
Charlie

[sorin_ristache]

I created a new DITA Task document from menu File -> New -- From templates -- DITA Task with "task" as the root element. I did not attach a .css file. I clicked DITA to HTML transformation, and it "Failed to parse styhseet."

I did the same and the transformation scenario DITA to HTML was executed without error. I clicked on the Author tab and the DITA task was rendered using the predefined CSS stylesheet included in the DITA document type. Can you post here the content of the file created by the New -- From templates action?


Regards,
Sorin

[Charlie Williams]

Hello Sorin, Thanks for your reply.

1. I created a New > From Template > XML DITA - Task.
2. I copied > pasted content from an existing task topic.
3. Next I ran the transformation, "DITA to HTML" (default version).
3. The transformation was successful.
However, the bold weight did not appear for
<note type="important">
<uicontrol>License Administration Tool </uicontrol>
<wintitle>License Administration Tool</wintitle>

Here is the markup for the topic:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" "http://docs.oasis-open.org/dita/v1.1/OS/dtd/task.dtd">
<task id="SetPassword">
<title>
<b>Setting the administrator user password</b>
<!-- <keyword>setpassword administratorpassword</keyword> -->
</title>

<prolog>
<metadata>
<audience type="user"/>
<keywords>
<indexterm>administrator password<indexterm>set</indexterm></indexterm>
<indexterm>License Administration Tool<indexterm>adminstrator password</indexterm></indexterm>
<indexterm/>
</keywords>
</metadata>
</prolog>

<taskbody>
<prereq>
<note type="important">We strongly recommend that you write down your administrator user
password and save it in a safe place. If you forget your password, you have to call
Sage Customer Support to re-set it. </note>
<p>After the License Administration Tool has been successfully installed, clicking the
<uicontrol>License Administration Tool </uicontrol>
desktop icon opens the
<wintitle>Logon Administrator Password</wintitle>
window. </p>
<note type="important">Your License Administrator Tool password is case-sensitive. </note>
<p>
<b>To set the administrator user password:</b>
</p>
</prereq>
<steps>
<step>
<cmd>In the
<uicontrol>Password</uicontrol>
box, type a password.</cmd>
</step>
<step>
<cmd>In the
<uicontrol>Confirm Password</uicontrol>
box, re-type the password and then click
<uicontrol>OK. </uicontrol>
</cmd>
<info>The
<wintitle>License Administration Tool</wintitle>
window opens. From this window you can manage your product license, license
groups, and license use reservations.</info>
</step>
<step>
<cmd>In the
<uicontrol>Password</uicontrol>
box, type a password.</cmd>
</step>
</steps>

<!-- Links to external HFS -->
<postreq>
<lines>
<b>Did this topic help you?</b>
<xref href="http://sagemasterbuilder.com/customer_c ... MLtest">If yes, click this link to let us know. </xref>
<xref href="http://sagemasterbuilder.com/customer_c ... MLtest">If not or to leave a comment, then click here.</xref>
(Require access to the Internet.)
</lines>
</postreq>
<!-- /Links to external HFS -->

</taskbody>

<!-- help system internal links -->
<related-links>
<linklist>
<title>
<b>Links to more information</b>
</title>
<link href="AboutPassword">
<linktext>About the adminstrator user password</linktext>
</link>
<link href="ChangePassword">
<linktext>Change the administrator password</linktext>
</link>
<!-- <link href="SetPassword">
<linktext>Set the administrator password</linktext>
</link> -->
<link href="Re-setPassword">
<linktext>Re-set the administrator password</linktext>
</link>
</linklist>
</related-links>
<!-- help system internal links -->

</task>

Thanks for taking a look at this issue. I appreciate it.

Charlie

[sorin_ristache]

3. Next I ran the transformation, "DITA to HTML" (default version).
3. The transformation was successful.
However, the bold weight did not appear for
<note type="important">
<uicontrol>License Administration Tool </uicontrol>
<wintitle>License Administration Tool</wintitle>

The output of the XSLT transformation "DITA to HTML" depends on the DITA XSLT stylesheet which comes with the DITA Open Toolkit. For displaying the content of uicontrol, wintitle etc. with a bold weight you have to customize the DITA Open Toolkit stylesheets which you can find in [Oxygen-frameworks-folder]/dita/DITA-OT/xsl. In the Author mode of the XML editor panel these elements are rendered with bold weight because the CSS stylesheet of the DITA document type predefined in oXygen ([Oxygen-frameworks-folder]/dita/css/dita.css) specifies that.


Regards,
Sorin

[Charlie Williams]

Hello Sorin, and thanks for the reply with information about what I have to do. I appreciate it.

Regards,
Charlie