WoBL | PmWikiFr / Fichiers joints

Fichiers joints

Auteurs (intermédiaire)

PmWiki permet aux auteurs des pages d'y télécharger et d'y attacher des fichiers et des images. Ces fichiers peuvent alors être référencés depuis toutes les pages.

Note : Les fichiers joints sont désactivés par défaut. Pour savoir comment les activer et les configurer (taille maximale, types de fichier permis, mots de passe), consultez la page Administration des fichiers joints.

Note 2 : Les fichiers joints sont stockés dans des dossiers sur le serveur, un dossier par WikiGroupe. Il est aussi possible de stocker tous les fichiers du wiki dans un dossier unique, ou d'avoir des dossiers individuels par page : voir Administration des fichiers joints et $UploadPrefixFmt.

Syntaxe

Pour ajouter un lien vers un fichier joint, l'auteur insère la balise "Attach:" suivi du nom du fichier (par ex., "Attach:mon-CV.pdf"). Quand la page est affichée, la balise "Attach:" devient :

un lien vers le formulaire d'envoi (si le fichier n'est pas encore envoyé), ou
un lien vers ce fichier (s'il est déjà envoyé sur le wiki), ou
une image (si c'est un fichier image comme .png ou .jpg).

On peut aussi accéder au formulaire d'envoi par le lien "Attach", ou en ajoutant "?action=upload" à la fin de l'adresse URL de la page.

Pour créer un lien vers une image, au lieu de l'afficher dans la page, on peut entourer le lien Attach: de crochets doubles. Ainsi, [[Attach:image.jpg]] sera un lien en texte simple. Comme avec les autres liens, on peut spécifier le texte du lien :

[[(Attach:)fichier.zip]] affichera "fichier.zip",
[[Attach:fichier.zip|téléchargement]] affichera "téléchargement".

Notes pour les noms des fichiers :

On ne peut pas utiliser de lettres accentuées dans les noms de fichiers.
Il est déconseillé d'envoyer des fichiers dont les noms contiennent des espaces.
L'extension du fichier doit être en minuscules : .jpg et non .JPG (si le fichier est envoyé via le formulaire de PmWiki, son nom sera mis aux normes).

Fichiers joints à d'autres pages

Pour un lien vers un fichier joint à un autre WikiGroupe :

Attach:AutreGroupe./fichier.zip (notez le point après le groupe).

Si le stockage des fichiers joints se fait par page,

Attach:AutrePage/fichier.zip (AutrePage est dans le même WikiGroupe),
Attach:AutreGroupe.Page/fichier.zip (fichier dans un autre groupe).

Types de fichiers

Par défaut le téléchargement autorise les types suivants:

'gif','jpg','jpeg','png','bmp','ico','wbmp',          # images
'mp3','au','wav',                                     # audio
'mpg','mpeg','wmf','mov','qt','avi',                  # vidéo
'zip','7z', 'gz','tgz','tar','rpm','hqx','sit'        # archives
'odt','ods','odp',                                    # OpenOffice.org
'doc','rtf','ppt','xls','mdb',                        # MSOffice
'pdf','psd', 'ps','ai','eps',                         # Adobe
'htm','html','css','fla','swf',                       # web
'txt','exe','tex','dvi','kml','kmz',''                # autres

Listes des fichiers joints

La balise (:attachlist:) peut être utilisée afin d'afficher une liste des fichiers déjà joints. L'ordre dans lequel les éléments de cette liste sont affichés, peut être déterminé en ajoutant "X=A" ou "X=D", où X est au choix 'N','S', ou 'M' triant les éléments par nom, taille ou date et où 'A' et 'D' déterminent le sens ascendant ou descendant de ce tri. Par exemple, (:attachlist S=A:) affichera les attachements de la plus petite à la plus grande taille et (:Attachlist M=D:) affichera les éléments dans leur ordre chronologique inverse.

Remplacement et suppression des fichiers joints

Si un auteur envoie un fichier nommé comme un fichier existant l'existant est remplacé par le nouveau. Un administrateur peut configurer le wiki à refuser le nouvel envoi, ou à renommer le fichier existant.

Les fichiers téléchargés sur le serveur peuvent être effacés uniquement par l'administrateur du Wiki.

Le module Cookbook:Attachtable permet une gestion plus facile des fichiers joints, notamment leur renommage ou effacement depuis le formulaire d'envoi.

Vous pouvez tester les téléchargements sur le bac a sable (s'ils sont activés sur ce site), ou sur PmWiki:WikiSandbox.

<< Index des balises | Index de la documentation | Tableaux >>