| | 3 | The HTML output also makes use of a basic !JavaScript ([http://www.w3schools.com/js/ JS]) file (by default located in {{{T3D_HOME/js/doc.js}}} and copied to a {{{js}}} sub-folder in the output directory), which provides some basic functionalities necessary for the enhanced navigation and toggling of details. Same rules as with the CSS file apply, customizations need to be moved upstream if they are to be reused in future documentation generations. Also adaptation of the XSLT file may be necessary if major new JS functionalities are introduced. Additionally, a second !JavaScript file called index.js is generated at runtime and then copied to the same folder as {{{doc.js}}}. This file is used to generate the ''construct index'' navigation in the main and module parameters views of the HTML documentation. Since this file is automatically generated with each documentation generation, it makes less sense to manipulate it upstream, instead it can be used for fine-tuning the final output. Due to the use of !JavaScript, if support for it is not available or disabled in the user's browser (due to security or other concerns), the navigation will not work properly. |
