Run "python setup.py --help" for help with the installer, or "python setup.py
install" to perform a default install.
I recommend running the included ez_setup.py script to install setuptools and
easy_install if you don't have them. You can then run easy_install
Comic[<feature1>,<feature2>,...] to add the optional features. You'll need to
install the webdisplay and fetch options to do much of anything, and also the
sqlite option, unless you're using another database (you'll have to run one of
the scripts once, to create a default config file, and then edit it, if you
don't want to use the default sqlite database. So, the quickest way to a useful
install is running 'easy_install Comic[webdisplay,fetch,sqlite]' after
installing with setup.py. This will change when there's a handy release version
that I can add to PyPI.
After installing, you can run 'comic_get -h' for some help with the script. Once
you've selected some comics, 'comic_get -b' can get you started fetching them,
and can be used to fetch just the newest issues of comics if you've already
fetched their archives.
The web interface, by default, will run on port 8080. On its first run, it will
create an admin user with the password 'admin'. You can use
http://127.0.0.1:8080/password to change the password for the user currently
logged in, and http://127.0.0.1:8080/manageusers to create new users. These will
eventually be part of an admin page in the web UI, but for now this is the only
way to get started. Create a new user, go to 127.0.0.1:8080/login to log in as
your new user, and you'll be able to view comic archives.
For now, Fetch.py and the YAML files are the only real guide to the comic
class/def formats.
Dependencies:
The entire package requires:
PyYAML (pyyaml.org)
SQLObject (sqlobject.org)
setuptools (peak.telecommunity.com/DevCenter/setuptools)
A support module for whichever DB you want to use
(sqlite should be fine)
The Fetch module and comic_get script require:
BeautifulSoup (http://www.crummy.com/software/BeautifulSoup/)
The Session and Web modules and comic_show script require:
beaker (http://beaker.groovie.org/)
web.py (http://webpy.org)