httpd-docs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Andrew Ford <and...@icarus.demon.co.uk>
Subject Re: Does the apache user manual exists in printable format?
Date Wed, 02 Sep 1998 21:47:49 GMT
rlangfor@us.ibm.com (Robin Langford) writes:

> 
> Greetings,
> 
> Which printable format is better for most users?  PS or PDF?  Or is it
> acceptable to print HTML sections from a browser?  I'm trying to choose an
> appropriate format  for the IBM documentation that supports the Apache server.
> 
> Thanks for any feedback,
> 
> Robin Langford
> rlangfor@us.ibm.com
> 

Looking at the stats for the Apache quick reference card, the
downloads for PDF format files outnumber those for Postscript format 3
to 1 for those downloading the US letter sized card, and 2 to 1 for
those downloading the A4 card.

Personally I dislike the exclusive use of HTML for documentation --
its a pain to print out and sort out, and anyway I like to get away
from my computer to read documentation.  I would suggest using SGML or
LaTeX and converting to HTML for the online docs.  I have used LaTeX
for most of my documentation in the past and find it far superior to
direct HTML coding.  The LaTeX2HTML convertor is infinitely
customizable so you can get virtually any effect in HTML you want by
tweaking and adding perl code, while still being able to generated
high quality printed documentation.  I am looking at SGML tools at the
moment and the same principle applies -- with the route to printed
documentation still being via LaTeX.

Andrew
-- 
Andrew Ford                             Email: A.Ford@ford-mason.co.uk
Director, Ford & Mason Ltd.             WWW:   http://www.ford-mason.co.uk/aford/
South Wing, Compton House,              Tel:   +44 1531 829900
Compton Green, Redmarley, GL19 3JB, GB  Fax:   +44 1531 829901

Mime
View raw message