Theme File Structure Overview | Apple Computer Hardware specification

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

Apple Computer Hardware manual This chapter describes how to customize a wiki’s appearance, Theme File Structure Overview

Contents

Mac OS X Server 019-1252/2008-04-24 Contents Managing Wiki Content Preface Getting Additional Information Preface About This Guide Theme File Structure Overview This chapter describes how to customize a wiki’s appearance Customizing How the Wiki Looks Variant Theme File Structure Overview File or Folder Name Purpose Wireframe Theme File Structure Overview Borders, and positioning for comment entry Creating a Theme Terminal, enter the following commands Website Editing CSS Files About Property List Editor Editing Property List Files About Dictionaries About Property List FilesAbout Property List Keys and Values About Strings Here 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 string Key Default Value Possible Values Changing General Theme SettingsDescription All sidebars require the following keys Creating SidebarsUnderstanding the Types of Sidebars Shared Keys Each 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 Keys Terminal, 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 XSL Viewing 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 protocols Built-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 styles Node Pre Cite Span Strong Tbody Tfoot Colspan, rowspan Thead Backing Up the Wiki Server Migrating Wiki Content From Other Websites Managing Wiki Content Wiki File Structure Overview File or Folder Name Purpose Manually Editing Raw Content To 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 keys To manually edit wiki administration settings Pageuid Viewing a Page’s Metainformation Managing Attachments