Customizing HTML Templates

To edit the HTML templates, open the Preferences window (Edit > Settings... on Windows), select the "General" tab, and click "Edit HTML Template". A new template editor window will appear.

The Template Editor window has three tabs for the three different templates VersionTracker will use. More details about how each template is used and the replacement parameters are available on the specific subpages.

The HTML code editor will automatically save as changes are made.

Click the "Default Templates" button to restore the templates to the default values. Existing custom template values will be lost. VersionTracker will confirm this action.

Body Container

Version

Note Item

Tag / Value Placeholders

VersionTracker uses a special tag placeholder template format. The special format allows VersionTracker to replace empty tags with no content. Tags are in the format:

%TagName[%value%]%

The beginning %TagName identifies the tag and is removed always. The inner %value% placeholder is replaced with the value for the item. Special characters will be HTML encoded. The ending % is always removed.

Contents within the brackets are retained if the %value% for the item is not empty. When the %value% is empty the contents within the brackets are removed. An optional second set of brackets can define a replacement value for when %value% is empty. A missing second set is implicitly "replace with nothing" and is preferred when there is no empty-value replacement.

As an example this will replace the Reference Note as a link or with the word "None":

%reference[<a href="https://strawberrysw.com/issue/%value%">#%value%</a>][None]%