


© 2008 Apple Inc. Alle Rechte vorbehalten. K K
Der Eigentümer oder autorisierte Benutzer einer gültigen Kopie der Mac OS X Server-Software kann diese Publikation zum Zwecke des Erlernens der Verwendung dieser Software reproduzieren. Kein Teil dieser Publikation darf für kommerzielle Zwecke, wie den Verkauf von Kopien dieser Veröffentlichung oder die Erbringung kostenpflichtiger Supportdienste, reproduziert oder übertragen werden.
Es wurde alles unternommen, um sicherzustellen, dass die Informationen in diesem Handbuch korrekt sind. Apple Inc. ist nicht verantwortlich für Druck- oder Schreibfehler.
Da Apple regelmäßig neue Versionen und Updates für seine Software veröffentlicht, können die in diesem Buch gezeigten Bilder anders sein als das, was Sie auf Ihrem Bildschirm sehen.
Apple 1 Infinite Loop Cupertino, CA 95014-2084 408-996-1010 www.apple.com
Das Apple-Logo ist eine Marke von Apple Inc., die in den USA registriert ist und andere Länder. Die Verwendung des Apple-Logos „Tastatur (Option-Shift-K) für kommerzielle Zwecke ohne vorherige schriftliche Zustimmung von Apple kann eine Markenverletzung und einen unlauteren Wettbewerb unter Verletzung der Bundesgesetze darstellen.
Apple, das Apple-Logo, iCal, iTunes, Leopard, Mac, Mac OS und Macintosh sind Marken von Apple Inc., die in den USA registriert sind und andere Länder. Finder, Safari und Time Machine sind Marken von Apple Inc.
UNIX ist eine eingetragene Marke von The Open Group.
Andere hierin genannte Firmen- und Produktnamen sind Marken ihrer jeweiligen Unternehmen. Die Erwähnung von Produkten Dritter dient nur zu Informationszwecken und stellt weder eine Empfehlung noch eine Empfehlung dar. Apple übernimmt keine Verantwortung für die Leistung oder Nutzung dieser Produkte.
019-1252/2008-04-24


In diesem Handbuch wird erläutert, wie Sie benutzerdefinierte Themes erstellen, bestimmte Protokolle, CSS-Stile und HTML-Tags und -Attribute zulassen und Wiki-Inhalte verwalten.
Die standardmäßige Wiki Server-Konfiguration erleichtert es Gruppen, zusammenzuarbeiten und zu kommunizieren. Benutzer können Wiki-Seiten erstellen und bearbeiten, Material markieren und verweisen, Dateien und Bilder hochladen, Kommentare hinzufügen und Inhalte suchen.
Dieser Leitfaden zeigt Ihnen, wie Sie das Wiki an Ihre Bedürfnisse anpassen und erweitern können. Zum Beispiel werden Sie lernen, wie man:
JavaScript, YouTube und Flash aktivieren
Automatisieren Sie die Migration aus anderen Quellen, wie Wikis und Nicht-Wiki-Websites
Die in diesem Handbuch beschriebenen Aufgaben können für Standard-, Arbeitsgruppen- und erweiterte Konfigurationen von Leopard Server verwendet werden. Diese Aufgaben erfordern Administratorzugriff und in einigen Fällen Programmierkenntnisse. Sie müssen in der Lage sein, Dateien auf dem Server zu bearbeiten, die für die meisten Benutzer nicht zugänglich sind. Seien Sie vorsichtig beim Bearbeiten dieser Dateien, da eine falsche oder ungetestete Änderung Probleme verursachen kann.
Weitere Informationen zum Einrichten, Verwalten und Verwenden von Wiki Server werden an mehreren Stellen ausführlich behandelt.
Erste Schritte – wenn Sie Server-Präferenzen verwenden
Web Technologies Administration – wenn Sie Server Admin verwenden
Sie können beide Anleitungen auf der Mac OS X Server Resources Website finden: www.apple.com/server/macosx/resources

Informationen zur Verwaltung von Wikis finden Sie unter Verzeichnishilfe. Sie können die Verzeichnishilfe anzeigen, indem Sie das Verzeichnis (in /Anwendungen/ Dienstprogramme) öffnen und Hilfe > Verzeichnishilfe auswählen.
Informationen zur Verwendung des Wikis finden Sie unter Hilfe von Wiki. Sie können die Wiki-Hilfe anzeigen, indem Sie auf den Hilfelink unten in einer beliebigen Apple-Wikiseite klicken.
6 Vorwort Über diesen Guide

Dieses Kapitel beschreibt, wie man das Erscheinungsbild eines Wikis anpasst.
Ändern Sie den Titel des Wikis
Ändern Sie das Thema des Wikis
Fügen Sie eine benutzerdefinierte Tag-Suchleiste zur Hauptseite hinzu Â
Wählen Sie, wer Kommentare abgeben kann und welche Kommentare moderiert werden
Erstellen Sie einen Podcast und integrieren Sie ihn mit iTunes
Diese Einstellungen sind für die meisten Wikis ausreichend. Wenn Sie jedoch besondere Anforderungen haben, z. B. den Stil einer bestimmten Organisation verwenden oder das Aussehen und die Namen der Standardseitenleisten auf der Startseite ändern möchten, müssen Sie Dateien bearbeiten, die sich auf dem Server befinden.
Theme File Structure Overview Ein Thema besteht aus Cascading Style Sheet (.css) Dateien, Property List (.plist) Dateien und Bilddateien (normalerweise .png und .jpg), manchmal JavaScript (.js) und Extensible Stylesheet Language (.xsl).
7

CSS-Dateien, die sich in einzelnen Themeordnern befinden, haben jedoch Vorrang und überschreiben die Einstellungen in diesem Ordner.
Einzelne Theme-Ordner sind Unterordner mit einer .wikitheme Erweiterung, die sich in diesem Ordner befinden:

screen.css

screen compressed.css
Wenn das Theme einen /compressed-Unterordner hat, werden die CSS-Dateien importiert unter: /usr/share/collaboration/themes/theme name/screen compressed.css
Die screen compressed.css-Datei kombiniert die vielen einzelnen CSS Dateien, die sich in der theme name/screen/ Ordner. Diese werden in den vorgefertigten Themen zur Verfügung gestellt, um die Gesamtleistung zu verbessern. Die screen compressed.css-Datei wird nicht automatisch oder dynamisch erstellt, sodass Änderungen an .cSSS-Dateien in der theme name/screen/ Ordner hat keinen Einfluss auf die screen compressed.css-Datei.
/Bibliothek/Application Support/Apple/WikiServer/Themes/ · Importe

Variant Theme File Structure Übersicht Vorgefertigte Designs haben mehrere Varianten, die alle das gleiche Layout teilen, aber möglicherweise unterschiedliche Banner oder Farbschemata aufweisen. Gemeinsame CSS-Dateien befinden sich im Ordner des Hauptthemas, während Varianten separate CSS- Dateien in anderen Ordnern haben.


/usr/share/collaboration/themes/block/screen/
Varianten des Blockthemas verwenden alle diese freigegebenen CSS-Dateien. Jede Variante verwendet auch CSS-Dateien, die sich in einem anderen Ordner befinden:
/usr/share/collaboration/themes/block.red/screen/
/usr/share/collaboration/themes/block.red.banner/screen/
Diese CSS-Dateien dienen alle nur als Beispiele, da die vorgefertigten Themes anstelle dieser einzelnen Dateien die screen compress.css Datei verwenden.

Wireframe Theme File Structure Übersicht Das Wireframe-Theme ist ein gutes Beispieldesign, das angepasst werden kann, da sich seine CSS-Dateien im Gegensatz zu den anderen integrierten Themes alle in seinem Hauptthemaordner befinden (am Standort / Library und nicht am Standort /usr). Es wurde als Bare-Bones-Thema entworfen, das Sie leicht hinzufügen können, ohne unerwünschte Elemente entfernen zu müssen.

/Bibliothek/Application Support/Apple/WikiServer/Themes/wireframe.wikitheme/
banner.jpg
Kommentar.png
rss.png
Zweck des Datei- oder Ordnernamens
preview.png Wird angezeigt, wenn Benutzer auswählen, welches Theme verwendet werden soll. Seine Abmessungen sind 128 x 128 Pixel.
print.css Wird angewendet, wenn Wiki-Seiten gedruckt werden Wenn Sie die Importzeile nicht aus dieser Datei entfernen, wird zum Drucken die print.css-Datei verwendet unter:
/usr/share/collaboration/default/print.css
screen.css Wird angewendet, wenn Wiki-Seiten auf dem Bildschirm angezeigt werden. Diese Datei vereinfacht die Organisation und den Aufbau der Dateien, indem sie CSS-Dateien in /screen verwendet anstatt alle CSS-Codes in einer einzigen Datei zu enthalten.
theme.plist Beeinflusst allgemeine Einstellungen wie den Namen des Themes und Sidebar-Attribute, z. B. die maximale Anzahl von Einträgen und Typen der angezeigten Sidebars.
screen/ Enthält alle CSS-Dateien, die beim Anzeigen des Wikis auf dem Bildschirm verwendet werden.

Zweck des Datei- oder Ordnernamens
screen/calendar.css Legt die Farben für den Webkalender fest.
screen/comments.css Legt verschiedene Erscheinungsbild-Attribute (wie Padding, Rahmen und Positionierung) für Kommentareingaben und -anzeige fest.
screen/footer.css Legt Footer-Attribute fest, wie z. B. Rand, Padding, Farbe und Schriftgröße.
screen/forms.css Legt den Rand für das Suchfeld fest.
screen/general.css Setzt allgemeine Blog- und Wiki-Anzeigeattribute, wie Schriftgröße und -farbe, Hintergrundfarben, Überschriftenränder und Listenstile.
screen/grouphome.css Sets zeigen Attribute für die Sidebar auf der Haupt-Wikiseite an, wie Größe, Ränder und Schriftgröße.
screen/header.css Sets zeigen Attribute (wie Schriftgröße, Rand und Padding) für das Wiki, den Blog, Kalender und die Mail-Links oben auf jeder Seite an.
screen/layout.css Sets zeigen Attribute (wie Rand und Größe) für die Wiki- und Blogbearbeitungsoberfläche an.
Das Anpassen der Bearbeitungsoberfläche ist eine erweiterte Aufgabe; Je nachdem, was Sie versuchen zu tun, müssen Sie möglicherweise JavaScript schreiben.
screen/metadata.css Sets zeigen Attribute für Felder in Seitenhistorien an, wie z. B. den Rand und die Schriftgröße.
screen/tables.css Sets zeigen Attribute für Tabellen und Tischüberschriften an, wie z. B. Farbe, Rahmenstile und Schriftgröße.
screen/tags.css Sets zeigen Attribute für die Tagliste an, wie sie auf jeder Seite angezeigt werden, z. B. Ränder, Padding und Trennzeichen.
screen/thumbnail.css Sets zeigen Attribute für Bild-Miniaturansichten an, wie die Rahmenstile, Farbe, Padding und die Vergrößerungsgrafik.
screen/toc.css deaktiviert Bearbeiten Sie nicht.
screen/toolbar.css Legt die Farbe, Hintergrundfarbe und den Rand der Bearbeitungs-Toolleiste fest.
screen/weblog.css Sets blog zeigt Attribute an, wie z.B. welche Elemente angezeigt werden.
screen/img/ Enthält Grafiken, die im Theme verwendet werden.
screen/img/banner.jpg Default Banner für das Theme Seine Abmessungen sind 950 x 140 Pixel.
screen/img/comment.png Oben rechts von jedem Kommentar angezeigt. Seine Abmessungen sind 16 x 15 Pixel.
screen/img/rss.png Oben rechts in den Seitenleisten Was ist heiß und Zuletzt Ändert auf der Hauptseite angezeigt. Seine Abmessungen sind 12 x 12 Pixel.

Der einfachste Weg, ein Thema zu erstellen ist das vorhandene Wireframe-Thema nehmen, eine Kopie davon mit intakten Berechtigungen machen und dann die Kopie anpassen.
Wenn Sie die enthaltenen Themes bearbeiten, anstatt sie in neue Themes zu kopieren, werden Ihre Edits möglicherweise später durch ein Software-Update überschrieben.
So erstellen Sie eine Kopie des Wireframe-Themes mit intakten Berechtigungen: 1 Geben Sie im Terminal die folgenden Befehle ein:
$ cd / Library/Application\ Support/Apple/WikiServer/Themes/
$ sudo ditto wireframe.wikitheme/ theme name.wikitheme/Ersetzen theme name mit dem Namen des Themas, das Sie erstellen. Wenn Sie dazu aufgefordert werden, geben Sie Ihr Administratorkonto-Passwort ein.
2 Wenn Sie den Property List Editor oder ein Nicht-Befehlszeilentool verwenden möchten, kopieren Sie die Datei theme.plist in Ihren Dokumentenordner.
$ cp theme name.wikitheme/theme.plist /Users/user name/Dokumente/Ersatz user name mit dem kurzen namen des benutzers, als den sie angemeldet sind. Informationen zum Property List Editor finden Sie unter „Über den Property List-Editor.
3 Öffnen Sie theme.plist im Property List Editor oder einem Texteditor.
$ Sudo Nano theme name.wikitheme/theme.plist Wenn Sie dazu aufgefordert werden, geben Sie Ihr Administratorkonto-Passwort ein. Sie können jeden Befehlszeilen-Texteditor verwenden, solange Sie dem Befehl vorausgehen, den Texteditor mit sudo auszuführen. Wenn Sie den Property List Editor oder ein Nicht-Befehlszeilentool verwenden, öffnen Sie das theme.plist in Ihrem Dokumentenordner.
4 Entfernen Sie den wählbaren Schlüssel und seinen Wert, und speichern Sie dann die Pist.
Um den Schlüssel mit dem Property List Editor zu entfernen, wählen Sie den auswählbaren Schlüssel und klicken dann auf Löschen. Um den Schlüssel mit einem Texteditor zu entfernen, entfernen Sie die folgenden Zeilen:
5 Wenn Sie theme.plist in Ihren Dokumentenordner kopiert haben, kopieren Sie ihn zurück in den Theme-Ordner.
$ cp / Benutzer/user name/Dokumente/theme.plist theme name.wikitheme/
wählbar ·

Starten Sie den Server neu. Â Â
Klicken Sie in Server-Präferenzen auf Web, verschieben Sie den Schieberegler nach Aus und dann zu Ein. Â
Öffnen Sie im Server-Admin das Offenlegungsdreieck für Ihren Server, wählen Sie Web aus und klicken auf Stopp ÂÂ
Web, und dann klicken Sie auf Starten des Internets.
$ sudo serveradmin stop teams; sudo serversadmin start teams; geben sie bei wunsch ihr administratorkonto-passwort ein. Das Neustarten des Servers und das Neustartieren des Webdienstes können Benutzer stören, so senden Sie eine Benachrichtigung aus, dass der Server vorübergehend heruntergefahren wird, bevor Sie dies tun.
Das Bearbeiten von CSS-Dateien Cascading Style Sheet (.css) Dateien steuert, wie das Wiki aussieht. Durch die Bearbeitung dieser CSS-Dateien können Sie ganz einfach Anzeigeattribute für bestimmte Seitenelemente ändern. Sie können beispielsweise ändern:
Hintergrundfarbe
Marge
Padding Â
Schriftgröße Â
Wenn Sie CSS-Dateien bearbeiten können, können Sie das Aussehen des Wikis komplett überarbeiten, indem Sie sein Layout ändern, unerwünschte visuelle Elemente entfernen und Ihre eigenen visuellen Elemente hinzufügen.
Wenn Sie eine CSS-Datei bearbeiten, treten Ihre Änderungen sofort auf; Sie müssen den Server oder Webdienst nicht nach der Bearbeitung neu starten. Da Sie Benutzer möglicherweise stören, indem Sie CSS-Dateien ändern, sollten Sie sie mit einem Design erstellen, bearbeiten und testen, das derzeit nicht verwendet wird.
Es gibt viele Online-Informationsquellen über Cascading Style Sheets. Diese Websites sollten Ihnen helfen, zu beginnen:
World Wide Web Konsortium w3.org
CSS3 css3.info
QuirksMode quirksmode.org
Position ist alles positioniseverything.net
Das WebKit OpenSource Projekt webkit.org
Eine Liste auseinander alistapart.com
CSS Zen Garten csszengarden.com
Website URL

ÂÂ CSS: The Definitive Guide, 3. Ausgabe von Eric Meyer. O’Reilly Media, Inc. 2006.
Cameron Moll. Freunde von ED. 2006.
Ob das Thema öffentlich verfügbar ist
Höhe und Breite des Banners
Sidebar-Eigenschaften wie Name, Art und Anzahl der Links sowie Sortierreihenfolge
Nachdem Sie Änderungen an der Datei theme.plist vorgenommen haben, müssen Sie den Webdienst neu starten oder den Server neu starten. Da dies Benutzer stören kann, sollten Sie Themes auf einem Testcomputer erstellen, bearbeiten und testen und diese dann auf den Server kopieren.
Über Property List Editor Property List Editor ist ein spezialisierter Redakteur für Immobilienlistendateien.

Um eine theme.plist-Datei mit dem Property List Editor zu bearbeiten, müssen Sie sie in Ihren Dokumentenordner kopieren. Wenn Sie die Datei theme.plist fertig bearbeitet haben, müssen Sie sie zurück in /Library/Application Support/Apple/WikiServer/Themes/ kopierentheme name.wikitheme/
Der Property List Editor befindet sich auf der Mac OS X Server v10.5 Administration Tools CD, in /Utilities/. Sie können es von der CD ausführen oder an einen anderen Ort kopieren.

Der Property List Editor zeigt keine Kommentare an, wenn Sie also die Beispielseitenleisten sehen möchten, die in theme.plist des Wireframes bereitgestellt werden, müssen Sie die Datei theme.plisten in einem Texteditor öffnen und die Kommentarmarkierungen entfernen, die die Beispielseiteleisten umgeben.
Über Property List Files Die Datei theme.plist ist wie eine XML-Datei aufgebaut. Wenn Sie XML verstehen, ist das Bearbeiten von theme.plist einfach. Wenn nicht, lesen Sie die folgenden Abschnitte für grundlegende Bearbeitungsinformationen.
Über Property List Keys und Werte Jede Einstellung, die von der Datei theme.plist gesteuert wird, hat einen Schlüssel und einen zugehörigen Wert oder ein Array (eine Sammlung) mit zugeordneten Werten. Um die Einstellung zu ändern, ändern Sie den Wert oder die Werte und nicht den Schlüssel.
Um beispielsweise die Höhe des Bannerbildes im Property List Editor zu halbieren, doppelklicken Sie auf den Wert 99 neben bannerImageHeight und ersetzen Sie ihn durch 50.
Um die Höhe des Bannerbildes in einem Texteditor zu halbieren, ändern Sie im theme.plist folgende Zeilen:
Über Strings Die meisten Werte in der Datei theme.plist sind Zeichenfolgen, die Strings.
Über Dictionaries A Wörterbuch, oder Dict wenn in einem Texteditor angezeigt, ist eine Auswahl von Werten verschiedener Klassen. In der Datei theme.plist wird eine Seitenleiste durch ein Wörterbuch dargestellt.
Da ein Wörterbuch mehrere Werte enthalten kann, bietet der Property List Editor ein Offenlegungsdreieck, mit dem Sie den Inhalt des Wörterbuchs anzeigen oder ausblenden können.
Über Arrays Arrays sind Sammlungen oder Listen ähnlicher Klassen. Die Datei theme.plist enthält zwei Array-Typen: eine Liste von Wörterbüchern und eine Liste der Strings.
Das Sidebars-Array ist ein Beispiel für ein Wörterbuch-Arrangement. Da das Sidebars-Array standardmäßig kommentiert wird, können Sie es nicht im Property List Editor sehen, ohne zuerst die Kommentarmarkierungen in einem Texteditor zu entfernen.
Da ein Array mehrere Werte enthalten kann, bietet der Property List Editor ein Offenlegungsdreieck an, mit dem Sie den Inhalt des Arrays anzeigen oder ausblenden können.

Sidebar-Tasten und Werte
Sidebar-Tasten und Werte
Hier ist ein Beispiel für ein Array mit mehreren Strings:
Wert 2
Über Kommentare Die Datei theme.plist enthält Kommentare, die Ihnen helfen sollen, Anweisungen zum Bearbeiten und Beispielschlüssel sowie Werte bereitzustellen. Kommentare werden ignoriert, wenn die Datei theme.plist vom Wiki-Server gelesen wird.
Die Kommentare beginnen mit „Alles dazwischen wird ignoriert, auch wenn der Kommentar viele Zeilen von Schlüsseln und Werten enthält.
Beispielsweise enthält die theme.plist-Datei des Wireframe-Themes den folgenden Kommentar, um anzugeben, wo der Abschnitt "Beispielseitenleisten" beginnt:
Dem Sidebars-Array wird ein
Über Fehler Stellen Sie sicher, dass alle erforderlichen Werte vorhanden sind. Wenn Sie die erforderlichen Schlüssel und Werte nicht in der Datei theme.plist einfügen (z. B. einen displayName oder eine Uid für eine Seitenleiste), wird auf der Hauptseite des Wikis eine Seite mit dem „Internal Server Error angezeigt. Wiki-Seiten, die keine Sidebars haben, zeigen diesen Fehler nicht an.

Ändern der allgemeinen Themeneinstellungen Der theme.plist des Wireframe-Themes enthält Schlüssel und Werte für die folgenden allgemeinen Einstellungen:
Key Default Value Mögliche Werte Optionale oder erforderliche Beschreibung
bannerImageHeight 99 Jede Zahl, 0 oder mehr
Optional Der Betrag in Pixeln, der auf die Höhe des Bannerbildes verteilt ist. Bilder, die Sie hochladen, sind auf diese Größe skaliert.
Wenn Sie bannerImageHeight, aber nicht bannerImateWidth definieren, wird die Breite proportional skaliert.
Dieser Wert beeinflusst die Höhe des Bannerbildes, nicht die Höhe. Um die Höhe des Banners zu ändern, bearbeiten Sie die layout.css-Datei des Wireframe-Themes.
bannerImageWidth 950 Jede Zahl, 0 oder mehr
Optional Der Betrag in Pixeln, der der Breite des Bannerbildes zugewiesen ist. Bilder, die Sie hochladen, sind auf diese Größe skaliert.
Wenn Sie bannerImageWidth, aber nicht bannerImateHeight definieren, wird die Höhe proportional skaliert.
Dieser Wert beeinflusst die Breite des Bannerbildes, nicht die Breite. Um die Breite des Banners zu ändern, bearbeiten Sie die layout.css-Datei des Wireframe-Themes.
displayName Wireframe Theme Jede Zeichenfolge (z. B. ein Wort oder eine Phrase)
Erforderlich Der Name des Themas, wie in der Theme-Auswahl angezeigt, auf die aus den Administratoreinstellungen eines Wikis zugegriffen wird.
name com.apple.wireframe Jeder String ohne Leerzeichen
Required identifiziert das Thema eindeutig.
wählbar Optional Zeigt ein Thema im Theme-Auswähler an, wenn der auswählbare Schlüssel und Der Wert wird beide entfernt.
Version 1 Eine Zahl erforderlich Ändern Sie diesen Wert nicht.

Erstellen von Sidebars Wenn Sie noch keine Sidebar erstellt haben, ist es möglicherweise einfacher, eine Beispiel-Sidebar an Ihre Bedürfnisse anzupassen.
In der theme.plist-Datei des Wireframe-Themes gibt es einen Sidebars-Abschnitt, der eine Reihe von Sidebarn enthält, die Sie anpassen können:
Sidebar-Tasten und Werte
Sidebar-Tasten und Werte
Die Arten von Sidebars verstehen Es gibt verschiedene Arten von Sidebars, jede mit einem bestimmten Zweck und einer Reihe von Tasten:
Beschreibung des Seitenleistentyps
static Eine Liste von URLs. „Static Unique Keys, auf Seite 19
Eine Liste von Suchergebnissen mit tag-basierter oder textbasierter Suche.
„Search Unique Keys, auf Seite 20
Kalender Eine Liste der bevorstehenden Ereignisse. „Calendar Unique Keys, auf Seite 21
tag Eine Liste von Suchergebnissen mit Tag-basierter Suche.
„Tag Unique Keys, auf Seite 22
recentActivity Eine Liste von Seiten, die nach der letzten Betrachtungshäufigkeit sortiert sind. Basierend auf den letzten 100 Seitenaufrufen in einem Wiki zeigt diese Liste zuerst die meistgesehene Seite an, gefolgt von der nächsten am meisten angesehenen und so weiter.
“Recent Activity Unique Keys”, auf Seite 22
Eine Seitenleiste, die automatisch angezeigt wird, wenn sich jemand als Administrator anmeldet. Diese Sidebar ist nicht anpassbar.
Wichtige Beispielwerte Mögliche Werte Optionale oder erforderliche Beschreibung
displayName Was ist heiß, was neu, nützliche Links, kommende Ereignisse
Jeder String Erforderlicher Name der Sidebar.
Typsuche, statisch, Kalenderstatik, Suche, Kalender, Tag, recentActivity, admin
Erforderlicher Typ der verwendeten Sidebar.
uid HotList, RecentAddsList und UsefulLinks
Jeder String Required Identifier für die Sidebar. Dieser Wert muss eindeutig sein.

Statische einzigartige Schlüssel Statische Sidebars listen vordefinierte URLs auf. "Nützliche Links" ist eine Beispiel statische Sidebar.
Key Beispiel Wert Mögliche Werte Optionale oder erforderliche Beschreibung
URLs Nicht anwendbar Ein Array von Wörterbucheinträgen, die jeweils einen einzelnen Link darstellen
Da Links mehrere Werte enthalten, wie z. B. den Namen des Link und die URL selbst, wird jeder Link durch einen Wörterbucheintrag dargestellt.
headerURL http://example.com/ Gruppen/Gruppenname/search /?sort=modifiedDate&kind =wiki&kind=weblog&kind mailinglist&sortDirection =reverse&excludePages= wiki/welcome
Vollständig qualifizierte URL Optional Eine URL, die mit dem Header der Sidebar verknüpft ist.
feedURL feed://www.feedURLexample.com/ Gruppen/Gruppenname/ search/index.rss?sort=mod ifiedDate&kind=wiki&kind =weblog&kind mailinglist &sortDirection=reverse& excludePages=wik/ welcome
Vollständig qualifizierte URL Optional Ein RSS- oder Atomfeed, der mit der Seitenleiste verknüpft ist.
Key Beispiel Wert Mögliche Werte Optionale oder erforderliche Beschreibung
Art URL, Wiki, Weblog, Mailinglist, Kalender
Erforderlich Nicht in irgendwelchen Themen verwendet.
Verwenden Sie dies, um eine Klasse einer Sidebar zuzuweisen.
Sie können dann den Klassenselektor in CSS verwenden, um Sidebars anzupassen, z. B. indem Sie kleine Kalendersymbole neben Seitenleisten-Kalenderlinks oder kleine Safari-Symbole neben URL-Links hinzufügen.
Untertitel Die Homepage Ihres Servers, Liste der Gruppen mit Wikis auf diesem Server
Jeder String Required erscheint unter dem Namen des Links.
title Server Home, Gruppen Jeder String Erforderlicher Name des Links.
uid serverhome, groups Any string Required Identifier for the URL. Dieser Wert muss eindeutig sein.
url /, /groups/ Ein relativer oder absoluter Pfad zu einer Webseite
Erforderlicher Inhalt des Links.

Key Beispiel Wert Mögliche Werte Optionale oder erforderliche Beschreibung
Snippet Klicken Sie hier, um die Homepage Ihres Servers zu sehen.
Jede Zeichenfolge optional Wird für den Tool-Tipp des Links verwendet.
Um Tool-Tipps zu aktivieren, kommentieren Sie den folgenden Block im Gruppenhome des Themes. css-Datei: .grouphome .snippet{ display:none; }
Suche nach einzigartigen Schlüsseln Suchen Sidebars Liste der Suchergebnisse mit tag-basierte oder textbasierte Suche. "Was ist heiß" und "Was neu ist" sind Beispiele für Suchseitenleisten.
Key Beispiel Wert Mögliche Werte Optionale oder erforderliche Beschreibung
howMany 5 Jede Zahl, 1 oder mehr Erforderliche Maximale Anzahl von Einträgen in der Seitenleiste.
tag hot Ein oder mehrere Strings alle im selben Array
Optional Die Tags, die mit dieser Sidebar verbunden sind. Seiten, die alle diese Tags verwenden, werden dieser Sidebar hinzugefügt.
Art Wiki, Weblog, Mailinglist Eine oder mehrere der folgenden in demselben Array:
Optional Die Arten von Seiten, die mit dieser Sidebar verbunden sind. Eine Suche listet nur Seiten dieser Typen auf.
All-Wiki, Weblog und Mailinglist
Wenn dieser Schlüssel nicht vorhanden ist, können alle Arten von Seiten in der Sidebar angezeigt werden.
q annejohnson, wiki, 2008-03-17 Ein oder mehrere Strings alle im selben Array
Optional Die Textabfrage, die zur Suche nach Einträgen verwendet wurde.
Felder Titel, Inhalt, Autor Eine oder mehrere der folgenden in demselben Array:
Optional Die Felder, auf die die Textabfrage angewendet wird. Wenn die Abfrage mit einem dieser Felder übereinstimmt, erscheint der Eintrag in der Seitenleiste.
Autor des Titels LongName lastModifiedAuthor
LongName erstelltDate modifiziertDatum Inhalt strippedContent Art

Key Beispiel Wert Mögliche Werte Optionale oder erforderliche Beschreibung
sort modifiedDate, createdDate , title, author
Eine oder mehrere der folgenden Eigenschaften im selben Array:
Optionale Einträge werden basierend auf diesen Feldern sortiert.
Das erste aufgeführte Feld wird zuerst sortiert, dann werden die Einträge nach nachfolgenden Feldern umsortiert. Das zuletzt aufgeführte Feld hat Vorrang vor allen zuvor aufgeführten Feldern.
Autor des Titels LongName lastModifiedAuthor
LongName erstelltDate modifiziertDatum Inhalt strippedContent Art
sortDirection reverse forward oder reverse Optional Sortierreihenfolge der Einträge.
reverse – zuletzt geänderte Seite wird zuerst aufgeführt
forward—die am wenigsten kürzlich geänderte Seite wird zuerst aufgeführt
emptyListString Es gibt keine Matches. Alle Zeichenfolgen optional Wird angezeigt, wenn keine übereinstimmenden Suchergebnisse vorliegen.
Kalender Unique Keys Kalenderseitenleisten listen bevorstehende Ereignisse auf. "Nebenstehende Ereignisse" ist eine Beispiel-Kalenderseitenleiste.
Key Beispiel Wert Mögliche Werte Optionale oder erforderliche Beschreibung
howManyDays 5 Jede Zahl, 1 oder mehr Erforderliche Maximale Anzahl von Tagen bis zu einem Ereignis für sie in der Seitenleiste aufgeführt werden. Ereignisse, die nach dieser Anzahl von Tagen auftreten, werden in der Seitenleiste nicht angezeigt.
emptyListString Es gibt keine Matches. Jede Zeichenfolge Optional Wird angezeigt, wenn keine übereinstimmenden Kalenderereignisse vorliegen.

Unique Keys Tag Sidebars Liste Wiki, Blog und Mailinglisteneinträge, die ein bestimmtes Tag oder eine Reihe von Tags verwenden. Die zuletzt geänderten Einträge werden zuerst aufgeführt.
Key Beispiel Wert Mögliche Werte Optionale oder erforderliche Beschreibung
tag hot Ein einzelner String oder mehrere Strings alle im selben Array
Erforderliche Tags, die mit der Sidebar verbunden sind. Seiten, die alle diese Tags verwenden, werden in der Sidebar hinzugefügt.
howMany 5 Jede Zahl, 1 oder mehr Erforderliche Maximale Anzahl von Einträgen in der Seitenleiste.
emptyListString Es gibt keine Matches. Alle Zeichenfolgen optional Wird angezeigt, wenn keine übereinstimmenden Suchergebnisse vorliegen.
Aktuelle Aktivität Einzigartige Schlüssel Aktuelle Aktivitäten Seitenleisten Liste, die in letzter Zeit die meisten Leser hatten.
Key Beispiel Wert Mögliche Werte Optionale oder erforderliche Beschreibung
howMany 5 Jede Zahl, 1 oder mehr Erforderliche Maximale Anzahl von Einträgen in der Seitenleiste.
emptyListString Es gibt keine Matches. Alle Zeichenfolgen optional Wird angezeigt, wenn keine übereinstimmenden Suchergebnisse vorliegen.
Übersicht der Beispiel-Seitenleisten Die theme.plist des Wireframe-Themes bietet mehrere Beispielseitenleisten:
Was ist Hot Lists die fünf zuletzt geänderten Seiten, die mit "heiß" markiert sind.
Was ist neu Listen die fünf zuletzt erstellten Seiten. Dazu gehören Wiki, Weblog und Mailinglistenseiten.
Nützliche Links Listen mehrere vordefinierte Links auf.
Kommende Ereignisse Listen alle Veranstaltungen auf, die innerhalb der nächsten fünf Tage stattfinden.
Name der Seitenleiste

Mit dem Beispiel Sidebars Die theme.plist-Datei des Wireframe-Themes enthält mehrere Sidebar-Beispiele. Alle diese Beispiele werden standardmäßig kommentiert. Sie müssen die Kommentarmarken entfernen, wenn Sie die Beispielseitenleisten als benutzerdefinierte Seitenleisten verwenden möchten. Wenn Sie keine benutzerdefinierten Sidebars hinzufügen, werden die Standard-Sidebars verwendet. Wenn Sie mindestens eine benutzerdefinierte Seitenleiste verwenden, werden die Standardseitenleisten nicht angezeigt.
Erwägen Sie, alle Sidebars zu kommentieren, die Sie nicht verwenden möchten, und lassen Sie alle Sidebaren, die du verwenden möchtest, unkommentiert. Auf diese Weise können Sie auswählen, welche Sidebars Sie möchten und die Einstellungen der Sidebar später leicht ändern. Um dies zu tun, müssen Sie einen Kommentar beginnen vor dem Tag für eine Sidebar und beenden Sie den Kommentar nach dem Tag für diese Sidebar.
$ cd / Library/Application\ Support/Apple/WikiServer/Themes/ 2 Wenn Sie ein Nicht-Befehlszeilenwerkzeug verwenden möchten, kopieren Sie die Datei theme.plist in Ihren Dokumentenordner.
$ cp theme name.wikitheme/theme.plist /Users/user name/Dokumente/Ersatz theme name mit dem Namen des Themas. Ersetzen user name mit dem kurzen namen des benutzers, als den sie angemeldet sind.
3 Öffnen Sie theme.plist in einem Texteditor.
$ Sudo Nano theme name.wikitheme/theme.plist Wenn Sie dazu aufgefordert werden, geben Sie Ihr Administratorkonto-Passwort ein. Sie können jeden Befehlszeilen-Texteditor verwenden, solange Sie dem Befehl vorausgehen, den Texteditor mit sudo auszuführen. Wenn Sie ein Nicht-Befehlszeilentool verwenden, öffnen Sie das theme.plist in Ihrem Dokumentenordner.
4 Wenn es eine Kommentarmarker vor Version.

5 Für jede Seitenleiste, die Sie kommentieren möchten, führen Sie Folgendes aus:
a Additiv
bei Seitenleisten, Tags werden von dem displayName-Schlüssel gefolgt. Um zum Beispiel die "Was ist heiß" -Seitenleiste zu kommentieren, würden Sie das ändern:
Was ist heiß b Add --> nach dem Tag der Sidebar, die Sie kommentieren möchten.
Die entsprechenden Tag ist das erste, das auf der gleichen Einrückungsebene des Sidebar gefunden wird Markierung. Um zum Beispiel die "Was ist heiß" Seitenleiste zu kommentieren, würden Sie nach der ersten suchen Tag auf der gleichen Einrückungsebene wie das What’s Hot Tag-Level, und dann würden Sie dies ändern:
--> 6 Wenn Sie theme.plist in Ihren Dokumentenordner kopiert haben, kopieren Sie ihn zurück in den Theme-Ordner.
$ cp / Benutzer/user name/Dokumente/theme.plist theme name.wikitheme/ 7 Starten Sie den Webdienst neu, indem Sie eine der folgenden Maßnahmen ausführen:
Klicken Sie in Server-Präferenzen auf Web, verschieben Sie den Schieberegler nach Aus und dann zu Ein. Â
Öffnen Sie im Server-Admin das Offenlegungsdreieck für Ihren Server, wählen Sie Web aus und klicken auf Stopp ÂÂ
Web, und dann klicken Sie auf Starten des Internets.
$ sudo serveradmin stop teams; sudo serversadmin start teams; geben sie bei wunsch ihr administratorkonto-passwort ein. Das Neustarten des Servers und das Stoppen und Starten des Webdienstes können Benutzer stören, so senden Sie eine Benachrichtigung aus, dass der Server vorübergehend heruntergefahren wird, bevor Sie dies tun.

Hinzufügen von JavaScript- und XSL-Dateien Der Wikiserver unterstützt die Verwendung benutzerdefinierter Javascript- und Extensible Stylesheet Language (XSL) Dateien. JavaScript und XSL ändern den angezeigten Inhalt, während CSS die Darstellung des Inhalts steuert. Zum Beispiel könnten Sie JavaScript oder XSL verwenden, um einen "digg it" -Link zu Ihren Blogeinträgen hinzuzufügen, der dann die Blogeintrage mit digg.com.
Wählen Sie sorgfältig aus, ob Sie JavaScript, XSL oder beides verwenden möchten.
Im Gegensatz zu benutzerdefinierten XSL-Dateien funktionieren JavaScript-Dateie nach dem Ausführen einer Software weiterhin.
Aktualisierung. Der Wiki-Server enthält XSL Dateien, die während eines Software Updates geändert werden können. Wenn sich diese Dateien ändern, tritt ein Fehler auf, da die Dateiversionen der enthaltenen Dateien nicht mehr mit den Dateiversionn benutzerdefinierter XSL-Dateien übereinstimmen.
JavaScript kann Ihnen mehr Kontrolle über ein Dokument als XSL ermöglichen, wenn Sie Zugriff haben
Informationen auf dem Server, die nicht im XSL-Kontext bereitgestellt werden.
XSL-Transformationen werden auf dem Wikiserver durchgeführt, so dass der Browser des Benutzers nicht
Erforderlich, um es zu unterstützen und auszuführen.
So fügen Sie JavaScript-Dateien oder XSL-Datei zu einem Thema hinzu: 1 Setzen Sie JavaScript (.js) Dateien oder XSL (.xsl) Dateien in diesem Ordner:
/Bibliothek/Application Support/Apple/WikiServer/Themes/theme name/ Ersetzen theme name mit dem Namen des Themas.

Starten Sie den Server neu. Â Â
Klicken Sie in Server-Präferenzen auf Web, verschieben Sie den Schieberegler nach Aus und dann zu Ein. Â
Öffnen Sie im Server-Admin das Offenlegungsdreieck für Ihren Server, wählen Sie Web aus und klicken auf Stopp ÂÂ
Web, und dann klicken Sie auf Starten des Internets.
$ sudo serveradmin stop teams; sudo serversadmin start teams; geben sie bei wunsch ihr administratorkonto-passwort ein. Das Neustarten des Servers und das Neustartieren des Webdienstes können Benutzer stören, so senden Sie eine Benachrichtigung aus, dass der Server vorübergehend heruntergefahren wird, bevor Sie dies tun.
Über JavaScript JavaScript ist eine leichte, objektorientierte und plattformübergreifende Skriptsprache.
Alle Wiki-Serverseiten enthalten automatisch die Frameworks prototype.js und script. aculo.us, die den Einsatz von JavaScript verbessern und rationalisieren.
JavaScript-Entwickler.mozilla.org/de/docs/JavaScript
quirksmode.org/js/contents.html
crockford.com/javascript/javascpt.html
Prototyp.js prototypejs.org/api
Drehbuch.aculo.us wiki.scriptaculo.us
ÂÂ JavaScript: The Definitive Guide, 5. Ausgabe von David Flanagan. O’Reilly Media, Inc.
ÂÂ Beginnendes JavaScript mit DOM Scripting und Ajax: Vom Anfänger zum Profi, durch
Christian Heilmann. Apresse. 2006.
Thema URL

JavaScript Beispiel Die folgende Beispiel-Javascript-Funktion fügt einen Headerlink neben der Lupe hinzu, die auf www.apple.com und ändert den Link „Andere Wikis, um auf www.apple.com
Event.observe(fenster, 'load', function() {\displaystyle}
// Fügen Sie einen anderen Header-Link hinzu (zu) apple.comdurch Manipulation des DOM
// mit Skript.aculo.us Bauherr
// wir werden es einfach vor dem Suchknopf einfügen
$('linkSearch').parentNode.insertBefore(Builder.node('li'),
{id:'linkApple'}, [
Builder.node('a', {href:}http://www.apple.com'} „Apfel
// Ändern Sie den Link Andere Wikis zu etwas anderem
$('groups users button').down('a')href = 'http://www.apple
Um diesen Beispiel-Javascriptcode zu verwenden, speichern Sie ihn als .js Datei in diesem Ordner: /Library/Application Support/Apple/WikiServer/Themes/theme name/
Über XSL XSL definiert XML-Dokumententransformation und -präsentation. Für Informationen über XSL, siehe:
Der Wiki-Server verwendet eine Reihe von XSL-Dateien unter: /usr/share/wikid/lib/apple templates/
Da ein Software-Update Dateien in /usr/share/wikid/lib/ apple templates/ überschreiben kann, bearbeiten Sie die Kopien dieser XSL-Dateien in:
XSL-Dateien an diesem Speicherort überschreiben XSL Dateien in /usr/share/wikid/lib/apple templates/.
Wenn ein Software-Update die Dateien in /usr/share/wikid/lib/apple templates/ überschreibt, müssen Sie den geänderten Inhalt Ihrer angepassten XSL-Dateien manuell mit den aktualisierten XSG-Datein zusammenführen. Wenn Sie den Inhalt nicht zusammenführen, stimmen die Versionen nicht überein und es tritt ein Fehler auf.

Wenn Sie eine Kopie der default.xsl-Datei bearbeiten, müssen Sie auch Kopien aller XSL-Dateien erstellen, die die ursprüngliche default.XSL-Datei enthalten, und diese dann ändern, um die bearbeitete default. xsl Datei aufzunehmen.
Anzeige von dynamischem XML Der Wiki-Server generiert dynamisch XML-Inhalte, die als Kontext. Der Kontext wird durch XSL-Dateien in HTML umgewandelt.
/usr/share/wikid/lib/apple templates/
Die XSL-Dateien entsprechen bestimmten Seiten im Wiki. Beispielsweise verwendet die Wiki-Homepage einer Gruppe grouphome.xsl, während eine typische Wikiseite content entry.xSL nutzt. Um den Kontext anzuzeigen, erstellen Sie eine XSL-Datei, die den Kontext anzeigt und legen Sie sie in Ihren Themeordner. Dies überschreibt die XSL-Dateien in /usr/share/wikid/lib/apple templates/ und ändert den Output für die Seiten, denen sie entsprechen.
xmlns:xsl=http://www.w3.org/1999/XSL/Transform>
version="1.0"
doctype-public="-//W3C//DTD HTML 4.01//EN"
doctype-system=http://www.w3.org/TR/html4/strict.dtd"/>
/Bibliothek/Application Support/Apple/WikiServer/Themes/theme nameVerwenden Sie den gleichen Dateinamen wie jede der XSL-Dateien in: /usr/share/wikid/lib/apple templates/ Wählen Sie einen Dateinamen basierend auf der Seite mit dem Kontext, den Sie anzeigen möchten. Um beispielsweise den Kontext für die Wiki-Homepage der Gruppe anzuzeigen, ändern Sie den Dateinamen in grouphome.xsl.
method="html" · encoding="UTF-8" · indent="yes"

Starten Sie den Server neu. Â Â
Klicken Sie in Server-Präferenzen auf Web, verschieben Sie den Schieberegler nach Aus und dann zu Ein. Â
Öffnen Sie im Server-Admin das Offenlegungsdreieck für Ihren Server, wählen Sie Web aus und klicken auf Stopp ÂÂ
Web, und dann klicken Sie auf Starten des Internets.
$ sudo serveradmin stop teams; sudo serversadmin start teams; geben sie bei wunsch ihr administratorkonto-passwort ein. Das Neustarten des Servers und das Neustartieren des Webdienstes können Benutzer stören, so dass eine Benachrichtigung gesendet wird, dass der Server vorübergehend ausfällt, bevor Sie dies tun.
4 Laden Sie in einem Webbrowser eine Seite, die die XSL-Datei verwendet und sehen dann die Quelle der Seite an.
Um die Quelle einer Seite in Safari anzuzeigen, laden Sie die Seite und wählen Ansicht > Quellenansicht.

In diesem Kapitel wird beschrieben, wie bestimmte Protokolle, CSS-Stile und HTML-Tags und -Attribute aktiviert werden können.
Die Standard-Wikiservereinrichtung vereinfacht die Verwaltung, indem sie potenziell schädliche Protokolle, CSS-Stile sowie HTML-Tags und -Attribute automatisch entfernt. Der Wiki-Server ist in der Lage, alle Protokolle, CSS-Stile und HTML-Tags und Attribute zuzulassen.
Der Wiki-Server verwendet zwei Whitelist-Dateien (eine eingebaute Whitelist und eine benutzerdefinierte Whitelist), um zulässige Protokolle, CSS-Stile sowie HTML-Tags und Attribute zu bestimmen. Elemente, die in einer dieser Whitelists erscheinen, sind erlaubt und alle anderen Elemente werden nicht zugelassen.
Die eingebaute Whitelist enthält gängige, meist harmlose Elemente. Es enthält keine potenziell schädlichen Tags wie Embed, Param, Object und Skript. Um Flash oder YouTube in Ihre Website einzubetten, müssen Sie einige dieser Tags einfügen. Wenn Sie eine benutzerdefinierte Whitelist erstellen, können Sie diese Elemente zusammen mit neuen Stilen (z. B. Schriftgröße) und Protokollen (wie z. B irc und scp) zulassen.
Diese Whitelists betreffen alle Wikis auf dem Server.

Erstellen einer benutzerdefinierten Whitelist Zum Erstellen einer eigenen Whitelist erstellen Sie eine Klartextdatei mit dem Namen whitelist.plist in: /Library/Application Support/Apple/WikiServer/
com/DTDs/PropertyList-1.0.dtd>
Kapitel 2 Ermöglichen spezifischer Protokolle, CSS-Stile und HTML-Tags und Attribute 31

Über die Struktur der Custom Whitelist Die folgenden Zeilen sind in der benutzerdefinierten Whitelist erforderlich:
com/DTDs/PropertyList-1.0.dtd>
erlaubte HTML-Tags und Attribute
Das Dict enthält mehrere Schlüssel-/Wertblöcke, die bestimmte Protokolle, Stile, Tags oder Attribute ermöglichen.
Ermöglichen spezifischer URL-Protokolle Um bestimmte URL-Protokolle zuzulassen, fügen Sie dem Protokollblock Zeichenfolgen mit den Namen der Protokolle hinzu.
Um beispielsweise die Eingabe von URLs zu ermöglichen, die mit „irc://“ und „scp://“ beginnen, erstellen Sie den folgenden Block:
Ermöglichen spezifischer CSS-Stile Um bestimmte CSS-Styleattribute zuzulassen, fügen Sie dem Stilblock Zeichenfolgen mit den Namen der Styleattribunale hinzu.
32 Kapitel 2 Ermöglichen spezifischer Protokolle, CSS-Stile und HTML-Tags und Attribute

Um beispielsweise die Verwendung des Schriftgrößen-Style-Attributs zu ermöglichen, erstellen Sie den folgenden Block:
Um das HTML-Attribut „style zuzulassen, fügen Sie dem Tag „ all das Attribut "style" hinzu, was im folgenden Abschnitt beschrieben wird.
Ermöglichen spezifischer HTML-Tags und Attribute YouTube, Flash und andere fortgeschrittene Webformate erfordern normalerweise HTML-Tags und -Attribute, die standardmäßig nicht erlaubt sind. YouTube benötigt beispielsweise folgende Tags und Attribute:
embed src, Typ, Breite, Höhe
Da diese HTML-Tags oder Attribute nicht in der integrierten Whitelist enthalten sind, müssen Sie sie zur benutzerdefinierten Whitelist hinzufügen.
So ermöglichen Sie bestimmte HTML-Tags und Attribute: 1 Erstellen Sie einen Tags-Schlüssel und folgen Sie ihm mit einem Diktat.
2 Erstellen Sie im Dict Schlüssel, die nach den HTML-Tags benannt sind.
Um ein bestimmtes Attribut für alle HTML-Tags zuzulassen, erstellen Sie einen Schlüssel mit dem Namen " all ".
3 Nach jedem Schlüssel erstellen Sie String-Arrays, die zulässige Tag-Attribute auflisten.
Kapitel 2 Ermöglichen spezifischer Protokolle, CSS-Stile und HTML-Tags und Attribute 33

Über die eingebaute Whitelist Sie können die integrierte Whitelist nicht ändern. Ein Software-Update kann jedoch die erlaubten Elemente in der eingebauten Whitelist ändern.
34 Kapitel 2 Ermöglichen spezifischer Protokolle, CSS-Stile und HTML-Tags und Attribute

CSS-Styles in der eingebauten Whitelist erlaubt Die eingebaute Whitelist ermöglicht diese CSS-Stile:
HTML-Tags und Attribute in der eingebauten Whitelist erlaubt Die eingebaute Whitelist ermöglicht diese HTML-Tags und Attribute:
a href, name, ref
img src, alt, name, wide, height, longdesc
Kapitel 2 Ermöglichen spezifischer Protokolle, CSS-Stile und HTML-Tags und Attribute 35

36 Kapitel 2 Ermöglichen spezifischer Protokolle, CSS-Stile und HTML-Tags und Attribute

Dieses Kapitel beschreibt, wie man Wiki-Inhalte mit Tools und der Kommandozeile verwaltet.
Mit Tools und der Befehlszeile können Sie migrieren, sichern und bearbeiten rohen Wiki-Inhalte.
Google WikiImporter ist ein Tool, das eine Website durchqueren kann, auf der alle anderen Seiten der Site aufgelistet sind und Wikiseiten basierend auf den Inhalten der Website erstellen. Wenn die Website Tags verwendet, kann AppleWikiImporter diese Tags importieren.
Um dieses Tool zu verwenden, benötigen Sie einige Kenntnisse über CSS-Selektoren und je nach importierter Website auch etwas Wissen über JavaScript.
Informationen zur Verwendung von AppleWikiImporter finden Sie in der Readme-Datei.
Sichern des Wiki-Servers Wenn Sie Mac OS X Server mit einer Standard- oder Arbeitsgruppenkonfiguration installiert haben, können Sie Time Machine verwenden, um den Wikiserver automatisch zu sichern. Wenn Sie Mac OS X Server mit einer erweiterten Konfiguration installiert haben und die Standard-Wiki- und Kalenderdatenspeicherorte nicht geändert haben, sichert Time Machine auch automatisch Ihren Wikiserver.
Wenn Sie Time Machine nicht verwenden, beschreiben die folgenden Informationen, wie Sie den Wiki-Server manuell sichern können.
Alle Wiki-Inhalte werden in einem Datenspeicher gespeichert. Der Standardspeicherort ist /Library/Collaboration/. Dieser Speicherort kann mit Server Admin (im Webdienst) geändert werden.

Um das Wiki manuell zu sichern, kopieren Sie den Wiki-Datenspeicher mit intakten Berechtigungen. Um beispielsweise den Wiki-Datenspeicher in einen Ordner auf einem anderen Volume zu kopieren, geben Sie im Terminal Folgendes ein und authentifizieren sich dann bei Anforderung als Administrator:
sudo ditto /Bibliothek/Zusammenarbeit/volumename/Ordnername/
Wenn Sie Themes erstellt oder bearbeitet haben, kopieren Sie den Theme-Ordner mit intakten Berechtigungen. Um den Themes-Ordner in einen Ordner auf einem anderen Volume zu kopieren, geben Sie im Terminal Folgendes ein und authentifizieren sich dann bei Anforderung als Administrator:
sudo ditto /Bibliothek/Anwendung\ Support/Apple/WikiServer/
volumename/Ordnername/
Wenn Sie den Webkalender verwenden, müssen Sie den Kalenderdatenspeicher sichern. Der Standardspeicherort ist /Library/CalendarServer/Documents/. Dieser Speicherort kann mit Server Admin (im iCal-Dienst) geändert werden.
Um den Kalender manuell zu sichern, kopieren Sie den Kalenderdatenspeicher mit intakten Berechtigungen. Um beispielsweise den Kalenderdatenspeicher in einen Ordner auf einem anderen Volume zu kopieren, geben Sie im Terminal Folgendes ein und authentifizieren sich dann bei Anforderung als Administrator:
sudo ditto /Bibliothek/CalendarServer/Dokumente/Völle/volumename/
38 Kapitel 3 Verwalten von Wiki-Inhalten
Ordnername/

Wiki File Structure Overview Standardmäßig speichert der Wikiserver Gruppenwikis in /Library/Collaboration/Groups/.
Die Abbildung unten zeigt Gruppen-Wiki-Dateien und Ordner.

Kapitel 3 Verwalten von Wiki-Inhalten 39
Anhang uid/ · Attachment filename · image filename

Der Ordner Gruppen im Wiki-Datenspeicher enthält die folgenden kritischen Wikidateien und -ordner:
Zweck des Datei- oder Ordnernamens
group name/ Durch die Aktivierung von Webdiensten für eine Gruppe wird ein Ordner mit dem Kurznamen der Gruppe erstellt.
group name/index.db Automatisch geändert, wenn Sie Wiki-Inhalte bearbeiten Wenn Sie Rohinhalte manuell bearbeiten, löschen Sie diese Datei so, dass sie basierend auf Rohinhalten regeneriert wird.
group name/metadata.plist Enthält die Einstellungen für Wiki-Verwaltung.
group name/wiki/ Speichert alle Seiten im Wiki.
Der Blog verwendet eine ähnliche Dateistruktur. Der Blog speichert alle seine Seiten in group name/Weblog/.
group name/wiki/page uid.page/ Automatisch erstellt, wenn Sie eine neue Wiki-Seite erstellen Der Name des Ordners ist eine eindeutige Kennung, die auch in der URL der Seite erscheint:
http://www.domain name/Gruppen/group name/wiki/ page uid/page name
group name/wiki/page uid.page/page.html Enthält den HTML-Inhalt der Seite.
group name/wiki/page uid.page/page.plist Enthält Meta-Informationen für eine Seite.
group name/wiki/page uid.page/attachments/ Speichert Unterordner für jeden Anhang.
group name/wiki/page uidSeite/Anlagen/ Anhang uid/
Automatisch erstellt, wenn eine Datei an eine Seite angefügt wird. Jeder Ordner speichert einen Anhang. Der Name des Ordners ist eine eindeutige Kennung, die auch in der URL des Anhangs erscheint:
http://www.domain name/Gruppen/Gruppenname/wiki/pageuid/ Anhänge/Anhang uid/Attachment filename
group name/wiki/page uidSeite/Anlagen/ Anhang uid/Attachment filename
Das ist ein Attachment.
group name/wiki/page uid.page/images/ Speichert alle Bilder für eine Seite.
group name/wiki/page uidSeite/Bilder/image filename
Das ist ein Bild.
Manuelle Bearbeitung von Rohinhalten Wenn Sie das Wiki zum Bearbeiten von Wiki-Seiten verwenden, indiziert der Wikiserver automatisch Ihre Inhalte. Wenn Sie Rohinhalte manuell bearbeiten, indexiert der Wiki-Server nicht automatisch. Sie müssen die Datei index.db löschen, damit sie basierend auf dem geänderten Rohinhalt regeneriert wird; andernfalls tritt ein Fehler auf.
Sie können dieses Problem vermeiden, indem Sie das Atom Publishing Protocol verwenden, auch bekannt als AtomPub. Sie können einen AtomPub-fähigen Client verwenden, um sich anzumelden, zu veröffentlichen, zu aktualisieren oder Wiki und Blogeinträge zu löschen. AtomPub-Clients so konfigurieren, dass sie diese Serviceadresse verwenden: http://domain name/Gruppen/group name/atompub
40 Kapitel 3 Verwalten von Wiki-Inhalten

Um den Index nach dem Bearbeiten von rohen Wiki-Inhalten zu regenerieren: 1 Löschen / Bibliothek/Zusammenarbeit/Gruppengroup name/index.db
sudo rm /Bibliothek/Zusammenarbeit/Gruppengroup name/index.db Ersetzen group name Kurzer Name der Gruppe.
Starten Sie den Server neu. Â Â
Klicken Sie in Server-Präferenzen auf Web, verschieben Sie den Schieberegler nach Aus und dann zu Ein. Â
Öffnen Sie im Server-Admin das Offenlegungsdreieck für Ihren Server, wählen Sie Web aus und klicken auf Stopp ÂÂ
Web, und dann klicken Sie auf Starten des Internets.
$ sudo serveradmin stop teams; sudo serversadmin start teams; geben sie bei wunsch ihr administratorkonto-passwort ein.
Das Neustarten des Servers und das Neustartieren des Webdienstes können Benutzer stören, so senden Sie eine Benachrichtigung aus, dass der Server vorübergehend heruntergefahren wird, bevor Sie dies tun.
Ersetzen group name Kurzer Name der Gruppe.
Informationen zum Anzeigen oder Bearbeiten von Eigenschaftslistendateien finden Sie unter „Editing Property List Files auf Seite 14.
Kapitel 3 Verwalten von Wiki-Inhalten 41
Website URL

Schlüsselbeispielwert Beschreibung
GUID 28CC6BE9-11C1-456C-A3B2-8FCF5520A1DB identifiziert das Wiki eindeutig.
Dieser Wert muss der GUID des Gruppeneintrags in der Verzeichnisdomäne entsprechen.
Um die GUID eines Gruppeneintrags anzuzeigen, verwenden Sie den Workgroup Manager. Für weitere Informationen, siehe Benutzerverwaltung bei www.apple.com/server/macosx/resources
LongName Wiki Name des Wikis. Standardmäßig wird dieser Name oben links auf jeder Wiki-Seite angezeigt.
allowKommentare , Setzen Sie auf true, wenn Kommentare erlaubt sind.
allowUnauthenticatedComments , Setzen Sie auf true, wenn Kommentare von irgendjemandem erlaubt sind. Setzen Sie auf false, wenn nur Kommentare von authentifizierten Benutzern erlaubt sind.
allowUnmoderatedKommentare , Setzen Sie auf true, wenn Kommentare von authentifizierten Benutzern unmoderiert sind.
allowUnmoderatedUnauthenticatedComments , Auf true setzen, wenn Kommentare von nicht authentifizierten Benutzern unmoderiert sind
bannerBild /Gruppen/group name/öffentlich/image filename Pfad zum Bannerbild.
indexVersion 2 Ändern Sie diesen Wert nicht.
Name group name Kurzname der Gruppe.
podcastKategorie Sport, Musik Name der Podcast-Kategorisierung.
podcastAktiviert , Setzen Sie auf true, wenn Podcasts aktiviert sind.
Sidebars Ein Array Enthält benutzerdefinierte Einstellungen für die Seitenleiste.
Weitere Informationen zum Einrichten von Sidebars finden Sie unter „Creating Sidebar, auf Seite 18.
themeName com.apple.block.green.banner Setzen Sie auf den eindeutigen Bezeichner des Themas.
Verwenden Sie die Admin-Einstellungen Seite, um diese Einstellungen zu ändern, anstatt manuell bearbeiten der Metadaten.plist Datei. Wenn Sie die Datei manuell bearbeiten, müssen Sie zuerst den Webdienst beenden oder Ihre geänderten Einstellungen werden automatisch überschrieben.
42 Kapitel 3 Verwalten von Wiki-Inhalten

So bearbeiten Sie die Einstellungen der Wiki-Administration manuell: 1 Beenden Sie den Webdienst, indem Sie eine der folgenden Maßnahmen ausführen:
Klicken Sie in Server-Präferenzen auf Web und verschieben Sie den Schieberegler nach Aus. Â
Öffnen Sie im Server-Administrator das Offenlegungsdreieck für Ihren Server, wählen Sie Web aus und klicken auf ÂÂ
Web stoppen.
$ sudo serveradmin stop teams; Geben Sie bei Aufforderung Ihr Administratorkonto-Passwort ein. Das Stoppen des Webdienstes kann Benutzer stören, also senden Sie eine Benachrichtigung aus, dass der Server vorübergehend heruntergefahren ist, bevor Sie dies tun.
2 Wenn Sie den Property List Editor oder ein Nicht-Befehlszeilentool verwenden möchten, kopieren Sie die Datei theme.plist in Ihren Dokumentenordner.
$ sudo cp / Bibliothek/Zusammenarbeit/Gruppengroup name/metadata.plist /Benutzer/
user name/Dokumente/Ersatz group name Kurzer Name der Gruppe. Ersetzen user name mit dem kurzen namen des benutzers, als den sie angemeldet sind. Wenn Sie dazu aufgefordert werden, geben Sie Ihr Administratorkonto-Passwort ein.
3 Öffnen Sie theme.plist im Property List Editor oder in einem Texteditor.
Um diese Datei in einem Befehlszeilen-Texteditor (in diesem Beispiel nano) zu öffnen, geben Sie Folgendes ein:
$ Sudo Nano theme name.wikitheme/theme.plist Wenn Sie dazu aufgefordert werden, geben Sie Ihr Administratorkonto-Passwort ein. Sie können jeden Texteditor verwenden, solange Sie dem Befehl vorausgehen, den Texteditoren mit sudo auszuführen. Wenn Sie den Property List Editor oder ein Nicht-Befehlszeilentool verwenden, öffnen Sie das theme.plist in Ihrem Dokumentenordner. Informationen zum Property List Editor finden Sie unter „Über den Property List-Editor auf Seite 14.
4 Bearbeiten Sie theme.plist und speichern Sie Ihre Änderungen.
5 Wenn Sie theme.plist in Ihren Dokumentenordner kopiert haben, kopieren Sie ihn zurück in den Theme-Ordner.
$ sudo cp / Benutzer/user name/Dokumente/theme.plist theme name.wikitheme/ Wenn Sie dazu aufgefordert werden, geben Sie Ihr Administratorkonto-Passwort ein.
Kapitel 3 Verwalten von Wiki-Inhalten 43

Klicken Sie in Server Preferences auf Web und verschieben Sie den Slider zu On. Â
Öffnen Sie im Server-Administrator das Offenlegungsdreieck für Ihren Server, wählen Sie Web aus und klicken auf ÂÂ
Starten Sie Web.
$ sudo serveradmin start teams; Geben Sie bei Aufforderung Ihr Administratorkonto-Passwort ein.
Die Metainformationen einer Seite ansehen Die Metainformationen einer Seite, wie Titel, letzter Autor und letztes Änderungsdatum werden gespeichert in:
Ersetzen group name Kurzer Name der Gruppe. Ersetzen page uid mit dem eindeutigen Identifikator Ihrer Seite.
Blog- und Mailinglistenarchivseiten haben auch jeweils eine eigene page.plist Datei.
Informationen zum Anzeigen oder Bearbeiten von Eigenschaftslistendateien finden Sie unter „Editing Property List Files auf Seite 14.
Schlüsselbeispielwert Beschreibung
Kurzer Benutzername des ursprünglichen Autors.
commentUID-Gruppen/group name/Diskussion/ page uid
Eindeutige Kennung für die Kommentarseite und deren Standort.
createDate 2008-02-19T18:58:47Z Originalseitenerstellung Datum und Uhrzeit.
editiert , Ursprünglich auf false gesetzt, wird dies beim ersten Speichern der Seite als true eingestellt.
Art wiki, weblog, mailinglist art der seite.
lastModifiedAuthor ravipatel Kurzer Benutzername der letzten Person, die die Seite bearbeitet hat.
modificate 2008-03-20T23:49:19Z Letzte Seite Änderung Datum und Uhrzeit.
Titel Begrüßungstitel der Seite.
44 Kapitel 3 Verwalten von Wiki-Inhalten

Schlüsselbeispielwert Beschreibung
Grabstein , Ursprünglich auf false gesetzt, wird dies bei vorübergehendem Löschen einer Seite auf true eingestellt.
Wenn eine Seite dauerhaft gelöscht wird, ist die gesamte page uid.page/ Ordner wird entfernt.
uid-Gruppen/group name/wiki/page uid/ Eindeutige Kennung für die Wiki-Seite und ihren Standort.
Versioniert , Wiki-Seiten sind versioniert; Blog und Mailinglisteneinträge nicht.
Nachdem Sie diese Datei manuell bearbeitet haben, löschen Sie die index.db-Datei der Gruppe und starten den Server neu. Weitere Informationen finden Sie unter „Manually Editing Raw Content auf Seite 40.
Verwaltung von Anlagen Wenn ein Benutzer eine Datei an eine Wiki-Seite anhängt, wird diese Datei gespeichert in:
Gruppe Name ist der kurze Name der Gruppe. Seite uid ist die eindeutige Kennung der Seite, an die die Datei angefügt wird und Anhang uid ist die eindeutige Kennung der Datei. Beide eindeutigen Identifikatoren sind in der URL des Anhangs enthalten:
Wenn jemand einen Anhang im Wiki löscht oder ersetzt, bleibt der alte Anhang auf dem Server. Dies ermöglicht die Verwendung der Funktion History des Wikis, um alte Versionen von angehängten Dateien wiederherzustellen.
Wenn Sie den Ordner mit dem Anhang auf dem Server löschen, können Benutzer den Anhang nicht wiederherstellen.
Kapitel 3 Verwalten von Wiki-Inhalten 45
In dieser Anleitung genannte Seiten – Hersteller, Support und Downloads.
Besitzer und unser Team antworten in der Regel innerhalb eines Tages – und Ihre Frage hilft auch anderen weiter.
Stellen Sie die erste Frage — andere Nutzer oder unser Team antworten Ihnen.