Magnus G?fvert wrote: >> Use xref and link elements and type the linkend attribute as if the >> document module was part of the master document. XXE currently provides >> no assistance in doing that. You are currently forced to know the link >> targets ``by heart''. >> > This was my first attempt, but I quickly lost track of the id:s. And I > am not sure that I got it to produce correct links, but since you > confirm that it works I will try again. I guess that one problem with > this approach is that the individual document parts won't validate since > the linked id:s cannot be resolved locally?
Create the links in the modules and then open the master document. This will report broken links. >> >>> * Are there any good tutorial style web resources on modular documents >>> and cross-referencing (using xxe)? >>> > Perhaps you could add some cross-document links to your modular example > documents to illustrate the proposed practice? Yes, we intend to do that. >> --> Now, the good news. XXE v4.6 will have a "Link tool". This new tool >> should solve the following problem: quickly and easily create links in >> modular documents. >> > This sounds very promising. I guess we will wait with marking up cross > referencing until this version becomes available. This implies that, when it comes to modular documents, XXE is unusable without the "Link tool". This simply not true. We do not recommend to wait until the "Link tool" is released because unlike indexing, cross-referencing is an integral part of writing a document. > Is there any estimate > on release date (roughly)? Would be good to know if it is 1 month, 6 > months, or a year. Around February 2010. XXE is released approximately every 2-3 months. >> This new tool will use ``master documents'' as ``link contexts''. >> > Will this mean that each document module (file) is validated? No. This will just allow to safely and quickly insert xref, link, olink, etc. (This is our current idea: we haven't started working on the "Link tool" yet.) >> A master document is: >> >> * Any XML document making use of XIncludes. >> > Such as a docbook book file with XIncludes? >> * OR A DITA map or bookmap. >> >> * OR A synthetic map, mapping unique identifiers to DocBook documents. >> This should allow to quickly insert olinks. >> > I don't fully understand this one. Something similar to docbook master > target database sitemaps? No, much simpler, a simple list created from within XXE. Remember that an olink is simply the identifier of a document + optionally an ID found in this document. (This is our current idea: we haven't started working on the "Link tool" yet.)
