Manuel d'utilisation / d'entretien du produit Computer du fabricant Apple
Aller à la page of 45
M a c OS X Se r v er Extending Y our Wiki Ser v er F or V ers i on 1 0 .5 Leopard.
© 2008 Apple Inc . A ll rights reserved. K The owner or authorized user of a v alid copy of Mac OS X Ser v er software may reproduce this publication for the purpose of learning to use such software.
5 Pr eface: About This Guide 5 Getting Additional Information 7 Chapter 1: C ustomizing How the Wiki Looks 7 Theme F ile Structure Over view 9 V ariant Theme File Structure Overview 1 0 Wireframe Them.
3 7 Chapter 3: Manag ing Wiki Con tent 3 7 Migrating Wiki Content F rom Other W ebsites 3 7 Backing Up the Wiki Ser ver 39 Wiki File Structure Over view 40 Manually Editing Raw Conten t 4 1 Viewing a .
5 This guide explains ho w to creat e custom themes , allow specic prot ocols, CSS st yles , and HTML tags and attributes , and manage wiki content. The default Wik i Ser ver conguration makes it easy for gr oups to collaborate and communicate .
6 Preface A bout This Guide F or information about administering wikis, see Direc tory H elp . Y ou can view Director y Help by opening Director y (located in /Applications/Utilitie s/) and choosing Help > Director y Help. F or information about using the wiki, see Wiki help.
7 This chapter de scribes how to cust omize a wiki’ s appearance . Y ou can use a wik i ’ s admin settings to do the following: Change the wiki ’ s title  Change the wiki ’ s theme  Add a .
Howev er , CSS les located in individual theme folders take prec edence and override the settings in this folder . Individual theme folders are subf olders with a .
Chapter 1 Customizing Ho w the Wiki Looks 9 V ariant Theme File S tructure O verview Pr ebuilt themes have sev eral variants , which all share the same la yout but might hav e di erent banners or color schemes . Shared CSS les are in the main theme ’ s folder , while variants ha ve separate CSS le s located in other folders.
Wireframe Theme File S truc ture Overview The wireframe theme is a good example theme t o customize , because unlike the other built-in themes, its CSS les are all located in its main theme f older (in the /Librar y location and not in the /usr location).
Chapter 1 Customizing Ho w the Wiki Looks 11 File or F older Name Purpose screen/calendar .css Sets the colors for the web calendar . screen/comments.css Sets various appearance attributes (such as padding , borders, and positioning) for comment entry and display .
Creating a Theme The easiest wa y to create a theme is t o take the existing wireframe theme, make a copy of it with permissions intact, and then customize the copy . If you edit the included themes instead of cop ying them to new themes, your edits may be ov er written later by a software update .
Chapter 1 Customizing Ho w the Wiki Looks 13 6 Restart the web ser vice by doing one of the following: Restart the ser ver .  In Ser ver Pr eference s, click W eb, move the slider to O , and then to On.  In Ser ver Admin, open the disclosure triangle for your server , select W eb , click Stop  W eb , and then click Star t W eb.
Here are some published CSS guides: Â CSS: The D enitive Guide , 3rd Edition, by Eric Meyer . O’Reilly Media, Inc. 2 006. Â CSS Mastery : A dvanced Web Standards Solutions , by Andy Budd , Simon Collison, and Cameron Moll. Friends of ED . 2006.
Chapter 1 Customizing Ho w the Wiki Looks 15 Pr oper t y List Editor doesn ’t show comments , so if you wan t to see the example sidebars provided in the wirefr ame’ s theme.plist, you’ll need t o open the theme.plist le in a text editor and remo ve the comment markers surrounding the example sidebars.
Here is the sidebars array in a plain text editor: <key>sidebars</key> <array> <dict> sidebar keys and values </dict> <dict> sidebar keys and values </dict> &.
Chapter 1 Customizing Ho w the Wiki Looks 17 Changing General Theme Settings The wireframe theme ’ s theme.plist includes keys and values f or the following general settings: Key Default V alue P os.
Creating Sidebars If you hav en ’t created a sidebar bef ore, it might be easier to customize an example sidebar to suit your needs . In the wireframe theme ’ s theme.
Chapter 1 Customizing Ho w the Wiki Looks 19 Static Unique K eys Static sidebars list predened URLs. “Useful Links” is an example static sidebar .
Key Example V alue P ossible V alues Optional or Required Description snippet Click here to see y our server ’ s homepage. Any string Optional Used for the link’ s tool tip. T o enable tool tips, comment out the following block in the theme’ s grouphome.
Chapter 1 Customizing Ho w the Wiki Looks 21 Key Example V alue P ossible V alues Optional or Required Description sort modiedDate, createdDate , title, author One or more of the following in the s.
T ag Unique Key s T ag sidebars list wiki, blog , and mailing list entries that use a specic tag or set of tags. The most recen tly modied entries are listed rst.
Chapter 1 Customizing Ho w the Wiki Looks 23 Using the Example Sidebars The wireframe theme ’ s theme.plist le includes several sidebar example s. All of these examples are commen ted out by default. Y ou’ll need to remo ve the comments marks if you want t o use the example sidebars as custom sidebars.
5 F or each sidebar that you wan t to comment out, do the following: a Add <!-- bef ore the <dict> tag of the sidebar you want to commen t out.
Chapter 1 Customizing Ho w the Wiki Looks 25 Adding Ja v aScript and XSL File s The wiki ser ver suppor ts the use of custom Jav aScript and Ex tensible Stylesheet Language (XSL) les. JavaScript and XSL change the con tent you ’ re displaying , whereas CSS controls the pr esentation of con tent.
2 Restart the web ser vice by doing one of the following: Restart the ser ver .  In Ser ver Pr eference s, click W eb, move the slider to O , and then to On.  In Ser ver Admin, open the disclosure triangle for your server , select W eb , click Stop  W eb , and then click Star t W eb.
Chapter 1 Customizing Ho w the Wiki Looks 27 Jav aScript Example The follo wing example JavaScript function adds a header link next to the magnier button that points t o www .apple.com, and changes the “O ther Wik is” link to point t o www .apple.
28 Chapter 1 Customizing Ho w the Wiki Looks If you edit a copy of the default.x sl le, you must also make copies of all of the XSL les that include the original default.xsl le , and then change them to include the edited default.xsl le . Viewing Dynamic XML The wiki ser ver dynamically generates XML c ontent, which is called context .
Chapter 1 Customizing Ho w the Wiki Looks 29 3 Restart the web ser vice by doing one of the following: Restart the ser ver .  In Ser ver Pr eference s, click W eb, move the slider to O , and then to On.  In Ser ver Admin, open the disclosure triangle for your server , select W eb , click Stop  W eb , and then click Star t W eb.
30 This chapter de scribes how to enable s pecic protocols , CSS styles, and HTML tags and attributes. The default wiki ser ver setup simplies administration b y automatically remo ving potentially harmful protoc ols, CSS st yles, and HTML tags and attributes.
Chapter 2 Allowing Specic P rotocols , CSS Styles, and HTML T ags and Attributes 31 Creating a C ustom Whitelist T o create a custom whit elist, creat e a plain text le named whitelist.plist in: /Library/Application Suppor t/Apple/Wik iSer ver/ The follo wing sections describe this example whitelist.
About the Cust om Whitelist’ s Struc ture The follo wing lines are required in the cust om whitelist: <?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.
Chapter 2 Allowing Specic P rotocols , CSS Styles, and HTML T ags and Attributes 33 F or example, to allow the use of the fon t-size style attribute, create the following block: <key>styles&l.
<array> <string>src</string> <string>type</string> <string>width</string> <string>height</string> </array> </dict> About the Built-in Whitelist Y ou can’ t change the built-in whitelist.
Chapter 2 Allowing Specic P rotocols , CSS Styles, and HTML T ags and Attributes 35 Prot ocol tel telnet vnc webcal xmpp CSS Styles Allow ed in the Built-in Whitelist The built-in whitelist allows .
Ta g Attributes node ol p pre q cite span strong table tbody tfoot th colspan, rows pan thead td colspan, rows pan tr u ul 36 Chapter 2 Allowing Specic P rotocols, CSS Styles, and HTML T ags and At.
3 7 This chapter de scribes how to manage wiki cont ent using tools and the command-line . Using tools and the command line allows y ou to migrate , back up, and edit raw wik i conten t.
T o manually back up the wiki, c opy the wiki data store with its permissions intact. F or example, to copy the wiki data store to a f older on a di erent volume , enter the following in T erminal .
Chapter 3 Managing Wiki Content 39 Wiki File Structure Over view By default, the wik i ser ver stores gr oup wik is in /Librar y/Collaboration/Gr oups/. The illustration below sho ws group wiki les and folders. index.db metadata.plist /Library/Collaboration/Groups/ attachments/ page.
The Groups f older in the wik i data store includes the f ollowing critical wiki les and folders: File or F older Name Purpose group_name / Enabling web services for a group create s a folder with the group ’ s shor t name. group_name /index.db Automatically changed when y ou edit wik i content.
Chapter 3 Managing Wiki Content 41 F or more information about A tomPub , see: W ebsite URL RFC 4287: The A tom Syndication F ormat atompub .org/rfc4287 .html RFC 5023: The A tom Publishing P rotocol tools.ietf .org/html/rfc5023 T o regenerate the index after editing ra w wiki content: 1 Delete /Library/Collaboration/Groups/ group_name /index.
The metadata.plist le includes the f ollowing keys: Key Example V alue Description GUID 28C C6BE9-1 1C1-456C-A3B2-8FCF5 5 20A1DB Uniquely identies the wiki. This value must corre spond to the group record’ s GUID in the director y domain. T o view a group record's GUID , use W orkgroup Manager .
Chapter 3 Managing Wiki Content 43 T o manually edit wik i administration settings: 1 Stop the web service by doing one of the following: In Ser ver Pr eference s, click W eb and move the slider to O .  In Ser ver Admin, open the disclosure triangle for your server , select W eb , and click  Stop Web .
6 Start the web ser vice by doing one of the following: In Ser ver Pr eference s, click W eb and move the slider to On.  In Ser ver Admin, open the disclosure triangle for your server , select W eb , and click  Start W eb.
Key Example V alue Description tombstoned <true/>, <false/> Originally set to false, this is set to true when a page is temporarily deleted. If a page is permanently deleted, the entire page_uid .page/ folder is removed . uid groups/ group_name /wiki/ page_uid / Unique identier for the wiki page and its location.
Un point important après l'achat de l'appareil (ou même avant l'achat) est de lire le manuel d'utilisation. Nous devons le faire pour quelques raisons simples:
Si vous n'avez pas encore acheté Apple Computer c'est un bon moment pour vous familiariser avec les données de base sur le produit. Consulter d'abord les pages initiales du manuel d'utilisation, que vous trouverez ci-dessus. Vous devriez y trouver les données techniques les plus importants du Apple Computer - de cette manière, vous pouvez vérifier si l'équipement répond à vos besoins. Explorant les pages suivantes du manuel d'utilisation Apple Computer, vous apprendrez toutes les caractéristiques du produit et des informations sur son fonctionnement. Les informations sur le Apple Computer va certainement vous aider à prendre une décision concernant l'achat.
Dans une situation où vous avez déjà le Apple Computer, mais vous avez pas encore lu le manuel d'utilisation, vous devez le faire pour les raisons décrites ci-dessus,. Vous saurez alors si vous avez correctement utilisé les fonctions disponibles, et si vous avez commis des erreurs qui peuvent réduire la durée de vie du Apple Computer.
Cependant, l'un des rôles les plus importants pour l'utilisateur joués par les manuels d'utilisateur est d'aider à résoudre les problèmes concernant le Apple Computer. Presque toujours, vous y trouverez Troubleshooting, soit les pannes et les défaillances les plus fréquentes de l'apparei Apple Computer ainsi que les instructions sur la façon de les résoudre. Même si vous ne parvenez pas à résoudre le problème, le manuel d‘utilisation va vous montrer le chemin d'une nouvelle procédure – le contact avec le centre de service à la clientèle ou le service le plus proche.
