Re: Bundled docs for ease of download/offline use?

From: David Morris (dwm@xpasc.com)
Date: Thu Nov 20 2003 - 13:49:01 MST


On Thu, 20 Nov 2003, Alex Rousskov wrote:

> On Thu, 20 Nov 2003, David Morris wrote:
>
> > Is there a PDF version for the Reference Manual and Users Guide? My
> > brain does better absorbing new topics from hardcopy.
>
> I am afraid there is no official PDF version of the site. Do you know
> of any free software that would create PDF snapshots of web sites? I
> could not find anything last time I looked.

In general, HTML documents don't lend themselves to printing useful
composites so the only successful approaches I've seen have been the SGML
(and I presume now, XML) based doctypes and toolsets which target multiple
rendering approaches. The resulting HTML navigation looked more like a
book and less like the web.

>
> > Since I couldn't find such a beast on the web site or in the source
> > file, is there a way to download the complete HTML file set for
> > each? Or an XML/SGML version?
>
> I ran wget against the site. You can download the entire documentation
> tarball linked from http://www.web-polygraph.org/docs/
> Page links should work, but please let me know if you encounter
> problems; I have not verified every archived page.

I'll let you know if I see any breakage ... so far with a bunch of
clicking, everything except Search (no surprise) worked.

> Future Polygraph distributions may come with embedded documentation (a
> copy of the web site).

Cool ... if you have time, you might use an alternate anchor page for the
distributed version ... avoid the downloads (also break at the obvious
point), Search etc. Or use hard links for key points. Search could be made
to work using a distributed search fairly easily ... have your search CGI
use the 'referer' header to establish a <base> tag for the result set.
Then the search would run on your server but reference pages on the local
server.

Dave Morris



This archive was generated by hypermail 2b29 : Mon Feb 06 2006 - 12:00:27 MST