How to define a custom main page on a YUIDoc-generated documentation

Question

I've been playing with YUIDoc and I find it fantastic.

By the way, I don't find a way to define my own main page content for the auto-generated documentation site (custom content inside the auto-generated index.html).

How can I define the main page content - if this is possible, of course -?

Thank you in advance!

Answer 1

YUI Doc is quite themable, so in theory this should be quite easy:

Fork YUI Doc or modify your current YUI Doc installation.

• Add your own theme under yuidoc/themes. Copying the default theme is probably a good place to start, or copy over the partials/files you want to override.
• In index.handlebars you add your custom content.
• You can also change the main.handlebars to include custom CSS, JS and/or markup.

When you now build the docs, use the --themedir switch to use your new theme:

$ yuidoc --themedir ./mytheme

Read more: On YUI Doc theming.