Re: RFI: debiandoc-sgml V2
Hi,
Nice to hear V2 is planned.
On Wed, May 15, 2002 at 09:45:47PM -0500, Ardo van Rangelrooij wrote:
> I've stated in several emails some time ago that I consider the current
> version (v1 if you will) to be more or less frozen from a DTD point of
> view. There're one small enhancement planned (bug #145999 to support
> lettered items in a list), but after that no more new stuff in the DTD.
Also debiandoc2latex needs to be fixed like debiandoc2pdf and
debiandoc2ps. (It may have been done in your local CVS)
Now that latex2rtf exists in Debian (I never used it), we can even make
evil *.DOC files :-)
...
> Osamu Aoki (debian@aokiconsulting.com) wrote:
...
> > 1. Add tag to include images in documents, where ever possible.
> >
> > This can be accommodated by hacking <url ...> tag. <fig ...> tag is a
> > one to come. ASAP, Ardo. Just implement for PDF and HTML(with script
> > to choose indirect link based on file size and command line option).
>
> This is the no.1 feature to be added to v2. One of the issues we've to
> solve is which formats to we support (PNG, JPEG, GIF, etc.) and what to
> do with text based output formats.
I think it shall be like HTML <IMG> TAG. If <IMG ID="..." ALT="...">
display ALT. If without ALT, just say "*** See ... ***" just like
links/lynx does for HTML page.
...
> > Normalizing SGML code. For example, <p> ... -> <p> ... </p>.
>
> I'm not really sure what you mean here. I'm using Xemacs+psgml mode which
> takes care of the normalization. Or do you mean in the DTD?
Basically wrapper short script for EMACS illiterate to normalize SGML:)
> > 4. Debiandic-sgml to DocBook XML converter.
> >
> > I assume is is quite feasible for Ardo to make one by changing HTML
> > converter.
>
> I've been talking to Mark Johnson about that I think DebianDoc should be
> positioned between DccBook-Lite and DocBook, and that we should provide
> converters from DccBook-Lite to DebianDoc and from DebianDoc to DocBook
> to allow projects to move to a more suitable DTD if their needs change.
...
> > Sorry, Ardo. Debiandoc-sgml creates ugly list in HTML.
...
> > I wonder why???
>
> To get a better look&feel in HTML. If you look at PDF/PS and the text based
> output you'll notice an empty line between list entries (except in compact
> lists). HTML by default doesn't do this. Hence I turn each list entry into
> its own list to force the empty line.
I see. In order to maintain logic behind SGML, maybe adding " <BR>"
may be an option but it might have been dropped by browser.
I may like list to be tightly packed but that is my thing...
> All in all we can conclude there's still a lot to be done in DebianDoc land. :-)
Yes.
Limited feature actually force good consistency of document style.
Also, least requirement of closing-TAG is nice if you are converting
text file memo, mailing list post to SGML.
Osamu
--
~\^o^/~~~ ~\^.^/~~~ ~\^*^/~~~ ~\^_^/~~~ ~\^+^/~~~ ~\^:^/~~~ ~\^v^/~~~ +++++
Osamu Aoki @ Cupertino CA USA
See "User's Guide": http://www.debian.org/doc/manuals/users-guide/
See "Debian reference": http://www.debian.org/doc/manuals/reference/
"Debian reference" Project at: http://qref.sf.net
I welcome your constructive criticisms and corrections.
--
To UNSUBSCRIBE, email to debian-doc-request@lists.debian.org
with a subject of "unsubscribe". Trouble? Contact listmaster@lists.debian.org
Reply to: