Skip to content
This repository has been archived by the owner on May 12, 2018. It is now read-only.

keram/yuidoc

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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.

yuidoc requires Python 2.3+ with the following extensions:
    simplejson - for reading and writing json (required for Python versions below 2.6.0)
    cheetah    - for generating the html docs
    pygments   - for colorizing the source

The code for yuidoc is provided under a BSD license:
    http://developer.yahoo.net/yui/license.html

Project home page:
    http://developer.yahoo.com/yui/yuidoc/
    
Source code:
    http://github.com/yui/yuidoc

Issue tracker:
    http://yuilibrary.com/projects/yuidoc

    
Files:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

README
    This file

CHANGES
    The change log

INSTALL
    Installation instructions

KNOWN_ISSUES
    Known issues and workarounds.

TAGS
    Supported tags

license.txt
    Open source license details.

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
    Wrapper for 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


About

YUI Javascript Documentation Tool

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Python 81.9%
  • Shell 13.5%
  • JavaScript 1.4%
  • Ruby 0.8%
  • PHP 0.8%
  • Java 0.6%
  • Other 1.0%