[OpenAFS-Doc] Final (from Latex) pdf's and html's available

[Esther Filderman]

First of all, please keep all documentation discussions on the mailing
list.  Do not mail me privately.

The HTML files are big huge masses. These need to be broken down
further.  HTML is the most common way people will read the
documentation [after man pages, but that's another ball of wax].
People will do as they do now, take quick looks on the online HTML documentation. 

We also need to be able to generate indexes for each documentation
collection [ie admin guide, windows guide, etc].

e.



   Turns out that the html is now generated from the same .tex files as pdf
   
   Run tth au*003.tex instead of pdflatex au003.tex; No changes to the .tex
   files are required.
   
   The reason for doing the html first was to verify the correctness of the
   conversion using diff on the source and final files.
   
   tth is copyrighted and licensed for free use by non profits so I deleted it
   from the current.
   
   tedc
   
   -----Original Message-----
   From: openafs-doc-admin@openafs.org [mailto:openafs-doc-admin@openafs.org]
   On Behalf Of Esther Filderman
   Sent: Monday, June 27, 2005 7:56 PM
   To: openafs-doc@openafs.org
   Subject: Re: [OpenAFS-Doc] Final (from Latex) pdf's and html's available 
   
   
   Ok, look.  There are certain requirements here:
   
   1) We should be using one system.
   
   2) It should be simple enough for a non-programmer to use. [Like, say,
      ME.]  It should not require "special instructions" to update files.
   
   3) It *MUST* generate, at the minimum, both some sort of "printable
      format" and html.  HTML is a *must* for the website.
   
   
   I would rather try to preserve the conversion that Ted has done but I am not
   convinced that LaTex is the right format to be using for everything, mostly
   because generating solid HTML seems to be such a problem.
   
   There are tools to convert LaTex to DocBook [amusingly, there are tools to
   convert POD *to* LaTex but not the other way, that I can find].  Perhaps
   that's the way we should go.
   
   
   I'm still researching DocBook & POD.  I've also still got pneumonia and am
   not up to speed on life.
   
   
   e.
   
   _______________________________________________
   OpenAFS-doc mailing list
   OpenAFS-doc@openafs.org
   https://lists.openafs.org/mailman/listinfo/openafs-doc