On Mon, Oct 17, 2005 at 12:02:31PM +0200, W. Borgert wrote: > Quoting Osamu Aoki <[EMAIL PROTECTED]>: > > I have uploaded debiandoc-sgml 1.1.91 which fix XHTML aissues and XML > > conversion. > > Thanks for your work! > > Some suggestions (sorry, not as a patch):
To what. debiandoc-sgml-doc ? or debiandoc-sgml > 1. You correctly write, that DocBook is better maintained. > DocBook XML has more advantages, relevant to the reader: > > - table support > > - graphics support OK. > - additional output formats (CHM, JavaHelp, nroff) I have no idea bout these. > 2. Not necessary, but good practise IMHO: Use UTF-8 - always! > Switching from SGML to XML is a good point in time to fix > the encoding as well. To convert other encodings one can > use iconv, e.g. iconv -f iso-8859-1 -t utf-8 Yes. Not required but the use of UTF-8 makes i18n life easier. > 3. The use of ENTITY is XML is not really nice (too SGMLish?). > To include other documents, it's better to use xi:include, > so you can even include single sections or paragraphs from > other XML files. Character entities are not necessary, > because we all use UTF-8, don't we? Leaves "short-cuts" > such as &gpl; -> "GNU General Public License". OK but I do not know about xi: thing. Where is example and tutorial info. I need some one to guide me with xi: . > 4. In DebianDoc, people use <sect1>, <sect2>, etc. This is > possible in DocBook as well, but one should avoid it. > You cannot easily re-arrange a document or include a > sect2 from one docuement in a sect3 of another. Better > use <section> - always. When changing a document from > SGML into XML this should be done as well. Yes, I know. I just imitated d-i style. I should make this switchable. This is simple. > 5. There is an addtional method to test an XML document: > xmllint, which works very well. Hmmm... I never used any XML thing yet. Looks interesting. This is my TODO. Osamu -- To UNSUBSCRIBE, email to [EMAIL PROTECTED] with a subject of "unsubscribe". Trouble? Contact [EMAIL PROTECTED]
