Documentation for ZQWK
ZQWK allows loading QWK mail packets into Zope. The project is comprised of three parts:
- QWK.py, a QWK library in Python that can be used independent of Zope.
- ZQwk.py, a Zopified version that stores messages in the ZODB and provides a packet upload interface.
- DTML templates to provide a Web interface.
Installation
ZQWK requires BTreeFolder2 and a recent version of Zope. It has been tested with release 2.6.0 but should also work with older versions. After installing Zope, extract both BTreeFolder2 and ZQWK into Zope's lib/python/Products folder and restart Zope.
Within the Zope Management Interface, you should now see "QWK Catalog" and "QWK Packet" in the drop-down list of addable items.
Usage
If you want to build a searchable message-base, first select "QWK Catalog". This will create a ZCatalog instance customized to index QWK messages. Make sure the created instance is named "Catalog" (the default).
Next, select "QWK Packet" from the drop-down and in the screen that comes up, upload a QWK file from disk. You should now see a folder added for the BBS the specified file came from and within it, several folders for the forums that were available in the QWK packet. These folders contain the actual messages from the packet.
The QWK.py library can also be used as a standalone application:
./QWK.py bbsid.qwk ...
Will dump all messages from the specified QWK files.
Templates
I'm still working on building decent Web templates. These will be included in a later release.
