By default, there is no config.xml file, but a user may create a one so as to override:
- a small number of configuration settings currently not included in the document's Document Settings as well a limited range. Most settings relate to weblogs (now moribund) and RSS but two are for general use:
- RecentFileLimit. The number of recently used files to list. Default is 7.
- UniqueValueLimit. The maximum allowable number of discrete values for string-based attribute value lists. The current default is 999. If the limit is exceeded the attribute pop-up list is not shown.
- a limited range of options available in Document Settings (the supported items are not documented).
If created, a config.xml file is stored in the the config sub-folder of the Tinderbox Support folder. Tinderbox should be re-started after editing this file to ensure changes are detected.
When Tinderbox reads a custom config.xml from the application support folder, it first initialises the configuration to the built-in config.xml. Formerly, configurations left unspecified in the custom file used undocumented defaults.
Two further elements may be overridden in config.xml. The default font name sets the default $TextFont for newly-created documents, and 1-9 sets the relative $TextFontSize from 1 (tiny) to 9 (huge). For instance:
<TextFont>Helvetica Neue</TextFont>
<TextSize>4</TextSize>To support the wider range of font size selection possible in more recent versions (v7+) a new tag is supported to replace TextSize. NewTextSize holds the desired size a point value. Thus, to set a default 20pt size for $Text, add this to config.xml instead of the old TextSize tag:
<NewTextSize>20</NewTextSize>
The default content config.xml (as in the app package):
<config version="1">
<RecentPostLimit> 25 </RecentPostLimit>
<RecentFileLimit> 7 </RecentFileLimit>
<UniqueValueLimit> 999 </UniqueValueLimit>
<TechnoratiServer>http://rpc.technorati.com/rpc/ping</TechnoratiServer>
<TechnoratiMethod>weblogUpdates.ping</TechnoratiMethod>
<WeblogsComServer>http://rpc.weblogs.com/RPC2</WeblogsComServer>
<WeblogsComMethod>weblogUpdates.ping</WeblogsComMethod>
<FeedsterServer>http://api.feedster.com/ping</FeedsterServer>
<FeedsterMethod>weblogUpdates.ping</FeedsterMethod>
<GoogleServer>http://blogsearch.google.com/ping/RPC2</GoogleServer>
<GoogleMethod>weblogUpdates.extendedPing</GoogleMethod>
</config>New to v7, the Outline view darker colour option may be overridden at app level by adding this to the config.xml:
<DarkenOutlineColors> 0</DarkenOutlineColors>
The old <TextSize> which used numbered codes for size is superseded by (and trumped by if both are found) <NewTextSize> specified in point size, i.e '16' for 16-point text.