I'd like to share some observations I've made while trying to transform
a legacy text document to Docbook 5.0.

The source actually is a textile formatted piece of text. While there
certainly are easier ways to do a conversion to DocBook I wanted to gain
some experience in modifying and restructuring a document because this
will be the main purpose of the exercise: gather pieces of information
scattered over a number of Wikis and How-to's and create a consolidated
and well structured document that can be published as HTML, PDF, etc.

Thus I created a book and a chapter each in a single file, the book
referencing the chapter, This works fine.
Then I created a section in the chapter and tried to copy the source
text into the chapter. Not too surprisingly all white space is treated
the same, i.e. line feeds are not seen as line feeds any more. So I
wrapped every line in a <para></para> before importing. Better.

Now I tried to recreate the original structure by using the different
insert, paste, replace, and convert commands as explained in the
tutorial.
I had a really hard time because most of it did not work as expected...
I must be doing something wrong.
Now I ran a validation and worked through the findings: naturally, there
were a couple of tags coming from the textile markup like </pre> etc.
Once I eliminated all errors things became a lot easier because commands
which behaved confusing now worked as expected. 

However, there are still some obscurities:

The document showed no validation errors when I closed it. After
reopening the document (in the context of the book) I performed a
validation again and the following error was found:
The number of seg elements must be the same as the number of segtitle
elements in the parent segmentedlist 
Obviously only one seg element is allowed. But if I select a seg node
and try 'insert after' the only element offered is 'seg'. How can that
be?

Similarly, other tags inserted using insert or paste created errors
because the tags were not allowed at this place. Shouldn't xxe avoid
this in the first place?  What am I doing wrong?

I expected that a series of paras could be converted to an itemizedlist
by selecting the paras and applying either convert[wrap] or replace:
convert[wrap] does not offer 'itemizedlist', replace does but creates an
empty list and the contents of the selected paras are lost. So how can
this be done?

I created another document and some elements within the document, e.g.
an 'informaltable'. I can select an element and choose copy but when I
move to another document within xxe Paste is not offered. Can elements
not be copied between different documents?

Don't get me wrong. XXE appears to be a great product. The tutorials are
good in their shortness (otherwise no one would read them).
But in some cases I seem to miss the obvious ...

Thanks
Hans  



Kassensysteme
Warenwirtschaft
Vernetzung
__________________________
Hans Artmann
Flüggenstr. 10
80639 München
Tel +49 89 17095721
Fax +49 89 17095722
Mob +49 151 17413090
www.arcasys.de

Ust-Id: DE261339573

<<attachment: arcasys_75_small.gif>>

 
--
XMLmind XML Editor Support List
[email protected]
http://www.xmlmind.com/mailman/listinfo/xmleditor-support

Reply via email to