When instantiated, the original text (slightly modified, as described in the code) is read in and parsed to prepare structured text for several documents created and stored:

• a single document containing all the original text
• individual documents for header, preface, and 21 chapters

If the user provided a list of web links for terms or phrases, the terms or phrases are searched for and links added to the structured text documents.

The "small print" in the header, which is included in full as per what it states about "reuse", is from Project Gutenberg. No intentional changes were made to the text, except those allowed for in creating links, and other embedded code for using modern web technology to best present the book.

Regarding the product name, it is a tad long, as per the grief given on IRC :) Well, first it was VoyageOfTheBeagleByCharlesDarwin, but that would have set the product name record. Then it was VOTBByCharlesDarwin, but the VOTBBy got stuck together in the Add Item menu (so you would add VOTBBy Charles Darwin). So, with a chop of the Charles it took final form as a compromise. As it is a real book, care about the title and authorship seem to take precedence. There's probably a basic way to control the product name in menus, but it hasn't been searched out.

Some ideas for use/enhancement include:

• The product could be used for installation on a local Plone/Zope for handing reading.
• Add your own links for a given focus.
• Add some code to do linguistic analysis.
• Add code for quiz handling.
• Add code for doing paragraph-by-paragraph comment handling, or something similar to facilitate discussion, perhaps by tying in with a forum product.

Presentation choices, as controlled by page templates, include:

• COMPLETE, whole book on one web page
• CHAPTERS, chapter by chapter

VoyageOfTheBeagleByDarwin takes input of the following items:

• book_links, entered as comma-separated values on separate lines with CSV data containing (both items need to be in quotes):
  • term or phrase (as text; escape single or double quotes by putting a \ in front)
  • link (http://www.whatever.org)

REQUIREMENTS

• Archetypes (tested with Archetypes-1.3.2-final bundle)
• Plone (tested with Plone-2.1.1)

INSTALLATION

1. Put VoyageOfTheBeagleByDarwin in your Zope Products directory.
2. Restart Zope.
3. Install VoyageOfTheBeagleByDarwin into your Plone site using CMFQuickInstaller. (In Plone, select "plone setup", click on "Add/Remove Products" and install VoyageOfTheBeagleByDarwin.) You can also use the portal_quickinstaller tool from the ZMI to install the Product.