Menu
▾
▴
[Pasdoc-main] HTML5, --html-head/body options, Tipue improvements
|
From: Michalis K. <mic...@gm...> - 2017-03-01 02:46:11
|
Hi, Some new features and improvements! 1. Our HTML output is now HTML5 -- it uses HTML5 doctype, and avoids some deprecated things. This makes it easy to integrate our output with modern things prepared for HTML5, like Bootstrap. 2. I added command-line options --html-head, --html-body-begin, --html-body-end . --html-head adds content inside HTML <head> element. E.g. links to additional CSS files. --html-body-begin adds content right after <body>. --html-body-end adds content right before </body>. They are documented in more details on https://github.com/pasdoc/pasdoc/wiki/HtmlHeadBodyBeginEndOptions . Together, these options can be used to customize the output HTML pages in many ways. See for example my Castle Game Engine API reference on: https://castle-engine.sourceforge.io/apidoc/html/introduction.html Using the above options, the API reference generated by PasDoc looks a bit like the normal part of the Castle Game Engine ( https://castle-engine.sourceforge.io/ ) webpage, with normal navigation and styling. 3. I improved the Tipue working: it now references the (large) "tipuesearch_data.js" only on the "Search Results" page. This means that Tipue doesn't cause a slowdown when browsing your documentation -- the search data is loaded only when really necessary, when you initiated some search. I also reworked the docs on https://github.com/pasdoc/pasdoc/wiki/UseTipueSearchOption . Best regards, Michalis |
