Update to latest template that works well with online doc app for #16

Author: kcoleman-marklogic

etc/marklogic-template/README.md

@@ -0,0 +1,25 @@
+# Template for API Documentation
+
+This directory contains a template for generating JSDoc API docs
+with gulp-jsdoc. The contents are derived from the bootswatch
+"simplex" template, as generated by docstrap.
+
+The original template was modified in the following ways:
+* Minor color, font and other aethestic changes using the usual
+  docstrap variables.
+* Removed the @import of google fonts because they are not
+  always reachable and can cause long page loads.
+* Removed all embedded javascript so the pages can safely be hosted 
+  by MarkLogic Server as XHTML. This meant trouncing on some of the
+  configurable parts of the original setting. For example, you cannot
+  enable Google analytics, despite what docstrap thinks.
+
+To generate the docs using this template, run "gulp doc" from the
+root project directory.
+
+You can also use an alternative docstrap/bootswatch or a custom template
+of your choosing. To use a different template:
+* Edit gulpfile.js in the root project directory and change the "path"
+  and "theme" values of the "doc" task.
+* Run "gulp doc" from the root project directory. The docs are
+  generated into a doc/ subdirectory.

etc/marklogic-template/static/scripts/extracted/nav.js

@@ -0,0 +1,34 @@
+// Extracted from layout.html
+		$( function () {
+			$( '#main' ).localScroll( {
+				offset : { top : 60 } //offset by the height of your header (give or take a few px, see what works for you)
+			} );
+			$( "dt.name" ).each( function () {
+				var $this = $( this ).find("h4");
+				var icon = $( "<i/>" ).addClass( "icon-plus-sign" ).addClass( "pull-right" ).addClass( "icon-white" );
+				var dt = $(this);
+				var children = dt.next( "dd" );
+
+				dt.prepend( icon ).css( {cursor : "pointer"} );
+				dt.addClass( "member-collapsed" ).addClass( "member" );
+
+
+				children.hide();
+
+				dt.children().on( "click", function () {
+					children = dt.next( "dd" );
+					console.debug(dt, children)
+					children.slideToggle( "fast", function () {
+
+						if ( children.is( ":visible" ) ) {
+							icon.addClass( "icon-minus-sign" ).removeClass( "icon-plus-sign" ).removeClass( "icon-white" );
+							dt.addClass( "member-open" ).animate( "member-collapsed" );
+						} else {
+							icon.addClass( "icon-plus-sign" ).removeClass( "icon-minus-sign" ).addClass( "icon-white" );
+							dt.addClass( "member-collapsed" ).removeClass( "member-open" );
+						}
+					} );
+				} );
+
+			} );
+		} );

etc/marklogic-template/static/scripts/extracted/toc.js

@@ -0,0 +1,52 @@
+// Extracted from layout.html
+		$( function () {
+			$( "[id*='$']" ).each( function () {
+				var $this = $( this );
+
+				$this.attr( "id", $this.attr( "id" ).replace( "$", "__" ) );
+			} );
+
+			$( "#toc" ).toc( {
+				anchorName  : function ( i, heading, prefix ) {
+					return $( heading ).attr( "id" ) || ( prefix + i );
+				},
+				selectors   : "h1,h2,h3,h4",
+				showAndHide : false,
+				scrollTo    : "100px"
+			} );
+
+			$( "#toc>ul" ).addClass( "nav nav-pills nav-stacked" );
+			$( "#main span[id^='toc']" ).addClass( "toc-shim" );
+			$( '.dropdown-toggle' ).dropdown();
+//			$( ".tutorial-section pre, .readme-section pre" ).addClass( "sunlight-highlight-javascript" ).addClass( "linenums" );
+
+			$( ".tutorial-section pre, .readme-section pre" ).each( function () {
+				var $this = $( this );
+
+				var example = $this.find( "code" );
+				exampleText = example.html();
+				var lang = /{@lang (.*?)}/.exec( exampleText );
+				if ( lang && lang[1] ) {
+					exampleText = exampleText.replace( lang[0], "" );
+					example.html( exampleText );
+					lang = lang[1];
+				} else {
+					lang = "javascript";
+				}
+
+				if ( lang ) {
+
+					$this
+						.addClass( "sunlight-highlight-" + lang )
+						.addClass( "linenums" )
+						.html( example.html() );
+
+				}
+			} );
+
+			Sunlight.highlightAll( {
+				lineNumbers : true,
+				showMenu : true,
+				enableDoclinks : true
+			} );
+		} );