#27 - clean up hashParts logic | add comments

Author: mickmcgrath13

build/make_default_helpers.js

@@ -270,26 +270,31 @@ module.exports = function(docMap, config, getCurrent, Handlebars){
 					hashParts,
 					description,
 					linkText,
-					docObject;
+					docObject,
+					href;
 
 				name = parts ? parts[1].replace('::', '.prototype.') : content;
-				hashParts = name.split("#");
-
-				if(hashParts.length > 1){
-					name = hashParts[0];
-				}
 
+				//the name can be something like 'some-name#someId'
+				//this allows linking to a specific section with the hash syntax (#27)
+				hashParts = name.split("#");
+				name = hashParts.shift();
+				
 				docObject = docMap[name]
 				if (docObject) {
 					linkText = parts && parts[2] ? parts[2] : docObject.title || name;
 					description = docObject.description || name;
 
-					return '<a href="' + urlTo(name) + (hashParts.length > 1 ? ("#" + hashParts.slice(1).join("#")) : "") + '" title="' + stripMarkdown(description) + '">' + linkText + '</a>';
+					//if there is anything in the hashParts, append it to the end of the url
+					href = urlTo(name) + (hashParts.length >= 1 ? ("#" + hashParts.join("#")) : "");
+
+					return '<a href="' + href + '" title="' + stripMarkdown(description) + '">' + linkText + '</a>';
 				}
 
 				if (httpRegExp.test(name)) {
 					linkText = parts && parts[2] ? parts[2] : name;
-					return '<a href="' + name + '" title="' + escape(linkText) + '">' + linkText + '</a>';
+					href = name;
+					return '<a href="' + href + '" title="' + escape(linkText) + '">' + linkText + '</a>';
 				}
 
 				return match;