Love the new resource manager, but ...

[ptc-925411]

I love the new resource manager in Epic 5.3. It’s
a quick way to insert xrefs or conrefs into my DITA XML files. One
problem, though – I want the path to be relative, rather than including a
full path.







In other words, if I’m working in the file
c:\dev\doc\main\help\feature1\foo.xml, and I want to include an xref to c:\dev\doc\main\help\feature2\bar.xml,
the href attribute on the xref is “c:\dev\doc\main\help\feature2\bar.xml”.
I want it to be “..\feature2\bar.xml”.







Is this possible?







Steve

[kmccook]

Go into the Help files under "DITA
content reference overview". It gives you the information onhow to
accomplish this:

"Content references are defined by an attribute in your document type.
The attribute is defined in the document type configuration file (<tt>size=3>.dcf</tt>) file. For DITA documents, the <tt>size=3>conref</tt> attribute is available on most DITA elements and is
used as the content reference attribute.
In the content reference attribute, the string that references an element in
a DITA topic has the following format:


<tt>size=3>[[path/]filename][#topic-id[/element-id]]</tt>


<tt>[[path/]filename]</tt> is an optional
reference to the file containing the reference. It may be an absolute or
relative filename and may include path components. If the filename is not
specified, the reference is assumed to be in the current document. If an
absolute filename is not specified, the content reference is resolved using the
DITA references path.class=873053017-16012007>"

---

From: Steven Anderson

Sent: Tuesday, January 16, 2007
12:18 PM
To: arbortext-adepters
Subject: Love the new
resource manager, but ...

style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">I love the new resource manager in
Epic 5.3. It’s a quick way to insert xrefs or conrefs into my DITA XML
files. One problem, though – I want the path to be relative, rather than
including a full path.


style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">


style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">In other words, if I’m working in
the file c:\dev\doc\main\help\feature1\foo.xml, and I want to include an xref to
c:\dev\doc\main\help\feature2\bar.xml, the href attribute on the xref is
“c:\dev\doc\main\help\feature2\bar.xml”. I want it to be
“..\feature2\bar.xml”.


style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">


style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">Is this possible?


style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">


style="FONT-SIZE: 10pt; FONT-FAMILY: Arial">
Steve

>> To unsubscribe from the list, send an
email to listmanager@maillist.arbortext.com with the following in the body:
unsubscribe adepters - For additional information on the adepters list (how to
subscribe or unsubscribe etc), send an email to:
listmanager@maillist.arbortext.com with the following in the body: info Adepters
- You may also go to forums.arbortext.com, enter the Adepters folder and change
your subscription options and preferences.>>

[unknown1]

You need to include c:\dev\doc\main\help\ in your DITA path.

When you insert a reference into a DITA document, we attempt to create relative references by processing them against 1) the base URI, (2) the document directory, if different from the base URI, and (3) the list of directories on the ditapath list, if any.

The DITA references resolved by the ditapath variable include topic references, content references, links, cross references, and any other DITA element that references content.

You can set the value of the APTDITAPATH environment variable or set the DITA references preference available under the File Locations category in Preferences. Look for ditapath in the online help for additional details.

Also, something else that catches folks off gaurd, you need to save the document before we can make paths relative to the document directory.

Robin

[mkocik]

I'm trying to do the same thing, but I'm having no luck. The Help topics referenced here do not provide enough detail. I've addedthe partial path to my documents' location in the Dita References field (e.g., "C:\dev\doc\main\help" using Tools > Preferences), but Resource Manager still inserts absolute paths.

There was mention of editing the DCF file, but other than specifying 'ditaConrefAttribute', is there something else?