How to manage chapter-based documentation?
Everyone: Please excuse this if it's been covered before... I want my staff to create documentation about our work procedures in structured text. My idea was that each "chapter" would be contained in a folder. I would like these documents to automagically have a table of contents, back and next links, etc., as is common in DocBook-derived web-based documentation. I know that the Zope Book authors must have put together something like this to assemble their book. Is this available anywhere or is an alternative product like this available? Many thanks in advance, Ben Chapman P.S. 90% of our law school's web-site is now Zope -- http://www.law.utulsa.edu/ Thanks again for such phenomenal software. -- Benjamin J. Chapman benjamin-chapman@utulsa.edu 918/631-2405 Director of Computing Resources TU College of Law http://www.utulsa.edu/law/support/ Send computing support requests to: support@mail.law.utulsa.edu
Hi Ben, See http://backtalk.sourceforge.net for the code that runs the Zope Book. Use the CVS version if possible. HTH, - C ----- Original Message ----- From: "Ben Chapman" <benjamin-chapman@utulsa.edu> To: <zope@zope.org> Sent: Monday, July 22, 2002 1:22 AM Subject: [Zope] How to manage chapter-based documentation?
Everyone:
Please excuse this if it's been covered before...
I want my staff to create documentation about our work procedures in structured text. My idea was that each "chapter" would be contained in a folder. I would like these documents to automagically have a table of contents, back and next links, etc., as is common in DocBook-derived web-based documentation.
I know that the Zope Book authors must have put together something like this to assemble their book. Is this available anywhere or is an alternative product like this available?
Many thanks in advance,
Ben Chapman
P.S. 90% of our law school's web-site is now Zope -- http://www.law.utulsa.edu/ Thanks again for such phenomenal software.
-- Benjamin J. Chapman benjamin-chapman@utulsa.edu 918/631-2405 Director of Computing Resources TU College of Law http://www.utulsa.edu/law/support/ Send computing support requests to: support@mail.law.utulsa.edu
_______________________________________________ Zope maillist - Zope@zope.org http://lists.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://lists.zope.org/mailman/listinfo/zope-announce http://lists.zope.org/mailman/listinfo/zope-dev )
On Mon, Jul 22, 2002 at 12:22:39AM -0500, Ben Chapman wrote:
Everyone:
Please excuse this if it's been covered before...
I want my staff to create documentation about our work procedures in structured text. My idea was that each "chapter" would be contained in a folder. I would like these documents to automagically have a table of contents, back and next links, etc., as is common in DocBook-derived web-based documentation.
There is a product - ChrisM's backtalk system that does this rather well. http://sourceforge.net/projects/backtalk/ I recommend that you download the CVS release. I have had minor problems with creating a "book of books"; but for single level books it is very nice. This is (more or less) what the Zope Book people are using. Jim Penny
I know that the Zope Book authors must have put together something like this to assemble their book. Is this available anywhere or is an alternative product like this available?
Many thanks in advance,
Ben Chapman
P.S. 90% of our law school's web-site is now Zope -- http://www.law.utulsa.edu/ Thanks again for such phenomenal software.
-- Benjamin J. Chapman benjamin-chapman@utulsa.edu 918/631-2405 Director of Computing Resources TU College of Law http://www.utulsa.edu/law/support/ Send computing support requests to: support@mail.law.utulsa.edu
_______________________________________________ Zope maillist - Zope@zope.org http://lists.zope.org/mailman/listinfo/zope ** No cross posts or HTML encoding! ** (Related lists - http://lists.zope.org/mailman/listinfo/zope-announce http://lists.zope.org/mailman/listinfo/zope-dev )
I have had minor problems with creating a "book of books"; but for single level books it is very nice. This is (more or less) what the Zope Book people are using.
Jim, I saw your message in the BackTalk project tracker the other day, its existence surprised the heck of of me! (I never checked it and it never emailed me ;-) Thanks for reporting the bug, I know there are problems with nested books, I just haven't had time to implement and test a solid solution. Thanks, - C
participants (3)
-
Ben Chapman -
Chris McDonough -
Jim Penny