Apple Mac OS X Server (Extending Your Wiki Server For Version 10.5 Leopard) User Manual

Page 16

Advertising
background image

Here is the sidebars array in a plain text editor:

<key>sidebars</key>
<array>
<dict>
sidebar keys and values
</dict>
<dict>
sidebar keys and values
</dict>
</array>

Here is an example of an array with a single string:

<array>
<string>value</string>
</array>

Here is an example of an array with multiple strings:

<array>
<string>value</string>
<string>value 2</string>
</array>

About Comments

The theme.plist file includes comments to help provide editing instructions and
example keys and values. Comments are ignored when the theme.plist file is read by
the wiki server.

Comments start with “<!--” and end with “-->.” Everything in between is ignored, even if
the comment contains many lines of keys and values.

For example, the wireframe theme’s theme.plist file includes the following comment to
indicate where the example sidebars section starts:

<!-- example (non-default) sidebars -->

The sidebars array is preceded by a <!-- comment marker. The end comment marker
doesn’t appear until after the array. Because the comment markers surround the array,
the code for these sidebars in the array is ignored unless the comment markers are
removed.

About Errors

Make sure all required values are present. If you don’t include required keys and values
in the theme.plist file (for example, a displayName or a uid for a sidebar), loading the
wiki’s main page will display an “Internal Server Error” page. Wiki pages that don’t have
sidebars won’t display this error.

16

Chapter 1

Customizing How the Wiki Looks

Advertising