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 congure websites with wiki tools.You use Server Admin to enable and congure 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 Conguring Wikis, Blogs, Web Calendars, and Mailing Lists 17 7 In the Calendar Server eld, enter the address of the iCa
Conguring 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 Conguring 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 congure 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 Conguring Wikis, Blogs, Web Calendars, and Mailing Lists 21To congure 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 Conguring 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 Conguring Wikis, Blogs, Web Calendars, and Mailing Lists 25Name URL DescriptionCalendar page /ical/ This page is a perso
Conguring 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 Aects 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 specic purpose and set of keys:Sidebar Type Description Related S
Chapter 3 Customizing How the Wiki Looks 41Static Unique KeysStatic sidebars list predened URLs. “Useful Links” is an example static sidebar.St
Key Example Value Possible Values Optional or Required Descriptionuid serverhome, groups Any string Required Identier 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 specic protocols, CSS styles, and HTML tags and attributes.The default wiki server setup simplies 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 Specic Protocols, CSS Styles, and HTML Tags and Attributes 59<?xml version="1.0" encoding="UTF-8"?>
<key>styles</key><array> <string>font-size</string></array>To allow the HTML “style” attribute, add the “style”
Chapter 4 Allowing Specic 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 Specic Protocols, CSS Styles, and HTML Tags and Attributes 63Tag Attributesdldtemh1h2h3h4h5h6htmliimg src, alt, name, width,
64Learn how to enable Quick Look for specic le types.Quick Look allows users to preview a le without downloading the le. To use Quick Look, cli
Chapter 5 Allowing Specic 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 Specic 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 Dierent Hardware CongurationIf 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 identies 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
Comentários a estes Manuais