Made a bunch of changes to the build system.
This commit is contained in:
parent
0307071d9e
commit
fc5ab8d655
5 changed files with 50 additions and 23 deletions
96
build/docs/docs.js
Normal file
96
build/docs/docs.js
Normal file
|
@ -0,0 +1,96 @@
|
|||
load("build/js/json.js", "build/js/xml.js", "build/js/writeFile.js");
|
||||
|
||||
var types = {
|
||||
jQuery: "A jQuery object.",
|
||||
Object: "A simple Javascript object. For example, it could be a String or a Number.",
|
||||
String: "A string of characters.",
|
||||
Number: "A numeric valid.",
|
||||
Element: "The Javascript object representation of a DOM Element.",
|
||||
Hash: "A Javascript object that contains key/value pairs in the form of properties and values.",
|
||||
"Array<Element>": "An Array of DOM Elements.",
|
||||
"Array<String>": "An Array of strings.",
|
||||
Function: "A reference to a Javascript function."
|
||||
};
|
||||
|
||||
var f = readFile(arguments[0]);
|
||||
|
||||
var c = [], bm, m;
|
||||
var blockMatch = /\/\*\*\s*((.|\n)*?)\s*\*\//g;
|
||||
var paramMatch = /\@(\S+) *((.|\n)*?)(?=\n\@|!!!)/m;
|
||||
|
||||
while ( bm = blockMatch.exec(f) ) {
|
||||
block = bm[1].replace(/^\s*\* ?/mg,"") + "!!!";
|
||||
var ret = { params: [], examples: [] };
|
||||
|
||||
while ( m = paramMatch.exec( block ) ) {
|
||||
block = block.replace( paramMatch, "" );
|
||||
|
||||
var n = m[1];
|
||||
var v = m[2]
|
||||
.replace(/\s*$/g,"")
|
||||
.replace(/^\s*/g,"")
|
||||
.replace(/&/g, "&")
|
||||
.replace(/</g, "<")
|
||||
.replace(/>/g, ">")
|
||||
.replace(/\n/g, "<br/>")
|
||||
/*.replace(/(\s\s+)/g, function(a){
|
||||
var ret = "";
|
||||
for ( var i = 0; i < a.length; i++ )
|
||||
ret += " ";
|
||||
return ret;
|
||||
})*/ || 1;
|
||||
|
||||
if ( n == 'param' || n == 'any' ) {
|
||||
var args = v.split(/\s+/);
|
||||
v = args.slice( 2, args.length );
|
||||
v = { type: args[0], name: args[1], desc: v.join(' ') };
|
||||
if ( n == 'any' ) v.any = 1;
|
||||
n = "params";
|
||||
} else if ( n == 'example' ) {
|
||||
v = { code: v };
|
||||
n = "examples";
|
||||
}
|
||||
|
||||
if ( n == 'desc' || n == 'before' || n == 'after' || n == 'result' ) {
|
||||
ret.examples[ ret.examples.length - 1 ][ n ] = v;
|
||||
} else {
|
||||
if ( ret[ n ] ) {
|
||||
if ( ret[ n ].constructor == Array ) {
|
||||
ret[ n ].push( v );
|
||||
} else {
|
||||
ret[ n ] = [ ret[ n ], v ];
|
||||
}
|
||||
} else {
|
||||
ret[ n ] = v;
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
ret.desc = block.replace(/\s*!!!$/,"")
|
||||
.replace(/</g, "<")
|
||||
.replace(/>/g, ">");
|
||||
//.replace(/\n\n/g, "<br/><br/>")
|
||||
//.replace(/\n/g, " ");
|
||||
|
||||
var m = /^((.|\n)*?(\.|$))/.exec( ret.desc );
|
||||
if ( m ) ret['short'] = m[1];
|
||||
|
||||
if ( ret.name ) c.push( ret );
|
||||
}
|
||||
|
||||
var json = Object.toJSON( c );
|
||||
|
||||
writeFile( arguments[1] + "/data/jquery-docs-json.js", json );
|
||||
writeFile( arguments[1] + "/data/jquery-docs-jsonp.js", "docsLoaded(" + json + ")" );
|
||||
|
||||
Object.toXML.force = { desc: 1, code: 1, before: 1, result: 1 };
|
||||
|
||||
var xml = Object.toXML( { method: c }, "docs" );
|
||||
|
||||
writeFile( arguments[1] + "/data/jquery-docs-xml.xml",
|
||||
"<?xml version='1.0' encoding='ISO-8859-1'?>\n" + xml );
|
||||
|
||||
writeFile( arguments[1] + "/index.xml",
|
||||
"<?xml version='1.0' encoding='ISO-8859-1'?>\n" +
|
||||
"<?xml-stylesheet type='text/xsl' href='style/docs.xsl'?>\n" + xml
|
||||
);
|
|
@ -6,10 +6,10 @@
|
|||
<head>
|
||||
<title>jQuery Docs - API</title>
|
||||
<link rel="stylesheet" href="style/style.css"/>
|
||||
<script src="../jquery-svn.js"></script>
|
||||
<script src="../dist/jquery-svn.js"></script>
|
||||
<script src="js/tooltip.js"></script>
|
||||
<script src="js/pager.js"></script>
|
||||
<script src="js/doc2.js"></script>
|
||||
<script src="js/doc.js"></script>
|
||||
</head>
|
||||
<body>
|
||||
<h1>jQuery Docs - API</h1>
|
||||
|
|
Loading…
Add table
Add a link
Reference in a new issue