Jak zdefiniować niestandardową stronę główną w dokumentacji generowanej przez YUIDoc?

Question

Gram z YUIDoc i uważam, że jest fantastyczna.

Nawiasem mówiąc, nie znajduję sposobu, aby zdefiniować własną zawartość strony głównej dla automatycznie wygenerowanej strony z dokumentacją (niestandardowe treści wewnątrz automatycznie wygenerowanego index.html).

Jak zdefiniować zawartość strony głównej - , jeśli jest to możliwe, oczywiście -?

Z góry dziękuję!

Answer 1

YUI Doc jest dość themable, więc teoretycznie powinno to być dość łatwe:

Fork YUI Doc lub modyfikować bieżącą instalację YUI Doc.

• Dodaj własny motyw pod numerem yuidoc/themes. Kopiowanie domyślnego motywu jest prawdopodobnie dobrym początkiem, lub skopiuj części/pliki, które chcesz przesłonić.
• W index.handlebars dodajesz swoją niestandardową treść.
• Można także zmienić main.handlebars, aby uwzględnić niestandardowe arkusze CSS, JS i/lub znaczniki.

Kiedy teraz budować dokumenty, należy użyć przełącznika --themedir do korzystania z nowego motywu:

$ yuidoc --themedir ./mytheme 

Czytaj więcej: On YUI Doc theming.