Philippe Coq wrote:
> I really appreciate your help and I hope that I don't disturb you too!
> It is possible that I ask some newbies question because I am new on
> DocBook subject
> and new on XMLmind XML Editor.
> In fact I am working on an open source projec JOnAS
> http://jonas.objectweb.org/
> and I am in charge to refactor the documentation process.
> Until now JOnAS documentation was directly written in html. We have
> decided to rewrite it with DocBook. A collegue of mine (leader of the
> easybeans project http://easybeans.objectweb.org/) tell me that he uses
> XMLmind XML Editor for buildind its doc and was very happy with this tool.
> I begin to use it since some days and indeed I appreciate it even I am
> not sure to know all the possibilities.
> In a first step I have tried to convert old JOnAS doc html to docBook
> automatically.
> Then I was wondering how to convert links between two html parts of the
> doc.
> I thought that the <olink> mecanism is well suited for this but it is
> complicated.
> You told me you didn't use this.
> How do you do with XMLmind XML Editor a named link between a DocBook
> document
> towards a part of another DocBook document?
Very simple. We assume that the other DocBook document will be converted
to HTML and we use an <ulink> element that points to the converted HTML
page.
The XSL DocBook style sheets make it easy knowing the name of each
generated HTML page.
If:
* you add an "id" attribute to DocBook chapters, sections, etc,
* and you use the HTML conversion which produces a set of linked HTML pages,
* and pass parameters similar to what follows to the XSLT engines
---
use.id.as.filename=1
chunk.section.depth=2
---
Then, you control the name of each generated HTML page.
Example, with the above parameters:
---
<chapter id="commandref">
...
<section id="beep">
<title>beep</title>
<para>No parameter.</para>
<para>Emits an audio beep.</para>
<para>This command is useful to write macro-commands.</para>
</section>
---
is transformed to beep.html. Therefore I can point to it.
---
PS: We, too, need to generate our documents using makefiles/ant build
files. For this, we use command "convertdoc", which allows to run XXE
process commands outside XXE. More info. in
http://www.xmlmind.com/xmleditor/_distrib/doc/commands/convertdoc.html
