Apple Computer Hardware manual Here is the sidebars array in a plain text editor, About Comments

Page 16

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

Page 15 Page 17
Image 16
Page 15 Page 17
Contents Mac OS X Server 019-1252/2008-04-24 Contents Managing Wiki Content Getting Additional Information PrefacePreface About This Guide This chapter describes how to customize a wiki’s appearance Theme File Structure OverviewCustomizing How the Wiki Looks Variant Theme File Structure Overview Wireframe Theme File Structure Overview File or Folder Name PurposeBorders, and positioning for comment entry Terminal, enter the following commands Creating a Theme Editing CSS Files WebsiteEditing Property List Files About Property List EditorAbout Property List Files About Property List Keys and ValuesAbout Strings About DictionariesAbout Errors Here is the sidebars array in a plain text editorHere is an example of an array with a single string Here is an example of an array with multiple stringsKey Default Value Possible Values Changing General Theme SettingsDescription Creating Sidebars Understanding the Types of SidebarsShared Keys All sidebars require the following keysEach dictionary entry has the following keys Static Unique KeysKey Example Value Possible Values Optional or Required Search Unique Keys Calendar Unique Keys Overview of the Example Sidebars Tag Unique KeysRecent Activity Unique Keys Sidebar Name DescriptionTerminal, enter the following command Using the Example SidebarsTo comment out specific sidebars To this To add JavaScript files or XSL files to a theme Adding JavaScript and XSL FilesPut JavaScript .js files or XSL .xsl files in this folder Here are some published JavaScript guides About JavaScriptTopic About XSL JavaScript ExampleViewing Dynamic XML Create a plain text file with the following contentTo view context $ sudo serveradmin stop teams sudo serveradmin start teams Attributes Creating a Custom Whitelist Allowing Specific URL Protocols About the Custom Whitelist’s StructureAllowing Specific CSS Styles To allow specific Html tags and attributes Allowing Specific Html Tags and AttributesTag Attributes About the Built-in Whitelist Protocols Allowed in the Built-in WhitelistBuilt-in whitelist allows these protocols ProtocolCSS Styles Allowed in the Built-in Whitelist Html Tags and Attributes Allowed in the Built-in WhitelistBuilt-in whitelist allows these CSS styles Built-in whitelist allows these Html tags and attributesNode Pre Cite Span Strong Tbody Tfoot Colspan, rowspan Thead Migrating Wiki Content From Other Websites Backing Up the Wiki ServerManaging Wiki Content Wiki File Structure Overview Manually Editing Raw Content File or Folder Name PurposeTo regenerate the index after editing raw wiki content Viewing a Wiki’s Administration SettingsFor more information about AtomPub, see Metadata.plist file includes the following keys Key Example Value DescriptionTo manually edit wiki administration settings Viewing a Page’s Metainformation PageuidManaging Attachments
Top Page Image Contents