Apple Mac OS X Server Spezifikationen Seite 1

Mac OS X ServerWiki Server AdministrationVersion 10.6 Snow Leopard

10 Preface About This GuideDocumentation MapMac OS X Server has a suite of guides that cover management of individual services. Each service m

Preface About This Guide 11Viewing PDF Guides OnscreenWhile reading the PDF version of a guide onscreen:Show bookmarks to see the guide’s outlin

12 Preface About This GuideGetting Documentation UpdatesPeriodically, Apple posts revised help pages and new editions of guides. Some revised

13Learn about the tools provided by Wiki Server.Wiki Server provides several web-based wiki tools that allows users to express themselves or to ea

About BlogsA blog is like an online journal. Entries are arraned chronologically with the newest entries listed rst.The blog and the wiki share the s

15Learn how to use Server Admin to enable and congure websites with wiki tools.You use Server Admin to enable and congure websites with wiki too

The default settings are:Setting DefaultData Store /Library/CalendarServer/Documents/Maximum Attachment Size 1 MBUser Quota 100 MBAuthentication Any M

Chapter 2 Enabling and Conguring Wikis, Blogs, Web Calendars, and Mailing Lists 17 7 In the Calendar Server eld, enter the address of the iCa

Conguring Wiki Settings for All WebsitesWiki settings apply to all websites and thus all wikis hosted on a server. The default settings should work f

Chapter 2 Enabling and Conguring Wikis, Blogs, Web Calendars, and Mailing Lists 19Setting Default DescriptionWiki Creators Empty (anyone can cr

Apple Inc. K© 2009 Apple Inc. All rights reserved.The owner or authorized user of a valid copy of Mac OS X Server software may reproduce this publicat

To congure external servers for web calendar and mail rules: 1 Open Server Admin and connect to the web server. 2 Click the triangle at the left of

Chapter 2 Enabling and Conguring Wikis, Blogs, Web Calendars, and Mailing Lists 21To congure external servers for hosting wikis: 1 Copy wikis

In the example scenario, you’d enter the following lines:<Location /RPC2/science> ProxyPass /RPC2 http://science.example.com:8086/RPC2 retry=5&

Chapter 2 Enabling and Conguring Wikis, Blogs, Web Calendars, and Mailing Lists 23The list of services appears. 3 If Web is not listed, select

To restart web service in Server Admin: 1 In Server Admin, click the triangle at the left of the server name hosting the web service and select Web.

Chapter 2 Enabling and Conguring Wikis, Blogs, Web Calendars, and Mailing Lists 25Name URL DescriptionCalendar page /ical/ This page is a perso

Conguring Individual WikisA wiki administrator can change wiki settings. Wiki settings are grouped into several categories:Category SettingsGeneral Â

27Learn how to customize a wiki’s appearance.You can use a wiki’s admin settings to do the following:Change the wiki’s title, description, contact

/Library/Application Support/Apple/WikiServer/Themes/If the theme has a /compressed subfolder, it imports the CSS les located at:/usr/share/collabora

Chapter 3 Customizing How the Wiki Looks 29Variant Theme File Structure OverviewPrebuilt themes have several variants, which share the same layo

7 Preface: About This Guide7 What’s New in Wiki Server8 What's in This Guide9 Using Onscreen Help10 Documentation Map11 Viewing PDF Guide

Wireframe Theme File Structure OverviewThe wireframe theme is a good example theme to customize, because unlike other built-in themes, its CSS les ar

Chapter 3 Customizing How the Wiki Looks 31File or Folder Name Purposetheme.plist Aects general settings (such as the theme’s name), and sideba

File or Folder Name Purposescreen/toolbar.css Sets the editing toolbar’s color, background color, and margin.screen/weblog.css Sets blog display attri

Chapter 3 Customizing How the Wiki Looks 33You can use any command-line text editor, as long as you precede the command to run the text editor w

Website URLWorld Wide Web Consortium w3.orgCSS3 css3.infoQuirksMode quirksmode.orgPosition is Everything positioniseverything.netThe WebKit OpenSource

Chapter 3 Customizing How the Wiki Looks 35About Property List EditorProperty List Editor (shown below) is a specialized editor for property lis

To halve the height of the banner image in a text editor, change the following lines in theme.plist:<key>bannerImageHeight</key><real&g

Chapter 3 Customizing How the Wiki Looks 37Here is an example of an array with a single string:<array> <string>value</string&g

Changing General Theme SettingsThe wireframe theme’s theme.plist le includes keys and values for the following general settings:Key Default Value Pos

Chapter 3 Customizing How the Wiki Looks 39Key Default Value Possible Values Optional or Required DescriptionmobileHeaderColor #848c64 # followe

4 Contents30 Wireframe Theme File Structure Overview32 Creating a Theme33 Editing CSS Files34 Editing Property List Files35 About Property L

Understanding the Types of SidebarsThere are several types of sidebars, each with a specic purpose and set of keys:Sidebar Type Description Related S

Chapter 3 Customizing How the Wiki Looks 41Static Unique KeysStatic sidebars list predened URLs. “Useful Links” is an example static sidebar.St

Key Example Value Possible Values Optional or Required Descriptionuid serverhome, groups Any string Required Identier for the URL. This value must be

Chapter 3 Customizing How the Wiki Looks 43Key Example Value Possible Values Optional or RequiredDescriptionq annejohnson, wiki, 2008-03-17One o

Calendar Unique KeysCalendar sidebars list upcoming events. “Upcoming Events” is an example calendar sidebar.Calendar sidebars have the following uni

Chapter 3 Customizing How the Wiki Looks 45Overview of the Example SidebarsThe wireframe theme’s theme.plist le provides several example sideba

If you’re using a non–command-line tool, open the theme.plist le located in your Documents folder. 4 If there is a <!-- comment marker before <

Chapter 3 Customizing How the Wiki Looks 47Adding JavaScript and XSL FilesThe wiki server supports the use of custom JavaScript and Extensible S

About JavaScriptJavaScript is a lightweight, object-oriented, cross-platform scripting language.Wiki server pages include the prototype.js and script.

Chapter 3 Customizing How the Wiki Looks 49To use this example JavaScript code, save it as a .js le in this folder:/Library/Application Support

DraftVersion Contents 573 Wiki File Structure Overview74 Manually Editing Raw Content75 Viewing a Wiki’s Administration Settings78 Viewing a Page

DOCUMENT_SAVED ÂTAG_ADDED TAG_REMOVED ÂDID_ADD_TAG ÂQUICKLOOK_DID_RESIZE_PANEL ÂQUICKLOOK_DID_PAN_PREVIEW ÂQUICKLOOK_DID_DOWNLOAD_ATTACHMENT ÂDID_FINI

Chapter 3 Customizing How the Wiki Looks 51The rst argument (this.startedEditing above) is the callback function that is run when the message i

To view context: 1 Create a plain text le with the following content:<?xml version="1.0" encoding="UTF-8" ?><xsl:styles

Chapter 3 Customizing How the Wiki Looks 53To change text shown in the wikis list: 1 In Terminal, enter the following command:$ cd /Library/App

Changing the My Page ThemeYou can create your own theme for My Page or edit the provided example My Page theme.When you create a custom theme, your t

Chapter 3 Customizing How the Wiki Looks 55To edit a My Page theme in a non-command-line tool: 1 In Terminal, enter the following:$ cd /Library

Testing Wiki Code ChangesYou can test CSS, XSL, and JavaScript les by entering debug mode in the wiki and then using the Inspector in Safari or the F

57Learn how to enable specic protocols, CSS styles, and HTML tags and attributes.The default wiki server setup simplies administration by removi

The following sections describe this example whitelist.plist le in detail:<?xml version="1.0" encoding="UTF-8"?><!DOCTYP

Chapter 4 Allowing Specic Protocols, CSS Styles, and HTML Tags and Attributes 59<?xml version="1.0" encoding="UTF-8"?>

6

<key>styles</key><array> <string>font-size</string></array>To allow the HTML “style” attribute, add the “style”

Chapter 4 Allowing Specic Protocols, CSS Styles, and HTML Tags and Attributes 61 <array> <string>src</string>

Protocolsipssftpsmbsshsvnsvn+sshteltelnetvncwebcalxmppCSS Styles Allowed in the Built-in WhitelistThe built-in whitelist allows these CSS styles:Style

Chapter 4 Allowing Specic Protocols, CSS Styles, and HTML Tags and Attributes 63Tag Attributesdldtemh1h2h3h4h5h6htmliimg src, alt, name, width,

64Learn how to enable Quick Look for specic le types.Quick Look allows users to preview a le without downloading the le. To use Quick Look, cli

Chapter 5 Allowing Specic File Types for Quick Look 65File Extensiongifhtmlicnsicsjpegjpgkeymovmpegmpgmp3mp4m4am4v3gpnumberspagespdfpngpptpptxp

Adding Quick Look Support for File TypesTo support additional le types in Quick Look, install the application’s Quick Look generator and add the le

Chapter 5 Allowing Specic File Types for Quick Look 67 7 Save /etc/wikid/quicklook.conf. 8 Open /etc/wikid/qlgenerators.conf in a text editor

68Learn how to manage wiki content using tools and the command line.Using tools and the command line allows you to migrate, back up, and edit raw w

Chapter 6 Managing Wiki Content 69$ sudo ditto /Library/Collaboration/ /Volumes/volumename/foldername/If you created or edited themes, copy the

7This 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

5 Select “Erase destination” and click Restore.While Disk Utility is restoring volumes, don’t modify the new or old volumes. 6 Restart the server b

Chapter 6 Managing Wiki Content 71Moving Wiki Content from One Server to Another with a Dierent Hardware CongurationIf you’re moving the wiki

Passwords are removed when exporting and importing users. Tell users that they must change their passwords.To start the original server in target disk

Chapter 6 Managing Wiki Content 73Enter the following in Terminal: Â$ sudo serveradmin start teams;If prompted, enter your administrator account

File or Folder Name Descriptiongroup_name/ Creating a wiki creates a folder with the group’s short name.group_name/index.db This le changes when you

Chapter 6 Managing Wiki Content 75http://domain_name/groups/group_name/atompubFor more information about AtomPub, see:Website URLRFC 4287: The A

Key Example Value DescriptionGUID 28CC6BE9-11C1-456C-A3B2-8FCF5520A1DBUniquely identies the wiki.This value must correspond to the group record’s GU

Chapter 6 Managing Wiki Content 77Key Example Value DescriptionpodcastCategory Sports, Music Name of the podcast category.podcastEnabled <tru

If prompted, enter your administrator account password.You can use any text editor, as long as you precede the command to run the text editor with sud

Chapter 6 Managing Wiki Content 79Key Example Value Descriptionauthor annejohnson Short user name of the original author.commentUID groups/group

8 Preface About This GuideQuick Look support. Â Users can use Quick Look to preview attached les without downloading the les. By default, u

If someone deletes or replaces an attachment in the wiki, the old attachment remains on the server. This allows use of the wiki’s history feature to r

Chapter 6 Managing Wiki Content 81Key Default Value DescriptionmailServer host.example.com URL of the mail server that the wiki server manages.h

Key Default Value DescriptionserverRPCRedirect /RPC2 Enter the hostname for RPC communication. This allows you to hide multiple wiki servers behind on

Chapter 6 Managing Wiki Content 83Choosing Who Can Administer Wiki ServerYou can choose who can administer Wiki Server in Server Admin or by edi

Aadministrator setup 83AppleWikiImporter 68arrays, property list 36Atom Publishing Protocol (AtomPub) 74attachments, wiki page 79attributes, allo

Index 85PProperty List Editor 35property list (plist) les 34, 35, 36, 37protocolsAtomPub 74whitelisted 59, 61QQuick Look 64, 66Rrecent activi

86 IndexSee also themes, whitelistswikid.conf le 80wireframe theme 30XXML (eXtensible Markup Language) 51XSL (Extensible Stylesheet Language)

Preface About This Guide 9Using Onscreen HelpYou can get user help while using the wiki tools on your computer or iPhone, or administration task