Mac OS X Server Wiki Server Administration Version 10.6 Snow Leopard Kkapple Inc
Total Page:16
File Type:pdf, Size:1020Kb
Mac OS X Server Wiki Server Administration Version 10.6 Snow Leopard K Apple Inc. Apple, the Apple logo, iCal, iTunes, Mac, Mac OS, © 2009 Apple Inc. All rights reserved. MacBook, Macintosh, and QuickTime, are trademarks of Apple Inc., registered in the U.S. and other countries. The owner or authorized user of a valid copy of Apple Remote Desktop, Extensions Manager, Finder, Mac OS X Server software may reproduce this iWork, Safari, and Snow Leopard are trademarks of publication for the purpose of learning to use such Apple Inc. Mac is a service mark of Apple Inc. software. No part of this publication may be reproduced or transmitted for commercial purposes, such as selling Adobe, the Adobe logo, Acrobat, the Acrobat logo, copies of this publication or for providing paid-for Distiller, PostScript, and the PostScript logo are support services. trademarks or registered trademarks of Adobe Systems incorporated in the U.S. and/or other countries. Every effort has been made to ensure that the information in this manual is accurate. Apple Inc. is not Java™ and all Java-based trademarks and logos responsible for printing or clerical errors. are trademarks or registered trademarks of Sun Microsystems, Inc. in the U.S. and other countries. Apple 1 Infinite Loop UNIX® is a registered trademark of The Open Group. Cupertino CA 95014 www.apple.com Other company and product names mentioned herein are trademarks of their respective companies. Mention Use of the “keyboard” Apple logo (Option-Shift-K) for of third-party products is for informational purposes commercial purposes without the prior written consent only and constitutes neither an endorsement nor a of Apple may constitute trademark infringement and recommendation. Apple assumes no responsibility with unfair competition in violation of federal and state laws. regard to the performance of these products. 019-1404/2009-08-01 Contents 7 Preface: About This Guide 7 What’s New in Wiki Server 8 What's in This Guide 9 Using Onscreen Help 10 Documentation Map 11 Viewing PDF Guides Onscreen 11 Printing PDF Guides 12 Getting Documentation Updates 12 Getting Additional Information 13 Chapter 1: About Wikis, Blogs, Web Calendars, and Mailing Lists 13 About Wikis 14 About Blogs 14 About Web Calendars 14 About Mailing Lists 15 Chapter 2: Enabling and Configuring Wikis, Blogs, Web Calendars, and Mailing Lists 15 Setting Up Wiki Server 15 Setting Up and Starting iCal Service on the Wiki Server 16 Setting Up iCal Service on a Different Server than the Wiki Server 18 Configuring Wiki Settings for All Websites 19 Configuring Other Servers for Web Calendars and Mail Rules 20 Configuring Other Servers for Hosting Wikis 22 Setting Up a Website for Wikis 23 Starting Up Web Service 24 Connecting to Wikis 26 Configuring Individual Wikis 26 About Wiki Security 27 Chapter 3: Customizing How the Wiki Looks 27 Theme File Structure Overview 29 Variant Theme File Structure Overview 3 30 Wireframe Theme File Structure Overview 32 Creating a Theme 33 Editing CSS Files 34 Editing Property List Files 35 About Property List Editor 35 About Property List Files 38 Changing General Theme Settings 39 Creating Sidebars 45 Overview of the Example Sidebars 45 Using the Example Sidebars 47 Adding JavaScript and XSL Files 47 About JavaScript 51 About XSL 52 Customizing My Page 52 Changing Text Shown in Wikis and Blogs Lists 54 Changing the My Page Theme 56 Testing Wiki Code Changes 57 Chapter 4: Allowing Specific Protocols, CSS Styles, and HTML Tags and Attributes 57 Creating a Custom Whitelist 58 About the Custom Whitelist’s Structure 59 Allowing Specific URL Protocols 59 Allowing Specific CSS Styles 60 Allowing Specific HTML Tags and Attributes 61 About the Built-in Whitelist 61 Protocols Allowed in the Built-in Whitelist 62 CSS Styles Allowed in the Built-in Whitelist 62 HTML Tags and Attributes Allowed in the Built-in Whitelist 64 Chapter 5: Allowing Specific File Types for Quick Look 64 About the Whitelist 66 Adding Quick Look Support for File Types 68 Chapter 6: Managing Wiki Content 68 Migrating Wiki Content from Other Websites 68 Backing Up the Wiki Server 69 Moving Wiki Content 69 Moving the Wiki Server Volume from One Drive to Another 70 Moving a Wiki Server Volume from One Server to Another with the Same Hardware Configuration 71 Moving Wiki Content from One Server to Another with a Different Hardware Configuration 4 Contents DraftVersion 73 Wiki File Structure Overview 74 Manually Editing Raw Content 75 Viewing a Wiki’s Administration Settings 78 Viewing a Page’s Metainformation 79 Managing Attachments 80 Configuring Wiki Server Settings from the Command Line 83 Choosing Who Can Administer Wiki Server 84 Index Contents 5 6 About This Guide Preface This guide explains how to set up, customize, and extend wiki services. Mac OS X Server includes wiki services, which allow you to set up personal and group wikis, blogs, and web calendars. The default wiki services 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. In addition to showing you how to set up wiki services, this guide shows you how to customize and extend them to suit your needs. For example, you’ll learn how to:  Create custom themes  Enable JavaScript, YouTube, and Flash  Enable Quick Look for more file types  Automate migration from other sources, such as wikis and non-wiki websites Customizing and extending wiki services requires 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. An incorrect or untested change could cause problems. What’s New in Wiki Server  Users create and administrate their own wikis and blogs. After enabling wiki services, users can create wikis and blogs. They can choose which wiki services to enable, such as just the wiki and calendar, and they can choose who can access their wiki services. Users can do these tasks within the wiki tools, so server administrators don’t need to be involved. Server administrators can restrict who is allowed to create wikis and blogs. For more information, see Wiki Help or Wiki Tools Deployment Guide. 7  Quick Look support. Users can use Quick Look to preview attached files without downloading the files. By default, users can use Quick Look to preview any file types that can be previewed in Finder, such as Keynote, Pages, and PDF files. You can enable Quick Look for more file types. For more information, see Chapter 5, “Allowing Specific File Types for Quick Look.”  Improved iPhone support. Wiki tools look and work better than ever on iPhone. For more information, see Wiki Help on iPhone. What's in This Guide This guide includes the following chapters:  Chapter 1, “About Wikis, Blogs, Web Calendars, and Mailing Lists,” highlights important collaboration concepts and introduces wiki tools.  Chapter 2, “Enabling and Configuring Wikis, Blogs, Web Calendars, and Mailing Lists,” shows you how to use Server Admin to set up wiki services.  Chapter 3, “Customizing How the Wiki Looks,” describes how to create custom themes and edit CSS, property list, JavaScript, and XSL files.  Chapter 4, “Allowing Specific Protocols, CSS Styles, and HTML Tags and Attributes,” describes how to allow users to use specific protocols, CSS styles, and HTML tags and attributes.  Chapter 5, “Allowing Specific File Types for Quick Look,” shows you how to enable Quick Look for additional file types.  Chapter 6, “Managing Wiki Content,” describes how to migrate, back up, and edit raw wiki content. Note: 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. 8 Preface About This Guide Using Onscreen Help You can get user help while using the wiki tools on your computer or iPhone, or administration task instructions in the Help Viewer application while you're managing Snow Leopard Server. You can view administration help on a server or an administrator computer. (An administrator computer is a Mac OS X computer with Mac OS X Server administration software installed on it.) To get user help while using wiki tools on your computer: m Click the “help” link. To get user help while using wiki tools on iPhone: m Click the “help” link. This link is located at the bottom of the page. To get administration help: m Open Server Admin and then:  Use the Help menu to search for a task you want to perform.  Choose Help > Server Admin Help to browse and search help topics. The onscreen help contains instructions taken from Advanced Server Administration and other administration guides. To see the most recent server help topics: m Make sure the server or administrator computer is connected to the Internet while you’re getting help. Help Viewer retrieves and caches the most recent server help topics from the Internet. When not connected to the Internet, Help Viewer displays cached help topics. Preface About This Guide 9 Documentation Map Mac OS X Server has a suite of guides that cover management of individual services. Each service may depend on other services for maximum utility. The documentation map below shows some related guides you may need to fully configure Wiki Server to your specifications. You can get these guides in PDF format from the Mac OS X Server resources website: www.apple.com/server/macosx/resources/ Getting Started Explains how to set up collaboration services using Server Preferences.