The standard Cascading Stylesheet (CSS) file Autodoc.css is located in the program directorie's sub-folder templates. If you want to apply individual changes, you might copy it into a folder of your choice and use the -template command line parameter or the css parameter in the configuration file to set your copy as the stylesheet to be used by the program.
For ePub output, the slightly modified file Autodoc_Epub.css is used, which contains relative measures, like em, ex instead of fixed measures, like pt, px. This enables scaling in an ePub reader.
The first section of the CSS file contains the general settings. Here is defined, how the standard HTML elements, like <body>, <p>, tables and headings, etc., should look like.
In the second section of the CSS file, the elements of the documentation are defined. The following CSS classes are used:
Class | Elements |
---|---|
footer | The div containing the footer insert file (if specified). |
docsection | Formats for a new document section, like headers, etc. |
fileheading | Formats for a new file within the documentation. Used for page break. |
index | Formats for the index at the beginning of a file and the index summary. |
param | Formats for the sub-tags table output. |
struct | Formats for the structure output (default). |
structdetail | Formats for the structure detail output. |
structSection | Formats for the structure output of section tags (@progsection). |
structInclude | Formats for the structure output of the @includes tag. |
subtag | Formats the enclosing div element of sub tags (see example below). |
varsum | Formats for the variable summary table output. |
varsum | Formats for the variable summary table output. |
funcsum | Formats for the function summary table output. |
funcdetail | Formats for the function detail output. |
block | Format for @code tag in block mode. |
inline | Format for @code tag in inline mode. |
list | Format for left frame of the "frames" and "treeframes" output. |
logo | Format for img tag formatting the output of the logo image. |
sub-tag-name | Formats the enclosing div element of a certain sub tag (see example below). |
Also, it is possible to change the output of every sub tag or each sub tag indivisually. The sub tag output is wrapped into a div element, which gets the class name "subtag" and additionally the sub tag name as second class. For example a CSS definition like:
div.attention { border-left-style: solid; border-left-width: 5px; border-left-color: #ff0000; padding-left: 5px; }
will add a tick red border at the left of the @attention tag's output. And
div.subtag { border-left-style: solid; border-left-width: 5px; border-left-color: #ff0000; padding-left: 5px; }
would do the same with all sub tags.
In the third section, the tree view in the left frame of the "frames" and "treeframes" output are defined. The CSS class is "indexTree" and is an unordered list (<ul>).
In the fourth section, there are special settings for the "iframes" and "itreeframes" output are defined. These classes are used:
Class | Elements |
---|---|
Frames | The settings for the html and body tags. |
MainTable | The settings for the main table div of the main iframe file, containing the head and body. |
Head | The settings for the head div of the main iframe file, use for the header. |
Body | The settings for the body div of the main iframe file, which encloses the left list and the content. |
Leftlist | The settings for the left frame div of the main iframe file, where the index tree appears. |
Content | The settings for the right content frame div of the main iframe file, where the actual documentation appears. |
Via the headins and footins command line of configuration files parameter, you can specify a header insert file and/or a footer insert file respectively.
The content of the header insert file is, per default, placed between the <head> and </head> as the last entry. Here, you can define meta tags, java scripts, own styles, etc.
The footer insert file is, per default, placed in a div block between the pages <address> and </address>. Here, you can insert copyright notices, etc.
Since version 1.0.3 the of the documentation files is not hard coded into the program, but instead inserted at certain positions in template files. This allows the user to define own template files and influence the look of the documetation. For example, a company can change the templates to match it's coprporate identity look.
The template files are located in the programs templates directory and, as with the CSS file, can be copied into another directory and changed. This directory can be specified using the templatedir command line parameter or configuration file parameter.
To enable more flexibility, you may create a res folder within your templates folder, in which you can place additional files. These files are all copied into the output directory. This way you are able to add additional components, like stylesheets or images to your output, which you can also use in your own user defined templates.
There are four types of template files in AutoDoc:
Template File | Description |
---|---|
Templ_File.htm | This is the template for the output of each individual file's documentation. |
Templ_Index.htm | This is the template for the output of the documentation summary. (In a framed output shown in the right frame.) |
Templ_List.htm | This is the template for the output the index tree in the left frame (frames and treeframes output type only). |
Templ_Frames.htm | This is the template for the output the frame set (frames and treeframes output type only). |
Templ_IFrames.htm | This is the template for the output the iframe set (iframes and itreeframes output type only). |
The documentations content will be inserted into these template files at the points specified by replacement variables. For the Templ_File.htm these replacement variables are defined in the template:
Replacement Variable | Description |
---|---|
%TITLE% | Here the title specified by the title parameter is inserted. |
%HEADINS% | Here the content fo the header insert file is inserted. |
%CONTENT% | Here the documentation's content is inserted. |
%FOOTINS% | Here the content fo the footer insert file is inserted. |
For ePub output the template file Templ_File_Epub.htm is used, since ePub format requires special document types. The replacement variables are the same.
For the Templ_Index.htm these replacement variables are defined in the template:
Replacement Variable | Description |
---|---|
%TITLE% | Here the title specified by the title parameter is inserted. |
%HEADINS% | Here the content fo the header insert file is inserted. |
%INDEXCONTENT% | Here the documentation's index is inserted. |
%FOOTINS% | Here the content fo the footer insert file is inserted. |
For the Templ_List.htm these replacement variables are defined in the template:
Replacement Variable | Description |
---|---|
%TITLE% | Here the title specified by the title parameter is inserted. |
%JSTREELIST% | Here the JavaScript part for the TreeView is inserted. |
%LISTCONTENT% | Here the documentation's index tree is inserted. |
%SEARCHFRAME% | Here the documentation's search frame is inserted, if search is enabled. |
For the Templ_Frames.htm these replacement variables are defined in the template:
Replacement Variable | Description |
---|---|
%TITLE% | Here the title specified by the title parameter is inserted. |
%HEADINS% | Here the content fo the header insert file is inserted. |
For the Templ_IFrames.htm these replacement variables are defined in the template:
Replacement Variable | Description |
---|---|
%TITLE% | Here the title specified by the title parameter is inserted. |
%HEADINS% | Here the content fo the header insert file is inserted. |
%LOGOIMG% | Here the logo image defined by the logo parameter is inserted. |
For the Templ_LaTeX.tex these replacement variables are defined in the template:
Replacement Variable | Description |
---|---|
%TITLE% | Here the title specified by the title parameter is inserted. |
%AUTHOR% | Here the authors are inserted. |
%CONTENT% | Here the documentation's content is inserted. |
%HEADINS% | Here the content fo the header insert file is inserted. |
%FOOTINS% | Here the content fo the footer insert file is inserted. |
For the Templ_PDFLaTeX.tex these replacement variables are defined in the template:
Replacement Variable | Description |
---|---|
%TITLE% | Here the title specified by the title parameter is inserted. |
%AUTHOR% | Here the authors are inserted. |
%CONTENT% | Here the documentation's content is inserted. |
%HEADINS% | Here the content fo the header insert file is inserted. |
%FOOTINS% | Here the content fo the footer insert file is inserted. |