Apple Computer manuel d'utilisation

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45

Aller à la page of

Un bon manuel d’utilisation

Les règles imposent au revendeur l'obligation de fournir à l'acheteur, avec des marchandises, le manuel d’utilisation Apple Computer. Le manque du manuel d’utilisation ou les informations incorrectes fournies au consommateur sont à la base d'une plainte pour non-conformité du dispositif avec le contrat. Conformément à la loi, l’inclusion du manuel d’utilisation sous une forme autre que le papier est autorisée, ce qui est souvent utilisé récemment, en incluant la forme graphique ou électronique du manuel Apple Computer ou les vidéos d'instruction pour les utilisateurs. La condition est son caractère lisible et compréhensible.

Qu'est ce que le manuel d’utilisation?

Le mot vient du latin "Instructio", à savoir organiser. Ainsi, le manuel d’utilisation Apple Computer décrit les étapes de la procédure. Le but du manuel d’utilisation est d’instruire, de faciliter le démarrage, l'utilisation de l'équipement ou l'exécution des actions spécifiques. Le manuel d’utilisation est une collection d'informations sur l'objet/service, une indice.

Malheureusement, peu d'utilisateurs prennent le temps de lire le manuel d’utilisation, et un bon manuel permet non seulement d’apprendre à connaître un certain nombre de fonctionnalités supplémentaires du dispositif acheté, mais aussi éviter la majorité des défaillances.

Donc, ce qui devrait contenir le manuel parfait?

Tout d'abord, le manuel d’utilisation Apple Computer devrait contenir:
- informations sur les caractéristiques techniques du dispositif Apple Computer
- nom du fabricant et année de fabrication Apple Computer
- instructions d'utilisation, de réglage et d’entretien de l'équipement Apple Computer
- signes de sécurité et attestations confirmant la conformité avec les normes pertinentes

Pourquoi nous ne lisons pas les manuels d’utilisation?

Habituellement, cela est dû au manque de temps et de certitude quant à la fonctionnalité spécifique de l'équipement acheté. Malheureusement, la connexion et le démarrage Apple Computer ne suffisent pas. Le manuel d’utilisation contient un certain nombre de lignes directrices concernant les fonctionnalités spécifiques, la sécurité, les méthodes d'entretien (même les moyens qui doivent être utilisés), les défauts possibles Apple Computer et les moyens de résoudre des problèmes communs lors de l'utilisation. Enfin, le manuel contient les coordonnées du service Apple en l'absence de l'efficacité des solutions proposées. Actuellement, les manuels d’utilisation sous la forme d'animations intéressantes et de vidéos pédagogiques qui sont meilleurs que la brochure, sont très populaires. Ce type de manuel permet à l'utilisateur de voir toute la vidéo d'instruction sans sauter les spécifications et les descriptions techniques compliquées Apple Computer, comme c’est le cas pour la version papier.

Pourquoi lire le manuel d’utilisation?

Tout d'abord, il contient la réponse sur la structure, les possibilités du dispositif Apple Computer, l'utilisation de divers accessoires et une gamme d'informations pour profiter pleinement de toutes les fonctionnalités et commodités.

Après un achat réussi de l’équipement/dispositif, prenez un moment pour vous familiariser avec toutes les parties du manuel d'utilisation Apple Computer. À l'heure actuelle, ils sont soigneusement préparés et traduits pour qu'ils soient non seulement compréhensibles pour les utilisateurs, mais pour qu’ils remplissent leur fonction de base de l'information et d’aide.

Table des matières du manuel d’utilisation

  • Page 1

    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[...]

  • Page 2

    © 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. No part of this publication may be repr oduced or transmitted for commer cial purposes, such as selling copies of this publication or for pr oviding [...]

  • Page 3

    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 Theme File Structure Overview 1 2 Creating a Theme 13 Editing CSS F iles 1 4 Editing P roper ty List Files 1 4 About Pr oper t y List Editor 1 5 About Pr [...]

  • Page 4

    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 Wiki’ s Administration Settings 44 Viewing a Page ’ s M etainformation 45 Managing Attachments 4 Cont ents[...]

  • Page 5

    5 This guide explains ho w to creat e custom themes , allow specic prot ocols, CSS st yles , and HTML tags and attributes , and manage wiki content. The default Wik i Ser ver conguration makes it easy for gr oups to collaborate and communicate . Users can creat e and edit wik i pages, tag and cross-refer ence material, upload les and image[...]

  • Page 6

    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. Y ou can vie w Wiki help by click ing the Help link located at the bot[...]

  • Page 7

    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 custom tag-sear ch sidebar to the main page  Choose who can make comments and which comments ar e moderated  Create a podcast and in tegrate it wi[...]

  • Page 8

    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 .wikitheme ex tension that are located within this folder: /Library/Application Suppor t/Apple/Wik iSer ver/Themes/ /Library/Application Suppor t/Apple/WikiSer ver/Themes/ compressed/ [...]

  • Page 9

    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. /usr/share/c[...]

  • Page 10

    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). I t was designed as a bare-bones theme , which you can easily add to without ha ving to rem[...]

  • Page 11

    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 . screen/footer .css Sets footer attributes , such as the margin, padding , color , an[...]

  • Page 12

    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 . T o create a copy of the wirefr ame theme with per[...]

  • Page 13

    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. Enter the f[...]

  • Page 14

    Here are some published CSS guides: Â CSS: The D enitive 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. Editing P roper ty List File s Every theme has a theme.plist le, which controls: The name of th[...]

  • Page 15

    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. About Pr oper ty List Files The theme[...]

  • Page 16

    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> </array> Here is an example of an array with a single string: <array> <string> value </string> </array> Here is an exampl[...]

  • Page 17

    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 ossible V alues Optional or Required Description bannerImageHeight 99 Any number , 0 or more Optional The amount in pixels allot ed to the height of the[...]

  • Page 18

    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.plist le, there is a sidebars section that contains an array of sidebars you can cust omize: <key>sidebars</key> <array> <dict> sidebar keys and values [...]

  • Page 19

    Chapter 1 Customizing Ho w the Wiki Looks 19 Static Unique K eys Static sidebars list predened URLs. “Useful Links” is an example static sidebar . Static sidebars hav e the following keys: Key Example V alue P ossible V alues Optional or Required Description urls Not applicable An array of dictionary entries, each representing a single link [...]

  • Page 20

    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. css le: .grouphome .snippet{ display:none; } Search Unique Ke ys Search sidebars list [...]

  • Page 21

    Chapter 1 Customizing Ho w the Wiki Looks 21 Key Example V alue P ossible V alues Optional or Required Description sort modiedDate, createdDate , title, author One or more of the following in the same arr ay :  title  author  authorLongName  lastModiedAuthor  lastModiedAuthor LongName  createdDate  modiedDate  content Â[...]

  • Page 22

    T ag Unique Key s T ag sidebars list wiki, blog , and mailing list entries that use a specic tag or set of tags. The most recen tly modied entries are listed rst. T ag sidebars have the f ollowing unique keys: Key Example V alue P ossible V alues Optional or Required Description tag hot A single string or several strings all in the same ar[...]

  • Page 23

    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. If you don ’t add any custom sidebars[...]

  • Page 24

    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. F or sidebars, <dic t> tags are follo wed by the displa yName key . F or example, to comment out the “ What’ s Hot ” sidebar , you ’ d change this: <dict> <key>displayName[...]

  • Page 25

    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. For example , you use could use JavaScript or XS[...]

  • Page 26

    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. Enter the f ollowing in T erminal:  $ sudo serveradmin[...]

  • Page 27

    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 magnier button that points t o www .apple.com, and changes the “O ther Wik is” link to point t o www .apple.com: Event.observe(window, 'load', function() { // add another header link (to apple.c[...]

  • Page 28

    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 . [...]

  • Page 29

    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. Enter the f[...]

  • Page 30

    30 This chapter de scribes how to enable s pecic protocols , CSS styles, and HTML tags and attributes. The default wiki ser ver setup simplies administration b y automatically remo ving potentially harmful protoc ols, CSS st yles, and HTML tags and attributes. The wiki ser ver is capable of allowing all protocols , CSS st yles, and HTML tags [...]

  • Page 31

    Chapter 2 Allowing Specic 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.plist in detail: <?xml version="1.0[...]

  • Page 32

    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.apple. com/DTDs/PropertyList-1.0.dtd"> <plist version="1.0"> <dict> [...]

  • Page 33

    Chapter 2 Allowing Specic 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</key> <array> <string>font-size</string> </array> T o allow the HTML “ st yle ” attribute, add the “ st yle” attr[...]

  • Page 34

    <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. Howev er , a software update could change the allowed elemen ts in the built-in whitelist. Pr o[...]

  • Page 35

    Chapter 2 Allowing Specic 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 the se CSS styles: Style text-decoration font-weigh t font-style HTML T ags and Attribute s Allowed in the Built-in Whitelist The built-in whitelist a[...]

  • Page 36

    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 Specic P rotocols, CSS Styles, and HTML T ags and Attributes[...]

  • Page 37

    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. Migrating Wik i Cont ent F rom Other W ebsites AppleWikiImpor ter is a tool that can trav erse a website that has a page listing all other pages in the site , and [...]

  • Page 38

    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 and then authenticate as an administra tor when requested: sudo ditto /Library/Collaboration/ /Volumes/ volumename / foldername / If you created or ed[...]

  • Page 39

    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.html page.plist wiki/ group_name/ attachment_filename attachmen[...]

  • Page 40

    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. If you manually edit raw con tent, erase this ?[...]

  • Page 41

    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.db . [...]

  • Page 42

    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 identies 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 . For more information, see User Managemen[...]

  • Page 43

    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 . Enter the f ollowing in T erminal:  $[...]

  • Page 44

    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. Enter the f ollowing in T erminal:  $ sudo serveradmin start teams; If prompted , enter y our administrator accoun t pass[...]

  • Page 45

    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 identier for the wiki page and its location. versioned <true/&[...]