RE: [Zope] ANNOUNCE: Documentation Release
Great work. I wish you could fix the HTML documentation packaging, though. I remember a while back when you could still get the DTML Guide as a single, flat HTML file (plus the images). The formatting stunk then, but at least you could easily browse the documentation. The formatting of the DTML and SQL guides remains pretty ghastly. In future releases, please include the option of viewing/downloading a single, flat HTML file, preferably with numbered sections (eg., "6.1. Iterative Insertion"). The table of contents produced by Frame Maker is so bad I'm surprised you haven't fixed it by hand. For example, in the case of the ZAG it starts of confidently, until "ZServer Command Line Switches", where it falls apart, adding paragraphs between each entry and forgetting to add a bullet. And when it's doen with all that, it says "Figure 1. CGI Overview" in huge letters and then starts off on a new table contents, nicely ordered but with the exact same contents. This is also the first table of contents on the web I've seen that includes page numbers. -- Alexander Staubo http://www.mop.no/~alex/ "`Ford, you're turning into a penguin. Stop it.'" --Douglas Adams, _The Hitchhiker's Guide to the Galaxy_
-----Original Message----- From: Pam Crosby [mailto:pam@digicool.com] Sent: 1. oktober 1999 23:42 To: 'zope@zope.org'; 'ZDP@zope.org' Subject: [Zope] ANNOUNCE: Documentation Release
Digital Creations is proud to announce the availability of several updated Zope Documentation guides.
* The much awaited Z Class Tutorial is now the first chapter of the Zope Developer's Guide. http://www.zope.org/Documentation/Developer/ More chapters will be forth coming!
* The Zope Administrator's Guide http://www.zope.org/Documentation/Guides/ZAG_doc , in draft mode, is also online. This guide covers Zope's installation and maintenance issues.
* The original guides are undergoing a metamorphous as we provide a more comprehensive Zope documentation effort. The Zope Content Manager's Guide, DTML Reference and ZSQL Guide have been modified to reflect the newest Zope 2 version. The new DTML syntax is incorporated into these guides. Similar reference guides and tutorials will follow. These guides are located on the main documentation page. http://www.zope.org/Documentation
Pamela Crosby
Technical Writer mailto:pam@digicool.com Digital Creations http://www.digicool.com
_______________________________________________ Zope maillist - Zope@zope.org http://www.zope.org/mailman/listinfo/zope
(Related lists - please, no cross posts or HTML encoding!
To receive general Zope announcements, see: http://www.zope.org/mailman/listinfo/zope-announce
For developer-specific issues, zope-dev@zope.org - http://www.zope.org/mailman/listinfo/zope-dev )
On Sat, Oct 02, 1999 at 07:52:07AM +0200, Alexander Staubo wrote:
I remember a while back when you could still get the DTML Guide as a single, flat HTML file (plus the images). The formatting stunk then, but at least you could easily browse the documentation. The formatting of the DTML and SQL guides remains pretty ghastly. In future releases, please include the option of viewing/downloading a single, flat HTML file, preferably with numbered sections (eg., "6.1. Iterative Insertion").
Even better idea. Contact the people at the Linux Documentation Project, <http://www.linuxdoc.org>, and find out about the tools package they use to generate HTML, PostScript, texi, and ASCII documentation from the same sources. O'Reilly had a hand in it, and I gather it's sweet. Cheers, -- jra -- Jay R. Ashworth jra@baylink.com Member of the Technical Staff Buy copies of The New Hackers Dictionary. The Suncoast Freenet Give them to all your friends. Tampa Bay, Florida http://www.ccil.org/jargon/ +1 813 790 7592
Regarding ZAG, where is the Unix version? "Jay R. Ashworth" wrote:
On Sat, Oct 02, 1999 at 07:52:07AM +0200, Alexander Staubo wrote:
I remember a while back when you could still get the DTML Guide as a single, flat HTML file (plus the images). The formatting stunk then, but at least you could easily browse the documentation. The formatting of the DTML and SQL guides remains pretty ghastly. In future releases, please include the option of viewing/downloading a single, flat HTML file, preferably with numbered sections (eg., "6.1. Iterative Insertion").
Even better idea. Contact the people at the Linux Documentation Project, <http://www.linuxdoc.org>, and find out about the tools package they use to generate HTML, PostScript, texi, and ASCII documentation from the same sources. O'Reilly had a hand in it, and I gather it's sweet.
Cheers, -- jra -- Jay R. Ashworth jra@baylink.com Member of the Technical Staff Buy copies of The New Hackers Dictionary. The Suncoast Freenet Give them to all your friends. Tampa Bay, Florida http://www.ccil.org/jargon/ +1 813 790 7592
_______________________________________________ Zope maillist - Zope@zope.org http://www.zope.org/mailman/listinfo/zope
(Related lists - please, no cross posts or HTML encoding!
To receive general Zope announcements, see: http://www.zope.org/mailman/listinfo/zope-announce
For developer-specific issues, zope-dev@zope.org - http://www.zope.org/mailman/listinfo/zope-dev )
-- ~~~~~~~~~~~~~~ Alwyn Schoeman Systems Engineer Prism Secure Solutions From: Acronyms of the New Millennium. MCSE - Microsoft Certified Systems Elliterate Coined by a fellow named William who couldn't spell either.
participants (3)
-
Alexander Staubo -
Alwyn Schoeman -
Jay R. Ashworth