On 05/17/2017 10:45 AM, Grundtvig Nielsen Niels wrote:
Migrating another elderly document to DITA yesterday prompts a new
question … I’ve found and used the conversion parameter “show xref
page”, but I can already imagine places where it would not be quite
enough. Consider a task topic that uses <xref> elements both for
references to step numbers and for references to other topics: showing
page numbers in /Repeat steps 2 on page 1 to 5 on page 1/ is not
reader-friendly, but page numbers in /See also Section 4.8 on page 16/
make the cross-reference a lot more usable.
Restructuring the information and using the Related links concept to
replace in-line xrefs might not be a bad way to go – but finer control
over the formatting of xref output would be a help. I realise I’ve been
spoilt by years of working with FrameMaker :-}
With parameter:
number=all
and parameter:
xref-auto-text="number text"
(see
http://www.xmlmind.com/ditac/_distrib/doc/manual/xsltParams.html#xsltParams__xref-auto-text
; default value: "number")
and parameter:
show-xref-page=yes
(see
http://www.xmlmind.com/ditac/_distrib/doc/manual/xsltParams.html#xsltParams__show-xref-page
; default value "no")
you can already get in the generated PDF:
---
you cannot specify them in an XSLT stylesheet which customizes the stock
ones (as explained in Part II, Chapter 9, Section 2. Customizing the
look of the PDF files generated by ditac on page 63).
---
for this DITA source:
---
you cannot specify them in an XSLT stylesheet which customizes the stock
ones (as explained in <xref href="customAttributeSet.dita"/>).
---
Notice empty <xref>.
Note that "customAttributeSet.dita" is part of a bookmap and has a
"section" role.
Similar parameters exist for <link> elements.
--
XMLmind XML Editor Support List
[email protected]
http://www.xmlmind.com/mailman/listinfo/xmleditor-support