Notes on YUI Doc

You must install nodejs, and you must also install the node package manager (npm). The easiest way to do this on windows
is to go to http://nodejs.org/#download and chose the windows installer

After you get npm installed, open cmd and type this:
npm -g install yuidocjs

For notes on how to comment your code to use YUIDoc, go to http://yui.github.com/yuidoc/
See below for a few simple rules

When you are ready to generate documentation you should create a file called yuidoc.json. This is a configuration file for your
project. It will look something like this:

{
    "name": "The Foo API",
    "description": "The Foo API: a library for doing X, Y, and Z",
    "version": "1.2.1",
    "url": "http://example.com/",
    "options": {
        "outdir": "../build/apidocs"
    }
}

To generate your docs (after you have set up your yuidoc.json file, open a cmd prompt and navigate to your project folder then type this:

yuidoc .

For a list of flags that you can pass into the yuidoc command, click here.

A few simple rules about using YUIDoc:

  • For YUIDoc to see your comment it must start like this /** not /*
  • A source tree must contain at least one comment block with a 'module' tag.
  • Each module must have at least one comment block with a 'class' tag.
  • Each class may then have zero or more comment blocks with an attribute, 'class', 'event', 'method', or 'property tag'.

 

Notes on some of the tags in YUI doc:

@module - for a group of related classes

@param [someparam] {Object}  - an optional param of type Object

@param [someparam.somekey] {Number} - an optional key in the optional someparam

@param [someparam=False] {Boolean} - an optional param that defaults to false if not passed in

@param someparam {HTML | String} - a param that can be either a string or and html (string)

@chainable - put this on a function that returns 'this'

 

To put some example code in the docs (put a tab before each line of sample code):

 

@example
events: {
".some-class:click": function(event, building, buildingList){...}
}

 

 

 

Add a Comment...

 

Comments

the best mattress 2017 best mattress for 2017 rate mattresses 2017 best memory foam mattress 2017 the best mattress of 2017 best mattress for 2017 best mattresses 2017 rate mattresses 2017 best budget memory foam mattress 2017 top 5 mattresses 2017 best budget memory foam mattress 2017 best mattress to buy in 2017 best mattress of 2017 for side sleeper best mattress to buy in 2017 best mattresses in 2017 print casper coupon printable casper coupon casper coupon code promo code leesa - 7/22/2017

Revolutional update of SEO/SMM package "XRumer 16.0 + XEvil": captchas recognition of Google, Facebook, Bing, Hotmail, SolveMedia, Yandex, and more than 8400 another categories of captchas, with highest precision (80..100%) and highest speed (100 img per second). You can connect XEvil 3.0 to all most popular SEO/SMM software: XRumer, GSA SER, ZennoPoster, Srapebox, Senuke, and more than 100 of other software. Interested? You can find a lot of demo videos about XEvil in YouTube. G - 7/22/2017

Revolutional update of SEO/SMM package "XRumer 16.0 + XEvil 3.0": captcha solving of Google, Facebook, Bing, Hotmail, SolveMedia, Yandex, and more than 8400 another subtypes of captchas, with highest precision (80..100%) and highest speed (100 img per second). You can connect XEvil 3.0 to all most popular SEO/SMM programms: XRumer, GSA SER, ZennoPoster, Srapebox, Senuke, and more than 100 of other programms. Interested? You can find a lot of introducing videos about XEvil in YouTub - 7/22/2017

Absolutely NEW update of SEO/SMM software "XRumer 16.0 + XEvil 3.0": captchas recognition of Google, Facebook, Bing, Hotmail, SolveMedia, Yandex, and more than 8400 another subtypes of captchas, with highest precision (80..100%) and highest speed (100 img per second). You can connect XEvil 3.0 to all most popular SEO/SMM programms: XRumer, GSA SER, ZennoPoster, Srapebox, Senuke, and more than 100 of other software. Interested? There are a lot of demo videos about XEvil in YouTube. - 7/22/2017

Absolutely NEW update of SEO/SMM software "XRumer 16.0 + XEvil 3.0": captchas regignizing of Google, Facebook, Bing, Hotmail, SolveMedia, Yandex, and more than 8400 another categories of captchas, with highest precision (80..100%) and highest speed (100 img per second). You can connect XEvil 3.0 to all most popular SEO/SMM software: XRumer, GSA SER, ZennoPoster, Srapebox, Senuke, and more than 100 of other programms. Interested? You can find a lot of introducing videos about XEvil - 7/21/2017

Absolutely NEW update of SEO/SMM software "XRumer 16.0 + XEvil 3.0": captcha breaking of Google, Facebook, Bing, Hotmail, SolveMedia, Yandex, and more than 8400 another types of captcha, with highest precision (80..100%) and highest speed (100 img per second). You can connect XEvil 3.0 to all most popular SEO/SMM programms: XRumer, GSA SER, ZennoPoster, Srapebox, Senuke, and more than 100 of other programms. Interested? There are a lot of demo videos about XEvil in YouTube. Good - 7/18/2017

Absolutely NEW update of SEO/SMM software "XRumer 16.0 + XEvil 3.0": captchas regignizing of Google, Facebook, Bing, Hotmail, SolveMedia, Yandex, and more than 8400 another categories of captchas, with highest precision (80..100%) and highest speed (100 img per second). You can connect XEvil 3.0 to all most popular SEO/SMM programms: XRumer, GSA SER, ZennoPoster, Srapebox, Senuke, and more than 100 of other software. Interested? There are a lot of impessive videos about XEvil in Yo - 7/18/2017

Absolutely NEW update of SEO/SMM software "XRumer 16.0 + XEvil 3.0": captcha recognition of Google, Facebook, Bing, Hotmail, SolveMedia, Yandex, and more than 8400 another subtypes of captcha, with highest precision (80..100%) and highest speed (100 img per second). You can connect XEvil 3.0 to all most popular SEO/SMM software: XRumer, GSA SER, ZennoPoster, Srapebox, Senuke, and more than 100 of other software. Interested? You can find a lot of impessive videos about XEvil in YouT - 7/17/2017

Revolutional update of SEO/SMM package "XRumer 16.0 + XEvil": captcha solution of Google, Facebook, Bing, Hotmail, SolveMedia, Yandex, and more than 8400 another subtypes of captcha, with highest precision (80..100%) and highest speed (100 img per second). You can connect XEvil 3.0 to all most popular SEO/SMM software: XRumer, GSA SER, ZennoPoster, Srapebox, Senuke, and more than 100 of other software. Interested? You can find a lot of introducing videos about XEvil in YouTube. S - 7/14/2017

Keep this going please, great job! - 11/23/2016

Excellent means of explaining, and good paragraph to get facts regarding my presentation material, which i will deliver in college. - 11/18/2016

Hey! I could have sworn I've gone to this site before but after reading through some of the post I realized it's new to me. Anyways, I'm definitely glad I found it and I'll be book-marking and checking back often! - 11/15/2016

I'm not sure why but this blog is loading very slow for me. Is anyone else having this issue or is it a issue on my end? I'll check back later and see if the problem still exists. - 10/07/2016