Manuale d’uso / di manutenzione del prodotto Computer Hardware del fabbricante Apple
Vai alla pagina of 45
M a c OS X Se r v er Extending Y our Wiki Ser ver F or V ersi on 1 0.5 L eopard.
© 2008 Apple Inc. All 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 Prefac e: 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: Managing Wiki Cont ent 3 7 Migrating Wiki Content F rom O ther Website s 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 how t o create cust om themes , allow specic prot ocols, CSS styles , and HTML tags and attributes , and manage wiki content. The default Wik i Server conguration makes it easy for groups t o collaborate and communicate .
6 Preface About This Guide F or information about administering wikis, see Direc t or y Help . Y ou can view Director y Help by opening Directory (located in /Applications/Utilities/) 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 appearanc e. Y ou can use a wiki’ s admin settings to do the following: Change the wiki’ s title  Change the wiki’ s theme  Add a cust.
However , CSS les located in individual theme folders take precedenc e 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 v erview Prebuilt theme s have sev eral variants , which all share the same layout but might have 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 F ile Struc ture Overview The wireframe theme is a good example theme to cust omize, because unlike the other built-in themes, its CSS les are all located in its main theme f older (in the /Library 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 to take the existing wirefr ame theme, make a copy of it with permissions intact, and then customize the copy . If you edit the included themes instead of copying them t o new themes, your edits may be ov er written lat er by a software update.
Chapter 1 Customizing Ho w the Wiki Looks 13 6 Restart the web ser vice by doing one of the f ollowing: Restart the ser ver .  In Ser ver P references , click Web , mo ve the slider to O , and then to On.  In Ser ver A dmin, open the disclosure triangle for your server , select Web , click S top  W eb , and then click Star t Web .
Here are some published CSS guides: Â CSS: The Denitive Guide, 3rd Edition, b y Eric Meyer . O’Reilly Media, Inc . 2006. Â CSS Mastery : Advanced Web Standards Solutions, b y Andy Budd, Simon Collison, and Cameron Moll. Friends of ED . 2 006. Editing P roper ty List F iles Every theme has a theme.
Chapter 1 Customizing Ho w the Wiki Looks 15 Property List Editor doesn ’t show commen ts, so if you want to see the example sidebars provided in the wireframe ’ s theme.plist, you’ll need to 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 for the f ollowing general settings: Key Default V alue Poss.
Creating Sidebars If you haven ’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 Ke ys 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 tha t 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 examples . All of these examples are commen ted out by default. Y ou’ll need to remov e the comments marks if you want t o use the example sidebars as custom sidebars.
5 F or each sidebar that you want t o comment out, do the following: a Add <!-- befor e the <dict> tag of the sidebar you want to commen t out.
Chapter 1 Customizing Ho w the Wiki Looks 25 Adding Ja vaScript and XSL F iles The wiki ser ver supports the use of custom Jav aScript and Extensible St ylesheet Language (XSL) les. JavaScript and XSL change the con tent you ’ re displaying , whereas CSS controls the pre sentation of cont ent.
2 Restart the web ser vice by doing one of the f ollowing: Restart the ser ver .  In Ser ver P references , click Web , mo ve the slider to O , and then to On.  In Ser ver A dmin, open the disclosure triangle for your server , select Web , click S top  W eb , and then click Star t Web .
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 to www .apple.com, and changes the “O ther Wik is ” link to point to 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 gener ates XML cont ent, which is called context .
Chapter 1 Customizing Ho w the Wiki Looks 29 3 Restart the web ser vice by doing one of the f ollowing: Restart the ser ver .  In Ser ver P references , click Web , mo ve the slider to O , and then to On.  In Ser ver A dmin, open the disclosure triangle for your server , select Web , click S top  W eb , and then click Star t Web .
30 This chapter de scribes how to enable s pecic protocols , CSS styles, and HTML tags and attribute s. The default wiki ser v er setup simplies administration by a utomatically removing potentially harmful protocols , CSS styles, 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, create a plain text le named whitelist.plist in: /Library/Application Suppor t/Apple/WikiSer v er/ The follo wing sections describe this example whitelist.
About the Cust om Whitelist’ s Struc tur e The follo wing lines are required in the custom whit elist: <?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<.
<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 Protoc ol tel telnet vnc webcal xmpp CSS Styles Allow ed in the Built-in Whitelist The built-in whitelist allows t.
Ta g Attributes node ol p pre q cite span strong table tbody tfoot th colspan, rowspan thead td colspan, rowspan tr u ul 36 Chapter 2 Allowing Specic Protoc ols, CSS St yle s, 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 wiki 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 server stores gr oup wikis 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 folder in the wiki data store include s the following 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 you edit wiki conten t.
Chapter 3 Managing Wiki Content 41 F or more information about At omPub , see: W ebsite URL RFC 4287: The Atom S yndication Format atompub .org/rfc4287 .html RFC 5023: The Atom P ublishing Protoc ol tools.ietf.org/html/rfc5023 T o regenerat e the index after editing raw wiki cont ent: 1 Delete /Library/Collaboration/Groups/ group_name /index.
The metadata.plist le includes the f ollowing keys: Key Example V alue Description GUID 28CC6BE9-1 1C1-456C-A3B2-8FCF5 520A1DB Uniquely identie s the wiki. This value must corres pond to the group record’ s GUID in the directory domain. T o view a group record's GUID , use Workgroup Manager .
Chapter 3 Managing Wiki Content 43 T o manually edit wiki administration settings: 1 Stop the web service by doing one of the following: In Ser ver P references , click Web and mov e the slider to O .  In Ser ver A dmin, open the disclosure triangle for your server , select Web , and click  Stop Web .
6 Start the web ser vice by doing one of the f ollowing: In Ser ver P references , click Web and mov e the slider to On.  In Ser ver A dmin, open the disclosure triangle for your server , select Web , 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 punto importante, dopo l’acquisto del dispositivo (o anche prima di acquisto) è quello di leggere il manuale. Dobbiamo farlo per diversi motivi semplici:
Se non hai ancora comprato il Apple Computer Hardware è un buon momento per familiarizzare con i dati di base del prodotto. Prime consultare le pagine iniziali del manuale d’uso, che si trova al di sopra. Dovresti trovare lì i dati tecnici più importanti del Apple Computer Hardware - in questo modo è possibile verificare se l’apparecchio soddisfa le tue esigenze. Esplorando le pagine segenti del manuali d’uso Apple Computer Hardware imparerai tutte le caratteristiche del prodotto e le informazioni sul suo funzionamento. Le informazioni sul Apple Computer Hardware ti aiuteranno sicuramente a prendere una decisione relativa all’acquisto.
In una situazione in cui hai già il Apple Computer Hardware, ma non hai ancora letto il manuale d’uso, dovresti farlo per le ragioni sopra descritte. Saprai quindi se hai correttamente usato le funzioni disponibili, e se hai commesso errori che possono ridurre la durata di vita del Apple Computer Hardware.
Tuttavia, uno dei ruoli più importanti per l’utente svolti dal manuale d’uso è quello di aiutare a risolvere i problemi con il Apple Computer Hardware. Quasi sempre, ci troverai Troubleshooting, cioè i guasti più frequenti e malfunzionamenti del dispositivo Apple Computer Hardware insieme con le istruzioni su come risolverli. Anche se non si riesci a risolvere il problema, il manuale d’uso ti mostrerà il percorso di ulteriori procedimenti – il contatto con il centro servizio clienti o il servizio più vicino.
