Hi, On Tuesday 09 May 2006 18:58, jdd wrote:
Thomas Schraitle wrote:
Thanks! I tried it with the documentation page of the openSUSE wiki.
But ... the problem is still the same. :-( It is just a nice wrapper around the original text filled with some metainformation. No semantics.
what I said is that "xml" is nor the problem nor the solution. nowaday anybody do xml. however xml is a very good thing as langage is :-)
Ok, I see your point. However to make it clearer: XML becomes only useful, if the *contents* in your document are also marked up reasonably. We have an XSLT stylesheet that prints out all links. With another script it checks if these links are still accessible. So it's a kind of "qualitfy check". It would be not possible, if we (as writers) don't markup it accordingly. And this is the crucial point: XML is (only?) useful, if you investigate some time in your markup. To write documents in XML can be sometimes awkward for unexperienced users. But if you get used to it it is pretty easy. ;)
[...] on the contrary it's easy to go from any docbook/novbook/ structured form to html. The result will certainly lose part of the markup though.
Yes, that's the nature of this approach. :)
anyway, all this is _text_ and scripts can be made like sgmltools and linuxdoc to have some kind of compatibility.
Yes, it is text but without /meaningful/ semantics. It is nearly impossible to convert some plain text into some meaningful DocBook XML document automatically. (Ok, with some fancy regex hackery you *could* try to find URLs in your text and convert them to ulinks. But the problem still persists.)
The truth is that we badly need a wysiwyg xml editor. there are some, but none really satisfactory (neither emacs), so write one should be really a good thing, even for a single dtd
Look at [1]. There are lots of good XML editors -- either commercial or free. Tom ----- [1] http://wiki.docbook.org/topic/DocBookAuthoringTools -- Thomas Schraitle ---------------------------------------------------------------------- SUSE LINUX Products GmbH >o) Technical Editor Maxfeldstrasse 5 /\ Documentation Team 90409 Nuernberg, Germany __v http://www.suse.com