Modify jsdoc-template to write jekyll-compatible files.

This commit is contained in:
Christian Williams 2010-10-05 12:34:04 -07:00
parent 138c5081e9
commit abd020556f
5 changed files with 90 additions and 110 deletions

View File

@ -1,56 +1,48 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" ---
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> layout: default
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> title: "API - File Index"
<head> ---
<meta http-equiv="content-type" content="text/html; charset={+IO.encoding+}"" />
{! Link.base = ""; /* all generated links will be relative to this */ !}
<title>JsDoc Reference - File Index</title>
<meta name="generator" content="JsDoc Toolkit" />
<style type="text/css"> {! Link.base = ""; /* all generated links will be relative to this */ !}
{+include("static/default.css")+} <style type="text/css">
</style> {+include("static/default.css")+}
</head> </style>
<body> <div id="index">
{+include("static/header.html")+} {+publish.classesIndex+}
</div>
<div id="index"> <div id="content">
{+publish.classesIndex+} <h1 class="classTitle">File Index</h1>
</div>
<div id="content"> <for each="item" in="data">
<h1 class="classTitle">File Index</h1> <div>
<h2>{+new Link().toSrc(item.alias).withText(item.name)+}</h2>
<if test="item.desc">{+resolveLinks(summarize(item.desc))+}</if>
<dl>
<if test="item.author">
<dt class="heading">Author:</dt>
<dd>{+item.author+}</dd>
</if>
<if test="item.version">
<dt class="heading">Version:</dt>
<dd>{+item.version+}</dd>
</if>
{! var locations = item.comment.getTag('location').map(function($){return $.toString().replace(/(^\$ ?| ?\$$)/g, '').replace(/^HeadURL: https:/g, 'http:');}) !}
<if test="locations.length">
<dt class="heading">Location:</dt>
<for each="location" in="locations">
<dd><a href="{+location+}">{+location+}</a></dd>
</for>
</if>
</dl>
</div>
<hr />
</for>
<for each="item" in="data"> </div>
<div>
<h2>{+new Link().toSrc(item.alias).withText(item.name)+}</h2>
<if test="item.desc">{+resolveLinks(summarize(item.desc))+}</if>
<dl>
<if test="item.author">
<dt class="heading">Author:</dt>
<dd>{+item.author+}</dd>
</if>
<if test="item.version">
<dt class="heading">Version:</dt>
<dd>{+item.version+}</dd>
</if>
{! var locations = item.comment.getTag('location').map(function($){return $.toString().replace(/(^\$ ?| ?\$$)/g, '').replace(/^HeadURL: https:/g, 'http:');}) !}
<if test="locations.length">
<dt class="heading">Location:</dt>
<for each="location" in="locations">
<dd><a href="{+location+}">{+location+}</a></dd>
</for>
</if>
</dl>
</div>
<hr />
</for>
</div> <div class="fineprint" style="clear:both">
<div class="fineprint" style="clear:both"> <if test="JSDOC.opt.D.copyright">&copy;{+JSDOC.opt.D.copyright+}<br /></if>
<if test="JSDOC.opt.D.copyright">&copy;{+JSDOC.opt.D.copyright+}<br /></if> Documentation generated by <a href="http://www.jsdoctoolkit.org/" target="_blankt">JsDoc Toolkit</a> {+JSDOC.VERSION+} on {+new Date()+}
Documentation generated by <a href="http://www.jsdoctoolkit.org/" target="_blankt">JsDoc Toolkit</a> {+JSDOC.VERSION+} on {+new Date()+} </div>
</div>
</body>
</html>

View File

@ -1,15 +1,12 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" ---
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> layout: default
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> title: "API - {+data.alias+}"
<head> ---
<meta http-equiv="content-type" content="text/html; charset={+IO.encoding+}" />
<meta name="generator" content="JsDoc Toolkit" />
{! Link.base = "../"; /* all generated links will be relative to this */ !}
<title>JsDoc Reference - {+data.alias+}</title>
<style type="text/css"> {! Link.base = "../"; /* all generated links will be relative to this */ !}
{+include("static/default.css")+} <style type="text/css">
</style> {+include("static/default.css")+}
</style>
</head> </head>
<body> <body>

View File

@ -1,39 +1,30 @@
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" ---
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> layout: default
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> title: "API - Index"
<head> ---
<meta http-equiv="content-type" content="text/html; charset={+IO.encoding+}"" />
<title>JsDoc Reference - Index</title> <style type="text/css">
<meta name="generator" content="JsDoc Toolkit" /> {+include("static/default.css")+}
</style>
<style type="text/css"> <div id="index">
{+include("static/default.css")+} {+publish.classesIndex+}
</style> </div>
</head>
<body> <div id="content">
{+include("static/header.html")+} <h1 class="classTitle">Class Index</h1>
<div id="index"> <for each="thisClass" in="data">
{+publish.classesIndex+} <div>
</div> <h2>{+(new Link().toSymbol(thisClass.alias))+}</h2>
{+resolveLinks(summarize(thisClass.classDesc))+}
</div>
<hr />
</for>
<div id="content"> </div>
<h1 class="classTitle">Class Index</h1>
<for each="thisClass" in="data"> <div class="fineprint" style="clear:both">
<div> <if test="JSDOC.opt.D.copyright">&copy;{+JSDOC.opt.D.copyright+}<br /></if>
<h2>{+(new Link().toSymbol(thisClass.alias))+}</h2> Documentation generated by <a href="http://www.jsdoctoolkit.org/" target="_blankt">JsDoc Toolkit</a> {+JSDOC.VERSION+} on {+new Date()+}
{+resolveLinks(summarize(thisClass.classDesc))+} </div>
</div>
<hr />
</for>
</div>
<div class="fineprint" style="clear:both">
<if test="JSDOC.opt.D.copyright">&copy;{+JSDOC.opt.D.copyright+}<br /></if>
Documentation generated by <a href="http://www.jsdoctoolkit.org/" target="_blankt">JsDoc Toolkit</a> {+JSDOC.VERSION+} on {+new Date()+}
</div>
</body>
</html>

View File

@ -64,7 +64,7 @@ function publish(symbolSet) {
var output = ""; var output = "";
output = classTemplate.process(symbol); output = classTemplate.process(symbol);
IO.saveFile(publish.conf.outDir+"symbols/", symbol.alias+publish.conf.ext, output); IO.saveFile(publish.conf.outDir+"symbols/", symbol.alias+publish.conf.ext+".md", output);
} }
// regenerate the index with different relative links, used in the index pages // regenerate the index with different relative links, used in the index pages
@ -78,7 +78,7 @@ function publish(symbolSet) {
catch(e) { print(e.message); quit(); } catch(e) { print(e.message); quit(); }
var classesIndex = classesindexTemplate.process(classes); var classesIndex = classesindexTemplate.process(classes);
IO.saveFile(publish.conf.outDir, "index"+publish.conf.ext, classesIndex); IO.saveFile(publish.conf.outDir, "index"+publish.conf.ext+".md", classesIndex);
classesindexTemplate = classesIndex = classes = null; classesindexTemplate = classesIndex = classes = null;
// create the file index page // create the file index page
@ -103,7 +103,7 @@ function publish(symbolSet) {
// output the file index page // output the file index page
var filesIndex = fileindexTemplate.process(allFiles); var filesIndex = fileindexTemplate.process(allFiles);
IO.saveFile(publish.conf.outDir, "files"+publish.conf.ext, filesIndex); IO.saveFile(publish.conf.outDir, "files"+publish.conf.ext+".md", filesIndex);
fileindexTemplate = filesIndex = files = null; fileindexTemplate = filesIndex = files = null;
} }
@ -149,7 +149,7 @@ function makeSrcFile(path, srcDir, name) {
} }
if (src.hilited) { if (src.hilited) {
IO.saveFile(srcDir, name+publish.conf.ext, src.hilited); IO.saveFile(srcDir, name+publish.conf.ext+".md", src.hilited);
} }
} }

2
pages

@ -1 +1 @@
Subproject commit 9ef772465fe1af3d1a75a7bd30558594686f02cc Subproject commit fef4a2da3c808762d5c54a6dbd4e65951712468d