Apple Computer Hardware manual Static Unique Keys, Each dictionary entry has the following keys

Page 19

Static Unique Keys

Static sidebars list predefined URLs. “Useful Links” is an example static sidebar.

Static sidebars have the following keys:

Key

Example Value

Possible Values

Optional or Required

Description

urls

Not applicable

An array of dictionary

Required

 

 

entries, each representing

 

 

 

a single link

 

Because links include several values, such as the name of the link and the URL itself, every link is represented by a dictionary entry.

headerURL

http://example.com/

Fully qualified URL

Optional

A URL that is linked to

 

groups/groupname/search

 

 

from the sidebar’s header.

 

/?sort=modifiedDate&kind

 

 

 

 

=wiki&kind=weblog&kind

 

 

 

 

=mailinglist&sortDirection

 

 

 

 

=reverse&excludePages=

 

 

 

 

wiki/welcome

 

 

 

 

 

 

 

 

feedURL

feed://example.com/

Fully qualified URL

Optional

An RSS or Atom feed that

 

groups/groupname/

 

 

is associated with the

 

search/index.rss?sort=mod

 

 

sidebar.

 

ifiedDate&kind=wiki&kind

 

 

 

 

=weblog&kind=mailinglist

 

 

 

 

&sortDirection=reverse&

 

 

 

 

excludePages=wiki/

 

 

 

 

welcome

 

 

 

 

 

 

 

Each dictionary entry has the following keys:

 

Key

Example Value

Possible Values

Optional or Required

Description

 

 

 

 

 

kind

url

url, wiki, weblog,

Required

Not used in any themes.

 

 

mailinglist, calendar

 

Use this to assign a class to

 

 

 

 

a sidebar.

 

 

 

 

You can then use the

 

 

 

 

class selector in CSS

 

 

 

 

to customize sidebars,

 

 

 

 

such as by adding small

 

 

 

 

calendar icons next to

 

 

 

 

calendar sidebar links or

 

 

 

 

small Safari icons next to

 

 

 

 

URL links.

 

 

 

 

 

subtitle

Your server’s homepage,

Any string

Required

Appears under the name

 

List of groups with wikis

 

 

of the link.

 

on this server

 

 

 

 

 

 

 

 

title

Server Home, Groups

Any string

Required

Name of the link.

 

 

 

 

 

uid

serverhome, groups

Any string

Required

Identifier for the URL. This

 

 

 

 

value must be unique.

 

 

 

 

 

url

/, /groups/

A relative or absolute path

Required

Contents of the link.

 

 

to a web page

 

 

 

 

 

 

 

Chapter 1    Customizing How the Wiki Looks

19

Image 19
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 stringKey Default Value Possible Values Changing General Theme SettingsDescription All sidebars require the following keys Creating SidebarsUnderstanding the Types of Sidebars Shared KeysEach dictionary entry has the following keys Static Unique 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 KeysTerminal, 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 JavaScript Example About XSLViewing 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 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 ContentTo regenerate the index after editing raw wiki content Viewing a Wiki’s Administration SettingsFor 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