Allow users to override the default template's layout file

[hegemonic]

In #472, @sporritt suggested that we allow users to override the layout.tmpl file in the default template. That makes it easy to control which CSS/JS files are pulled into each page, even if you don't want to fork the template.

Users should be able to specify another layout.tmpl file in the JSDoc config file. The key should be named something like templates.default.layout or templates.default.layoutFile. It should accept a relative path, to be resolved against...which directories exactly?

[sporritt]

for my specific use case it would suffice for it to resolve against the directory in which JSDoc is running, since I run JSDoc via Grunt on a build file in my project root. this is my first time using JSDoc, though - what other paths are significant and would make sense to add to the search path?

[hegemonic]

Fixed on master.

The config file can now contain a templates.default.layoutFile property, which specifies a relative or absolute path to a file that overrides the default template's layout.tmpl file.

Relative paths are resolved against the path to the config file; the current working directory; and the JSDoc directory, in that order.

[GloryWong]

Hi,
How can I control the CSS/JS files? I found that the CSS/JS files is permanently linked to defaults. It's not useful to add my CSS link to my customized tmpl