Skip to content
Fetching contributors…
Cannot retrieve contributors at this time
77 lines (49 sloc) 2.45 KB
**********************************************************************
NOTE: 2009-10-27 -- there have been reports of easy_install trying
to pull Cheetah 2.4.0 and failing. If this occurs, download and
install version 2.2.2 (which is the current stable version):
http://pypi.python.org/packages/source/C/Cheetah/Cheetah-2.2.2.tar.gz#md5=e0d89113ab6bb0935d2b67395960264c
**********************************************************************
One-time setup for python:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Unix (including cygwin):
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1. Check to see if setuptools is installed.
Execute this command:
which easy_install
If it returns something, it's installed skip to step #3.
2. Install Setup Tools:
Extract the archive in ext and install the package
sudo python setup.py install (no sudo needed for cygwin or windows)
setuptools
cd ext
tar xfvz setuptools-0.6c9.tar.gz
cd setuptools-0.6c9
sudo python setup.py install
3. Install the dependencies
easy_install pygments
easy_install Cheetah
* For Python version below 2.6.0, also install simplejson *
easy_install simplejson
4. Make a copy of yuidoc/bin/example.sh and modify the paths to suit your needs.
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
DOS/Windows:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
1. Install Python
* Use Python 2.4.3 as 2.5 generates warnings because the json parser has
not been updated yet:
http://www.python.org/ftp/python/2.4.3/python-2.4.3.msi
* Extract each of the archives with WinZIP and install as described in
the unix section.
* Copy _namemapper.pyd to C:\Python24\Lib\site-packages\Cheetah
2,3. Same as above
4. Add C:\python24 to your PATH
5. Copy yuidoc\bin\example.bat and modify the paths to suit your needs
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
See TAGS for a brief description of the supported tags. Checking out the
source for the YUI library is a good way to get to know how it works. Ex:
http://developer.yahoo.com/yui/docs/Event.js.html
NOTE: This tool will generally work with code that has been commented for
jsdoc, with one exception: you must have at least one @module block defined
somewhere in your source. If you don't, the program will run but won't
generate anything.
Something went wrong with that request. Please try again.