• Immutable Page
  • Info
  • Attachments

AideDesActions/AttachFile

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 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 :

There are 3 attachment(s) stored for this page.

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

  • [get | view] (4.8 KB) attachment:unzip1.png
  • [get | view] (8.4 KB) attachment:unzip5.png
  • [get | view] (3.9 KB) attachment:unzip7.png

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

No rights to unzip

If you have not enough rights, you only see the usual dialogue.

Not enough free space free

If the resulting unpacked files exceed the limit of filespace for attachments, you get this warning.

Successfully unzipped

Upload new attachment "unzip3a.png"
Upload new 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.

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.

So the famous 42.zip does not affect the system.

To do on this page

  • to review

Tell others about this page:

last modified 2005-11-13 13:36:04