/
README
57 lines (39 loc) · 1.48 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
yuidoc README
yuidoc is a set of tools to generate the API documentation for the JavaScript
in the YUI library. The docs are derived completely from JavaDoc style
comment blocks; no attempt is made to understand the javascript itself.
The tools are written in python, and should work for version 2.3 and up.
To date, it has only been tested in version 2.3 on a unix system. Although
largely untested, it should work in MS windows as well.
The following python libraries are required:
simplejson - for reading and writing json
cheetah - for generating the html docs
pygments - for colorizing the source
Files:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
README
This file
CHANGES
The change log
INSTALL
Installation instructions
TAGS
Supported tags
TODO
Things that need to be done
bin/yuidoc_parse.py
The comment block parser. Parses all javascript files in the the specified
directories and outputs a single file containing a json structure of the
parsed documentation.
bin/yuidoc_highlight.py
Colorizes the script source
bin/yuidoc_generate.py
Reads the json output from parser.py and generates HTML docs.
bin/yuidoc.py
wraps the calss to yuidoc_parse, yuidoc_highlight, and yuidoc_generate
bin/example.sh
An example shell script to run both the parser and generator on a src tree
bin/example.bat
An example batch for for DOS/Windows
ext
External required packages, provided for convenience