Apple Computer Hardware manual About Property List Files, About Property List Keys and Values

Page 15

Property List Editor doesn’t show comments, so if you want to see the example sidebars provided in the wireframe’s theme.plist, you’ll need to open the theme.plist file in a text editor and remove the comment markers surrounding the example sidebars.

About Property List Files

The theme.plist file is structured like an XML file. If you understand XML, editing the theme.plist is straightforward. If not, read the following sections for basic editing information.

About Property List Keys and Values

Every setting controlled by the theme.plist file has a key, and an associated value or an array (a collection) of associated values. To change the setting, you change the value or values, not the key.

For example, to halve the height of the banner image in Property List Editor, double- click the value 99 next to bannerImageHeight and replace it with 50.

To halve the height of the banner image in a text editor, change the following lines in the theme.plist:

<key>bannerImageHeight</key>

<real>99</real>

to:

<key>bannerImageHeight</key>

<real>50</real>

About Strings

Most of the values in the theme.plist file are character sequences called strings.

About Dictionaries

A dictionary, or dict when viewed in a text editor, is an assortment of values of different classes. In the theme.plist file, a sidebar is represented by a dictionary.

Because a dictionary can contain several values, Property List Editor provides a disclosure triangle that allows you to view or hide the contents of the dictionary.

About Arrays

Arrays are collections or lists of similar classes. The theme.plist file includes two types of arrays: a list of dictionaries and a list of strings.

The sidebars array is an example of a dictionary array. Because the sidebars array is commented out by default, you won’t be able to see it in Property List Editor without first removing the comment markers in a text editor.

Because an array can contain several values, Property List Editor provides a disclosure triangle that allows you to view or hide the contents of the array.

Chapter 1    Customizing How the Wiki Looks

15

Image 15

Contents Mac OS X Server 019-1252/2008-04-24 Contents Managing Wiki Content Preface Getting Additional InformationPreface About This Guide Theme File Structure Overview This chapter describes how to customize a wiki’s appearanceCustomizing How the Wiki Looks Variant Theme File Structure Overview File or Folder Name Purpose Wireframe Theme File Structure OverviewBorders, and positioning for comment entry Creating a Theme Terminal, enter the following commandsWebsite Editing CSS FilesAbout Property List Editor Editing Property List FilesAbout Dictionaries About Property List FilesAbout Property List Keys and Values About StringsHere is an example of an array with multiple strings About ErrorsHere is the sidebars array in a plain text editor Here is an example of an array with a single stringChanging General Theme Settings Key Default Value Possible ValuesDescription All sidebars require the following keys Creating SidebarsUnderstanding the Types of Sidebars Shared KeysStatic Unique Keys Each dictionary entry has the following keysKey Example Value Possible Values Optional or Required Search Unique Keys Calendar Unique Keys Sidebar Name Description Overview of the Example SidebarsTag Unique Keys Recent Activity Unique KeysUsing the Example Sidebars Terminal, enter the following commandTo comment out specific sidebars To this Adding JavaScript and XSL Files To add JavaScript files or XSL files to a themePut JavaScript .js files or XSL .xsl files in this folder About JavaScript Here are some published JavaScript guidesTopic JavaScript Example About XSLCreate a plain text file with the following content Viewing Dynamic XMLTo view context $ sudo serveradmin stop teams sudo serveradmin start teams Attributes Creating a Custom Whitelist About the Custom Whitelist’s Structure Allowing Specific URL ProtocolsAllowing Specific CSS Styles Allowing Specific Html Tags and Attributes To allow specific Html tags and attributesTag Attributes Protocol About the Built-in WhitelistProtocols Allowed in the Built-in Whitelist Built-in whitelist allows these protocolsBuilt-in whitelist allows these Html tags and attributes CSS Styles Allowed in the Built-in WhitelistHtml Tags and Attributes Allowed in the Built-in Whitelist Built-in whitelist allows these CSS stylesNode Pre Cite Span Strong Tbody Tfoot Colspan, rowspan Thead Backing Up the Wiki Server Migrating Wiki Content From Other WebsitesManaging Wiki Content Wiki File Structure Overview File or Folder Name Purpose Manually Editing Raw ContentViewing a Wiki’s Administration Settings To regenerate the index after editing raw wiki contentFor more information about AtomPub, see Key Example Value Description Metadata.plist file includes the following keysTo manually edit wiki administration settings Pageuid Viewing a Page’s MetainformationManaging Attachments