Apple Computer Hardware manual This chapter describes how to customize a wiki’s appearance

Page 7

Customizing How the Wiki Looks 1

This chapter describes how to customize a wiki’s appearance.

You can use a wiki’s admin settings to do the following: ÂÂ Change the wiki’s title

ÂÂ Change the wiki’s theme

ÂÂ Add a custom tag-search sidebar to the main page

ÂÂ Choose who can make comments and which comments are moderated ÂÂ Create a podcast and integrate it with iTunes

These settings are sufficient for most wikis. However, if you have special needs—for example, if you want to use a specific organization’s style, or if you want to change the appearance and names of the default sidebars on the front page—you must edit files located on the server.

Theme File Structure Overview

A theme is composed of Cascading Style Sheet (.css) files, property list (.plist) files, image files (usually .png and .jpg), and sometimes JavaScript (.js) and Extensible Stylesheet Language (.xsl) files.

All themes use the CSS files located at: /usr/share/collaboration/css/required/

 

7

Image 7

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