## Please edit system and help pages ONLY in the moinmaster wiki!
## For more information, please see MoinMaster:MoinPagesEditorGroup.
## Merci de n'éditer les pages systèmes et d'aide QUE sur MoinMaster !
## Pour plus d'information, consultez MoinMaster:MoinPagesEditorGroup.
##master-page:HelpOnActions/AttachFile
##master-date:2005-11-08 00:28:36
#acl MoinPagesEditorGroup:read,write,delete,revert All:read
#format wiki
#language fr

== Activer l'action « Joindre un fichier » (AttachFile) ==

L'action « Joindre un fichier » (`AttachFile`) permet d'associer plusieurs fichiers à une page. Étant donné qu'il est possible d'abuser des envois de pièces jointes pour réaliser des attaques de déni de service (''DoS''), l'action `AttachFile` peut être désactivée par l'administrateur du wiki. Reportez-vous à la page [wiki:Self:AideDeConfiguration#pièces-jointes Configuration de MoinMoin] pour plus d'informations.

== Créer des pièces jointes ==

Pour créer une pièce jointe, vous pouvez soit ajouter à une page un lien vers une pièce jointe (voir ci-dessous), soit cliquer sur le lien « Joindre un fichier » situé en bas de la page ou dans la liste déroulante des « Autres actions ». Dans le premier cas, une fois la page sauvegardée, un lien appelé « Envoi d'une nouvelle pièce jointe » apparaîtra sur celle-ci. Cliquer sur ce lien vous conduira à la page d'envoi de pièce jointe, tout comme l'aurait fait un clic sur le lien « Joindre un fichier ».

Le formulaire d'envoi est constitué de 2 champs. En plus du champ permettant d'indiquer le fichier à envoyer, un second champ optionnel (« Renommer en ») permet de donner au fichier un autre nom que celui qu'il avait sur votre ordinateur.

Un envoi de ficher n'écrasera jamais une pièce jointe existante. S'il y a conflit de nom, vous devrez renommer le fichier que vous souhaitez envoyer. Dans le cas contraire, si vous laissez vide le champ « Renommer en », la pièce jointe portera le nom du fichier original.

La possibilité de consulter, télécharger ou supprimer les pièces jointes existantes dépend du paramétrage du wiki et des droits d'accès de l'utilisateur. Par exemple, un utilisateur ne pourra supprimer une pièce jointe s'il n'a pas les droits de suppression (`delete`) pour cette page.

Tout envoi ou suppression de pièces jointes apparaît dans la page ModificationsRécentes et est donc soumis au contrôle de vos pairs. Contrairement aux modifications des pages, les versions antérieures ne sont pas conservées. En conséquences, ''pensez à conserver une copie locale de vos fichiers'' afin de pouvoir réparer un éventuel acte de vandalisme.

== Afficher des informations sur vos pièces jointes et leur liste ==

Il existe deux macros permettant de donner des informations sur les pièces jointes d'une page. La macro {{{[[AttachInfo]]}}} affiche une phrase assez courte sur l'ensemble des pièces jointes :

[[AttachInfo]]

La macro {{{[[AttachList]]}}} affiche la liste des pièces jointes d'une page :

[[AttachList]]

== Créer des liens vers les pièces jointes ==

Pour faire référence à une pièce jointe de la page, utilisez `attachment:nomdefichier.ext` ; un lien de ce type suit toutes les règles applicables aux liens normaux (c'est-à-dire que les images sont automatiquement affichées dans la page).
N'utilisez '''pas''' l'URL du lien `[obtenir]` présent sur la page d'envoi des pièces jointes, car ces liens peuvent changer et pourraient ne plus être valides après une mise à jour des paramètres du wiki.
Pour faire référence à des pièces jointes à d'autres pages, utilisez `attachment:NomWiki/nomdefichier.ext`.

Au lieu de `attachment:`, vous pouvez aussi utiliser `inline:` qui essaie d'afficher dans la page le contenu de la pièce jointe. Pour les images (c'est-à-dire les fichiers se terminant en `.gif`, `.jpg`, `.jpeg`, ou `.png`), cela ne change rien. Le contenu des fichiers de code source Python (c'est-à-dire des pièces jointes avec le suffixe `.py`) sera présenté avec une mise en relief syntaxique. Pour tous les autres types de fichier, le comportement sera le même qu'avec des liens de type `attachment:`.

Le troisième type de lien, `drawing:`, est présenté dans la section suivante.

== Editing vector drawings ==

A link looking like `drawing:picturename` will allow you to ''interactively'' edit vector diagrams via the built-in Java applet. The applet will then store three attachments, "`picturename.draw`", "`picturename.png`" and "`picturename.map`". After you first saved a drawing, the generated PNG picture is displayed for the `drawing:` link. The MAP is used to activate parts of the image as links. This means that you only need Java enabled for editing, while displaying the results works with any browser.

To edit a drawing after the first save, click on `AttachFile` and use the `[edit]` link that is displayed instead of `[view]` for the `.draw` attachment. You can also click on the invisible 5 pixel border around the picture to reach the edit mode. Saving a drawing is reflected in RecentChanges.

  /!\ Note: the applet is not WikiName sensitive. You need to supply actual (either relative or absolute) URLs as links.

  /!\ Note: drawings containing non-ascii characters in their name are not supported currently.

For details on using the drawing applet, see TWiki:Plugins/TWikiDrawPlugin.

== Installing packages ==
See HelpOnPackageInstaller.

== Unzipping files ==
To get access to the unzip feature you need the following rights on the page:
 * read
 * write
 * delete

e.g.
{{{
#acl UserName:admin,read,write,delete All:read
}}}

We implemented some protection for the server against abuse of this feature. Zip files in a Zip file are dropped by unzipping them. By definition of the configuration option {{{unzip_attachments_space}}}, only this total amount of bytes can be used to unzip files. If there are already files in the directory, the amount of them are subtracted from this number. The size of a single file in the archive which will be extracted can be limited using the configuration option {{{unzip_single_file_size}}}. 

The rules for unzipping are implemented in the same way as for uploading one file. It is not allowed to overwrite an existing file by unzipping a file. 

By unzipping a zip file only files from the first layer are unzipped. Files in directories are ignored.

A valid zip file could be created this way:

{{{
zip example.zip *.jpg
}}}

=== Uploading a zip file ===
After you have uploaded a zip file, you can see the {{{unzip}}} link.
 attachment:unzip1.png

=== No rights to unzip ===
If you have not enough rights, you only see the usual dialogue.
 attachment:unzip7.png

=== Not enough free space free ===
If the resulting unpacked files exceed the limit of filespace for attachments, you get this warning.
 attachment:unzip2.png
  ''This behaviour is controlled by the variable:'' {{{unzip_attachments_space}}}

=== Successfully unzipped ===
attachment:unzip3a.png [[BR]]
attachment:unzip3b.png

=== Extracted files would be too large ===
If a file in the archive exceeds the defined {{{unzip_single_file_size}}} then it is not unzipped.
 attachment:unzip5.png

=== zip files in zip file are dropped ===
If zip files are included in the zip archive, then they are dropped. Regular files included are extracted.
 attachment:unzip6.png
So the famous {{{42.zip}}} does not affect the system.
 attachment:unzip6b.png

= To do on this page =
 * to review
