Pages: 1
Print
Author Topic: Link text problem in pdf  (Read 5384 times)
Jren
Member

Posts: 13

Jeff Reynolds - come see me on Linkedin.


« on: December 10, 2009, 01:34:15 PM »

Hi folks,
I'm new.  Bear with me as I ramp.

I am creating xrefs in a step procedure.  Link text appears correctly in .chm and Web Help.  When I render .pdf the link text say List item.  I assume it is reading it off of the type attribute.  What is my work around?

ver: Shiny new copy of Xmetal 6
OS: XP

TIA,
JREN
Logged
Derek Read
Program Manager (XMetaL)
Administrator
Member

Posts: 2621



WWW
« Reply #1 on: December 10, 2009, 02:12:45 PM »

Can you post one or two files as samples?

There are limitations with various outputs that are inherent to the DITA Open Toolkit and this might be one of those, however, there may also be workarounds.
Logged
Jren
Member

Posts: 13

Jeff Reynolds - come see me on Linkedin.


« Reply #2 on: December 10, 2009, 02:28:52 PM »

Hi Derek,

Thanks for the quick response.

Please see step 17, with 18 and 19 as destinations for the 2 xrefs.

screen caps of source and pdf attached...


* pdf_cap.jpg (153.09 KB, 1197x934 - viewed 611 times.)

* xmetal_cap.jpg (315.76 KB, 1280x1024 - viewed 650 times.)
Logged
Su-Laine Yeo
Solutions Consultant
Member

Posts: 260


« Reply #3 on: December 14, 2009, 05:08:33 PM »

This is a known issue with the DITA Open Toolkit. A description of the problem, along with a workaround for it, is posted here:

http://sourceforge.net/tracker/?func=detail&atid=725074&aid=1839827&group_id=132728

If you run into difficulty implementing the workaround, please let us know.
Logged

Su-Laine Yeo
Solutions Consultant
JustSystems Canada, Inc.
Su-Laine Yeo
Solutions Consultant
Member

Posts: 260


« Reply #4 on: December 24, 2009, 01:18:58 PM »

One more thing: If you are using XMetaL 5.5 or higher and have not changed the "user-setting-mode" parameter in your xmetalx.x.ini file, XMetaL uses a copy of the Open Toolkit that is located here:


C:\Documents and Settings\[USER]\Application Data\SoftQuad\XMetaL Shared\DITA_OT\

Any configurations you make to the Open Toolkit need to go into this folder. So for the abovementioned workaround, you need to change the links.xsl file located here:

C:\Documents and Settings\[USER]\Application Data\SoftQuad\XMetaL Shared\DITA_OT\demo\xmfo\xsl\fo

« Last Edit: December 24, 2009, 01:21:56 PM by Su-Laine Yeo » Logged

Su-Laine Yeo
Solutions Consultant
JustSystems Canada, Inc.
Derek Read
Program Manager (XMetaL)
Administrator
Member

Posts: 2621



WWW
« Reply #5 on: January 04, 2010, 04:50:27 PM »

To clarify things (hopefully) readers may wish to also read the following post regarding deployment of the DITA OT (to make sure you are modifying the right copy):

http://forums.xmetal.com/index.php/topic,237.0.html

I would recommend not altering the user-setting-mode INI variable unless your organization has been told to do so for some specific reason. Altering (disabling) the per-user functionality in the 5.5 or 6.0 releases will often disable operation of the DITA OT for all but true admin users because the DITA OT will then attempt to write to restricted areas of the OS (C:\Program Files in most cases). This is why it is "deployed" to you %appdata% folder (which is guaranteed to be writable for you).
Logged
Chris
Solutions Consultant (XMetaL)
Member

Posts: 18


« Reply #6 on: January 07, 2010, 01:53:53 PM »

All,

Here's a code snippet you can paste into links.xsl to generate the link text for task steps. The file links.xsl is in the xmfo folder:

[DITA_OT]/demo/xmfo/xsl/links.xsl

Paste it *before* the xsl:when for topic/li (an excerpt of the topic/li xsl:when is shown below):

<xsl:template name="insertReferenceTitle">

... (omitted for brevity) ...

<!-- [XM 20091224] This template  generates the link text e.g. "Step 5" for links to task steps -->
<xsl:when test="$element[contains(@class, ' task/step ')]">
<xsl:message>[XM 20091224] XMetaL task step link mod</xsl:message>
<xsl:choose>
    <xsl:when test="$element/parent::*[contains(@class, ' task/steps ')]">
   <!-- Best practice: localize this text via the "insertVariable" template -->
   <xsl:text>Step </xsl:text>
   <xsl:value-of select="count($element/ancestor-or-self::*[ contains( @class, ' topic/li ' ) ][ 1 ]/preceding-sibling::*[ contains( @class, ' topic/li ' ) ] ) + 1" />
    </xsl:when>
    <xsl:otherwise>
   <xsl:call-template name="insertVariable">
       <xsl:with-param name="theVariableID" select="'List item'"/>
   </xsl:call-template>
    </xsl:otherwise>
</xsl:choose>
</xsl:when>
<!-- END [XM 20091224] XMetaL task step link mod -->

<xsl:when test="$element[contains(@class, ' topic/li ')]">
... (omitted for brevity) ...
</xsl:when>

... (omitted for brevity) ...

</xsl:template>

Remember to read the following post regarding deployment of the DITA OT (to make sure you are modifying the right copy of links.xsl):

http://forums.xmetal.com/index.php/topic,237.0.html

HTH,

- Chris
Logged

Chris Johnson
XMetaL Services
Pages: 1
Print
Jump to: