Apple Computer Hardware manual Getting Additional Information, Preface

Page 5

About This Guide

Preface

This guide explains how to create custom themes, allow specific protocols, CSS styles, and HTML tags and attributes, and manage wiki content.

The default Wiki Server configuration makes it easy for groups to collaborate and communicate. Users can create and edit wiki pages, tag and cross-reference material, upload files and images, add comments, and search content.

This guide shows you how to customize and extend the wiki to suit your needs. For example, you’ll learn how to:

ÂÂ Create custom themes

ÂÂ Enable JavaScript, YouTube, and Flash

ÂÂ Automate migration from other sources, such as wikis and non-wiki websites

The tasks described in this guide can be used on standard, workgroup, and advanced configurations of Leopard Server. These tasks require administrator access and in some cases programming skill. You must be able to edit files on the server, which aren’t accessible to most users. Be careful when editing these files, as an incorrect or untested change could cause problems.

Getting Additional Information

Information about setting up, administering, and using Wiki Server is covered in detail in several places.

For information about setting up web service, see:

ÂÂ Getting Started—if you’re using Server Preferences

ÂÂ Web Technologies Administration—if you’re using Server Admin

You can find both guides at the Mac OS X Server Resources website: www.apple.com/server/macosx/resources

 

5

Image 5

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 Property List Keys and Values About Property List FilesAbout Strings About DictionariesHere is the sidebars array in a plain text editor About ErrorsHere is an example of an array with a single string Here is an example of an array with multiple stringsDescription Changing General Theme SettingsKey Default Value Possible Values Understanding the Types of Sidebars Creating SidebarsShared Keys All sidebars require the following keysKey Example Value Possible Values Optional or Required Static Unique KeysEach dictionary entry has the following keys Search Unique Keys Calendar Unique Keys Tag Unique Keys Overview of the Example SidebarsRecent Activity Unique Keys Sidebar Name DescriptionTo comment out specific sidebars Using the Example SidebarsTerminal, enter the following command To this Put JavaScript .js files or XSL .xsl files in this folder Adding JavaScript and XSL FilesTo add JavaScript files or XSL files to a theme Topic About JavaScriptHere are some published JavaScript guides JavaScript Example About XSLTo view context Create a plain text file with the following contentViewing Dynamic XML $ sudo serveradmin stop teams sudo serveradmin start teams Attributes Creating a Custom Whitelist Allowing Specific CSS Styles About the Custom Whitelist’s StructureAllowing Specific URL Protocols Tag Attributes Allowing Specific Html Tags and AttributesTo allow specific Html tags and attributes Protocols Allowed in the Built-in Whitelist About the Built-in WhitelistBuilt-in whitelist allows these protocols ProtocolHtml Tags and Attributes Allowed in the Built-in Whitelist CSS Styles 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 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 ContentFor more information about AtomPub, see Viewing a Wiki’s Administration SettingsTo regenerate the index after editing raw wiki content Key Example Value Description Metadata.plist file includes the following keysTo manually edit wiki administration settings Pageuid Viewing a Page’s MetainformationManaging Attachments