Re: [gnuspeech-contact] Document formats & repository

[Paul Tyson]

David,

I understand and appreciate your concern for aesthetically pleasing
documentation--particularly for user manuals.  A lot of docbook-based
pages are plain-looking, but they can be dressed up quite a bit with
custom stylesheets.  Nevertheless there are limits, and it is difficult
to have total layout control.

Regards,
--Paul

On Sun, 2011-04-03 at 18:57 -0700, David Hill wrote:
> Hi Paul,
> 
> The advantage of Docbook is that it would be easily editable by anyone. The 
> advantage of PDF is that it really suits me as it gives me the ability to 
> produce a very carefully controlled, beautifully presented document and I 
> have all the necessary system to do it.  Jury is still out, but thanks for 
> the suggestion. Well worth checking out.
> 
> Best.
> 
> david
> 
> On Apr 3, 2011, at 6:28 PM, Paul Tyson wrote:
> 
> > Docbook (http://www.docbook.org/) might be a good choice if you are
> > looking to put the Monet and Synthesizer manuals into a different
> > format.  There are standard XSLT stylesheets available to convert
> > docbook xml to html and pdf.
> > 
> > Regards,
> > --Paul
> > 
> > On Sun, 2011-04-03 at 13:45 -0700, David Hill wrote:
> >> Having done a little checking, it would seem that PDF files are
> >> acceptable to GNU projects as there is a "free" PDF reader (though not
> >> as comprehensive as the Adobe version yet, one would need to check any
> >> file was readable by the current release).
> >> 
> >> 
> >> Texinfo does *not* seem very suitable for documenting GUI-based apps,
> >> IMHO.
> >> 
> >> 
> >> Comments anyone?
> >> 
> >> 
> >> david
> >> ---------
> >> David Hill
> >> address@hidden
> >> http://savannah.gnu.org/projects/gnuspeech
> >> --------
> >> The only function of economic forecasting is to make astrology look
> >> respectable. (J.K. Galbraith)
> >> --------
> >> 
> >> _______________________________________________
> >> gnuspeech-contact mailing list
> >> address@hidden
> >> http://lists.gnu.org/mailman/listinfo/gnuspeech-contact
> > 
>