OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

docbook message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: DocBook Assemblies and relationships


Hi,

I have some questions regarding the relationships in an assembly.

The TDG says:

  "Identifies relationships between resources. These
  relationships may be manifested in any number of
  structures during assembly."

I'm wondering how this looks like. The TDG gives an example how a relationship
looks like:

 <relationship type="seealso">
  <instance linkend="tut1"/>
  <instance linkend="tut2"/>
  <instance linkend="task1"/>
 </relationship>

Unfortunately, the TDG is a bit vague here. I suppose, it's because the
assemble.xsl stylesheet doesn't support it ATM. ;-)

So here are my questions regarding this topic:

1. How do I "attach" such a relationship to a structure?
   Do I have to add a xml:id in the <relationship> element
   and reference it in a <module>? Is that enough? Anything else?

2. What should I do if I have several structures in my assembly
   file and different relationships?
   I assume, I need to write all combinations, right? There is
   no way that one relationship can "inherit" from the other?
   For example, I would like to have at the end of each
   structure a "See also" and a "What's next?" reference.
   Would a relationship be a good fit? Or should I use something
   else?

3. How would you implement to resolve the relationships in the
   stylesheet? Could there be a "basic" implementation?


Thanks for your ideas! Much appreciated.


--
GruÃ/Regards
  Thomas Schraitle


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]