Use github like ids for heading anchors

Author: Manuel Mujica

make-example.js

@@ -18,7 +18,7 @@ generate(docMap, {
 			"bit-docs-docjs-theme": __dirname,
 			"bit-docs-prettify": "^0.1.0",
 			"bit-docs-html-highlight-line": "^0.2.2",
-			"bit-docs-html-toc": "^0.2.1"
+			"bit-docs-html-toc": "^0.4.0"
 		}
 	},
 	dest: path.join(__dirname, "temp"),

static/docjs.js

@@ -3,12 +3,19 @@ var $ = require("jquery");
 require("./styles/styles.less");
 
 $(function() {
+	var headings = {};
+
 	collectHeadings().each(function() {
 		var $el = $(this);
 		var id = $el.attr("id");
 
 		if (!id) {
-			id = "section_" + $el.text().replace(/\s/g, "").replace(/[^\w]/g, "_");
+			id = makeAnchorHeadingId($el.text());
+			var count = headings[id] || 0;
+
+			id += (count > 0) ? "-" + count : "";
+			headings[id] = count + 1;
+
 			$el.attr("id", id);
 		}
 
@@ -19,6 +26,13 @@ $(function() {
 		return $(".content .comment h2, .content .comment h3");
 	}
 
+	function makeAnchorHeadingId(anchorText) {
+		return (anchorText || "")
+		.replace(/\s/g, "-")       // replace spaces with dashes
+		.replace(/[^\w\-]/g, "")   // remove punctuation
+		.toLowerCase();
+	}
+
 	function anchorTemplate(ctx) {
 		var id = encodeURIComponent(ctx.id);