The owner or authorized user of a valid copy of Mac OS X Server software may reproduce this publication for the purpose of learning to use such software. No part of this publication may be reproduced or transmitted for commercial purposes, such as selling copies of this publication or for providing paid-for support services. Every effort has been made to ensure that the information in this manual is accurate. Apple Inc. is not responsible for printing or clerical errors. Because Apple periodically releases new versions and updates to its software, images shown in this book may be different from what you see on your screen. Apple 1 Infinite Loop Cupertino, CA 95014-2084 408-996-1010 The Apple logo is a trademark of Apple Inc., registered in the U.S. and other countries. Use of the “keyboard” Apple logo (Option-Shift-K) for commercial purposes without the prior written consent of Apple may constitute trademark infringement and unfair competition in violation of federal and state laws. Apple, the Apple logo, iCal, iTunes, Leopard, Mac, Mac OS, and Macintosh are trademarks of Apple Inc., registered in the U.S. and other countries. Finder, Safari, and Time Machine are trademarks of Apple Inc. UNIX is a registered trademark of The Open Group. Other company and product names mentioned herein are trademarks of their respective companies. Mention of third-party products is for informational purposes only and constitutes neither an endorsement nor a recommendation. Apple assumes no responsibility with regard to the performance or use of these products. 019-1252/2008-04-24 Contents 5 Preface: About This Guide 5 Getting Additional Information 7 Chapter 1: Customizing How the Wiki Looks 7 Theme File Structure Overview 9 Variant Theme File Structure Overview 10 Wireframe Theme File Structure Overview 12 Creating a Theme 13 Editing CSS Files 14 Editing Property List Files 14 About Property List Editor 15 About Property List Files 17 Changing General Theme Settings 18 Creating Sidebars 22 Overview of the Example Sidebars 23 Using the Example Sidebars 25 Adding JavaScript and XSL Files 26 About JavaScript 27 About XSL 30 Chapter 2: Allowing Specific Protocols, CSS Styles, and HTML Tags and Attributes 31 Creating a Custom Whitelist 32 About the Custom Whitelist’s Structure 32 Allowing Specific URL Protocols 32 Allowing Specific CSS Styles 33 Allowing Specific HTML Tags and Attributes 34 About the Built-in Whitelist 34 Protocols Allowed in the Built-in Whitelist 35 CSS Styles Allowed in the Built-in Whitelist 35 HTML Tags and Attributes Allowed in the Built-in Whitelist 37 Chapter 3: Managing Wiki Content 37 Migrating Wiki Content From Other Websites 37 Backing Up the Wiki Server 39 Wiki File Structure Overview 40 Manually Editing Raw Content 41 Viewing a Wiki’s Administration Settings 44 Viewing a Page’s Metainformation 45 Managing Attachments Contents 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: A Create custom themes A Enable JavaScript, YouTube, and Flash A 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: A Getting Started—if you’re using Server Preferences A Web Technologies Administration—if you’re using Server Admin You can find both guides at the Mac OS X Server Resources website: For information about administering wikis, see Directory Help. You can view Directory Help by opening Directory (located in /Applications/Utilities/) and choosing Help > Directory Help. For information about using the wiki, see Wiki help. You can view Wiki help by clicking the Help link located at the bottom of any Apple Wiki page. Preface About This Guide 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: A Change the wiki’s title A Change the wiki’s theme A Add a custom tag-search sidebar to the main page A Choose who can make comments and which comments are mod...