Apple Computer Hardware manual Overview of the Example Sidebars, Tag Unique Keys

Page 22

Tag Unique Keys

Tag sidebars list wiki, blog, and mailing list entries that use a specific tag or set of tags. The most recently modified entries are listed first.

Tag sidebars have the following unique keys:

Key

Example Value

Possible Values

Optional or Required

Description

tag	hot	A single string or several	Required
		strings all in the same
		array

Tags associated with the sidebar. Pages using all of these tags are added to the sidebar.

howMany	5	Any number, 1 or more	Required	Maximum number of
				entries in the sidebar.

emptyListString	There are no matches.	Any string	Optional	Shown when there are no
				matching search results.

Recent Activity Unique Keys

Recent activity sidebars list pages that have had the most readers recently.

Recent activity sidebars have the following unique keys:

Key	Example Value	Possible Values	Optional or Required	Description

howMany	5	Any number, 1 or more	Required	Maximum number of
				entries in the sidebar.

emptyListString	There are no matches.	Any string	Optional	Shown when there are no
				matching search results.

Overview of the Example Sidebars

The wireframe theme’s theme.plist provides several example sidebars:

Sidebar Name	Description
What’s Hot	Lists the five most recently modified pages tagged with
	“hot.”

What’s New	Lists the five most recently created pages. This includes
	wiki, weblog, and mailing list pages.

Useful Links	Lists several predefined links.

Upcoming Events	Lists all events occurring within the next five days.

22

Chapter 1    Customizing How the Wiki Looks

Image 22

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 ThemeEditing CSS Files WebsiteEditing Property List Files About Property List EditorAbout Strings About Property List FilesAbout Property List Keys and Values About DictionariesHere is an example of an array with a single string About ErrorsHere is the sidebars array in a plain text editor Here is an example of an array with multiple stringsKey Default Value Possible Values Changing General Theme SettingsDescription Shared Keys Creating SidebarsUnderstanding the Types of Sidebars 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 Recent Activity Unique Keys Overview of the Example SidebarsTag 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 Built-in whitelist allows these protocols About the Built-in WhitelistProtocols Allowed in the Built-in Whitelist ProtocolBuilt-in whitelist allows these CSS styles CSS Styles Allowed in the Built-in WhitelistHtml Tags and Attributes Allowed in the Built-in Whitelist 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