Formatting the documentation

The basic output format for the generated documentation is HTML. For formatting HTML files, the World Wide Web Consortium (W3C) has provided CSS (Cascading Style Sheets), a style sheet language that separates the display specifications from the content. When generating the documentation, you can specify how the generated documentation should be formatted by selecting a CSS file (see CSS template selection box).

The advantage of this approach is that you can create the documentation in the PLC code without formatting instructions. For formatting, you provide one or more CSS files that adapt the generated documentation accordingly without having to make any changes to the documentation.

After installing the workload TE1030 | TwinCAT 3 Documentation Generation, there are two sample templates for CSS files in the folder
C:\Program Files (x86)\Beckhoff\TwinCAT\3.1\Components\TcDocGen\Templates\CSS
. You can expand or modify these according to your needs. The modified or newly created templates must be available again in this folder in order to be used.
There are two ways to make the templates available in this folder:

1. You can manually copy the changed or new templates to the folder.
2. You can use the ... button behind the CSS templates to open a selection window and select the templates. They will be automatically copied to the folder.