Manual:Image administration/fr

Cet article décrit comment MediaWiki manipule et stocke les fichiers, et donne des informations de configuration.

Il s'applique aux images aussi bien qu'à tous les autres types de fichiers qui peuvent être téléversés. Tous les fichiers sont stockés avec un article qui leur correspond dans l'espace de noms "Fichier:". Dans les versions antérieures à MediaWiki 1.14, l'espace de noms "Image:" était utilisé à la place. "Image:" est toujours conservé en tant qu'alias dans un but de rétrocompatibilité.

Téléversement et utilisation des images
Voir

Activation du téléversement des images
Pour téléverser des images, ces conditions doivent être réunies:


 * 1) MediaWiki doit avoir le téléversement activé. Paramétrer  sur.
 * 2) Le type de fichier doit être autorisé. Pour plus d'informations:.
 * 3) L'utilisateur doit appartenir à un groupe qui détient les droits de téléversement. Par défaut, ils sont alloués à tous les utilisateurs logués.

Les téléversements se font en utilisant Special:Upload.

Voir, et 

Paramètres pertinents pour la manipulation des fichiers
Ces paramètres sont pertinents:



Affichage de miniatures pour les images
La syntaxe étendue pour les images (en) autorise les images à être automatiquement affichées en miniatures (voir pour de l'aide générale concernant le téléversement des fichiers).

La mise en miniature d'une image nécessite soit ImageMagick soit la bibliothèque GD - aucun des deux n'est inclus par défaut dans l'installation de MediaWiki, bien que certaines versions de PHP incluent GD. ImageMagick est recommandé si une meilleure qualité des miniatures est requise; il peut être téléchargé depuis imagemagick.org. GD est inclus dans certaines versions de PHP, et il est recommandé d'utiliser GD pour les systèmes Windows. Un téléchargement direct de GD est disponible depuis LibGD GitHub. Pour les version plus récentes, cela n'est pas nécessaire.

Si vous utilisez ImageMagick, paramétrez sur   dans le fichier LocalSettings.php. Vérifiez que la variable pointe vers le lien (absolu) de la commande de conversion de votre installation et que la commande est exécutable par le processus web du serveur. Par exemple, les utilisateurs de Windows devront remplacer la valeur par défaut par "C:\ImageMagick\convert.exe" (ou similaire).

Pour recréer les anciens fichiers de miniatures qui existaient avant que vous utilisiez ImageMagick, vous pouvez utiliser.

Si le rendu des images ne s'actualise pas, vérifiez la variable et augmentez sa valeur.

GraphicsMagick peut aussi être utilisé comme alternative à ImageMagick. Vous devrez initialiser à ce qui suit. Ex. :

GIF
Pour mettre en miniature les animations GIF sous Windows, vous devrez installer ImageMagick comme décrit plus haut.

SVG


MediaWiki supporte l'affichage des images SVG: lorsqu'elle sont activées, les images SVG peuvent être utilisées comme les autres fichiers image - elles seront automatiquement affichées comme des fichiers PNG et miniaturisées si besoin. Si vous utilisez un hébergement mutualisé et qu'aucun module d'affichage SVG n'est préinstallé, vous devrez probablement demander à votre hébergeur de l'installer pour vous.

Pour activer le support SVG :


 * 1) Autoriser le téléversement de fichiers SVG dans le fichier LocalSettings.php:   Notez que MediaWiki refusera les fichiers SVG qui contiennent du JavaScript, pour des raisons de sécurité.
 * Pour éviter un faux positif, ajoutez la valeur  au fichier.
 * If you are using MediaWiki 1.34 or higher, is never applied and now always true. You can safely remove this in your LocalSettings.php file.
 * Si une erreur concernant le fait que le fichier est corrompu est renvoyée, vérifiez que l' fonctionne correctement.
 * 1) Ajoutez la valeur   à  et paramétrez le module d'affichage que vous souhaitez utiliser.
 * Les options disponibles sont ImageMagick, ImagickExt , sodipodi , inkscape , batik , rsvg , et imgserv.
 * Par exemple:
 * 1) * librsvg est rapide mais pas très précis. Il dépend d'un grand nombre de bibliothèques. Pour installer toutes ces bibliothèques, vous pouvez utiliser un gestionnaire de paquets. Le projet Wikimedia utilise rsvg.
 * 2) * Batik est le module d'affichage SVG le plus précis, bien que son anti-aliasing soit quelquefois sous-optimal. Son parseur SVG est plus strict, ce qui est à l'origine d'un refus des fichiers SVG "presque valides" que les autres modules d'affichage acceptent (ex: commons:File:UbuntuCoF.svg). Batik dépend de Java, et est plus lent que rsvg, mais ça ne devrait pas être un gros problème à moins que vous n'ajoutiez en permanence des fichiers SVG. Voir SVG benchmarks. Demande beaucoup de travail pour être fonctionnel s'il n'est pas inclus dans votre distribution.
 * 3) * Inkscape fait également un travail précis pour les SVGs, moitié moins rapide que rsvg, mais il était prévu pour une utilisation graphique interactive; cependant il est associé à inkview qui est un programme de visualisation/conversion - il nécessite des droits d'écritures sur le répertoire 'home' pour l'utilisateur qui l'appelle. Tant qu'il sera lancé en tant qu'utilisateur  ou quelque chose du même type, il essaiera de créer les répertoires   et   dans les répertoires home correspondants, et va échouer silencieusement, crasher ou rester indéfiniment suspendu s'il n'y arrive pas. Inkscape est préférable à rsvg (a) sur Windows (il est disponible en tant que paquet indépendant) ou (b) si vous avez des SVGs importants dessinés avec Inkscape dont le rendu n'est pas correct avec rsvg. Inkscape a des chaînes de dépendances aussi compliquées que &mdash de librsvg; utilisez-le s'il est compris dans votre distribution ou disponible en tant que paquet complet indépendant.
 * 4) * Sodipodi est le fork de Inkscape. Les mêmes considérations s'appliquent. Sodipod ne fait plus l'objet d'un développement actif.
 * 5) * Depuis la version 6.x.x ImageMagick affiche les SVGs, mais de manière imparfaite. C'est l'option par défaut, mais évitez-le si possible. Toutefois, il fonctionne. Sur Windows, $wgConvertPath doit être paramétré pour éviter un conflit avec le convert.exe propre de Windows. Une alternative simple à ce scenario est au fichier LocalSettings.php la ligne de code $wgSVGConverters['ImageMagick'] = '"' . $wgImageMagickConvertCommand . '" -background white -thumbnail $widthx$height^! $input PNG:$output';, qui autorise aussi les espaces dans les chemins d'accès.
 * 6) ** Pour éviter les erreurs de création des vignettes avec ImageMagick, si la version est ≥ 7.0.9-25, alors il faut que la version de Inkscape soit aussi ≥ 1.x.x. De la même manière, si la version de ImageMagick est < 7.0.9-25, alors la version de Inkscape doit aussi être < 1.x.x. Voir problème ImageMagick.
 * 7) * L'extension PHP Imagick extension supporte l'affichage SVG, toutefois les mêmes considérations régulières que pour ImageMagick s'appliquent.
 * 8) * La bibliothèque GD ne sait pas convertir les images SVG en format PNG, du moins d'après ce que disait le blog NoScope de Joen Asmussen en juin 2008.
 * 9) * La plupart des navigateurs web sauf Internet Explorer (jusqu'à la version 9) peuvent afficher les SVGs directement. En utilisant librsvg pour convertir les SVGs en PNG, les résultats sont beaucoup plus précis et la bande passante consommée est moins importante. L'affichage SVG en direct n'est pas pris en charge par MediaWiki par défaut, à moins que l'extension ne soit installée.
 * 1) * La plupart des navigateurs web sauf Internet Explorer (jusqu'à la version 9) peuvent afficher les SVGs directement. En utilisant librsvg pour convertir les SVGs en PNG, les résultats sont beaucoup plus précis et la bande passante consommée est moins importante. L'affichage SVG en direct n'est pas pris en charge par MediaWiki par défaut, à moins que l'extension ne soit installée.

Initialisez  si les rendus SVG ne sont pas nécessaires et si vous souhaitez que vos utilisateurs téléchargent le fichier svg pour le visualiser.

Résolution des problèmes
Si vous apercevez un carré blanc à la place du SVG (Chrome) ou qu'il n'y a pas d'image du tout (Firefox) et que tous les liens PNG conduisent à l'erreur 404 et que vous ne voyez aucun autre message d'erreur ailleurs, veuillez vérifier la variable. En le fixant à  la transformation SVG peut être indéfiniement différée. Assurez-vous que les méthodes PHP proc_open et symlink sont opérationnelles (elles peuvent être désactivées dans php.ini pour des motifs de sécurité ou de performance).

JPEG (utilisant GD)
Ajoutez simplement la ligne suivante au fichier LocalSettings.php, ceci provoquera le repli automatique vers la bibliothèque GD.

Concernant les erreurs avec les vignettes JPEG, voir JPEG (utilisant GD).

TIFF
Pour générer les vignettes des fichiers TIFF, vous devez disposer de MediaWiki 1.15.0 ou plus récent.


 * 1) Autoriser le téléversement des fichiers TIFF dans le fichier LocalSettings.php :
 * 2) Ajoutez   à  et mettez la valeur à jpg ou png pour indiquer le type de vignette que vous souhaitez voir générer.
 * 3) Générer des vignettes à partir de fichiers TIFF peut nécessiter des ressources systèmes qui excèdent celles utilisées pour créer les vignettes des fichiers JPEG, GIF, ou PNG. Tenez-compte de valeurs bien adaptées pour   et

Suppression d'images
Les fichiers comme les pages wiki, ne peuvent être supprimés que par les utilisateurs ayant les droits pour  (delete) (assignés aux  par défaut). La suppression des fichiers est faite dès qu'on supprime la page de description associée (ou en cliquant sur le lien ' de la table ').

Supprimer une révision spécifique
Si un fichier a été modifié, il existe un historique de la modification du fichier, affiché sur la page de l'article du fichier. Chauqe révision possède un lien "". Si vous cliquez dessus, la révision et le fichier sont supprimés.

Les informations concernant les anciennes révisions des fichiers sont stockées dans la table alors que les informations sur les anciennes révisions des 'pages sont stockées dans la table.

Restituer les fichiers supprimés
Les fichiers peuvent être restaurés exactement de la même manière que les pages d'un wiki classique. Le répertoire dans lequel les fichiers supprimés sont stockés est défini par. Les informations concernant les images supprimées sont stockées dans la table.

Supprimer des fichiers archivés
Depuis la version 1.11 de Mediawiki, les images supprimées restent par défaut encore sur le serveur. Si vous souhaitez supprimer des images d'archives sélectionnées, vous pouvez le faire en utilisant le script de maintenance. Si vous souhaitez tous les supprimer, vous pouvez le faire avec le script. Si vous supprimez les fichiers d'archive, vous ne pourrez plus les restaurer.

Motifs de suppression d'un fichier
Si vous souhaitez supprimer un fichier, comme décrit ci-dessus, on vous demandera de fournir un motif pour la suppression. Les motifs disponibles sont sélectionnables dans la liste déroulante des motifs de suppression de votre wiki.

Stockage des données
Dès qu'une image est téléversée, plusieurs éléments sont créés :


 * 1) Un article de l'espace de noms File avec le nom du ficher, par exemple File:MyPicture.png. Cette page est enregistrée et peut être modifiée comme n'importe quelle autre page.
 * 2) Le fichier lui-même est rangé dans un répertoire du système de fichiers où tous les espaces du nom sont fusionnés et remplacés par un caractère.
 * 3) Si vous devez générer des vignettes et que la génération est disponible, elles seront créées quand il sera nécessaire (comme avec l'utilisation de la page de description du fichier). Les vignettes sont enregistrées séparément dans le sous-répertoire thumb du répertoire des images, en fonction du fichier principal.

Si est activé (par défaut), MediaWiki crée plusieurs sous-répertoires dans le répertoire des images.

Les noms de répertoire sont les deux premiers caractères du code de hachage md5 du nom du dernier fichier.

Répertoires
Tous les fichiers d'image sont stockés dans un répertoire déterminé par (par défaut  ).

Description des sous-répertoires nommés des images :


 * archive: anciens fichiers qui ont été remplacés par de nouvelles versions.
 * temp: sert au stockage temporaire des fichiers lors du téléversement des images. (A cause de, il est possible que ces fichiers ne soient pas automatiquement supprimés)
 * thumb: vignettes des fichiers (générées automatiquement). Si vous les supprimez, elles seront recréées automatiquement quand cela sera nécessaire.

En fonction de la configuration, il peut y avoir des sous-répertoires supplémentaires d'images :


 * math: répertoire contenant les entrées Tex à générer, voir aussi Extension:Math ou Manuel:Math.
 * x/xy: si  est initialisé à true (par défaut), les images seront stockées dans les sous-répertoires des images; les chemins seront donc de la forme  . Voir  pour plus de détails afin de savoir pourquoi ceci peut être souhaité et comment le système fonctionne.

Tables de la base de données

 * La page de description du fichier est stockée comme n'importe quelle page dans les tables des pages, textes, révisions, etc.
 * - contient quelques métadonnées telles que la taille du fichier et la date du téléversement.
 * - informations concernant les fichiers qui ont été remplacés par de nouvelles versions.
 * - garde les informations concernannt les fichiers supprimés.
 * - enregistre les pages qui utilisent un fichier.

Utilisation de l'espace
Les fichiers ont besoin d'espace considérablement plus grand que les articles. Les calculs suivants supposent que la taille du bloc est de 4 ko et des serveurs Linux/Unix.

La valeur par défaut est = true.

Espace nécessaire pour l'ensemble des répertoires :


 * répertoires d'images: 0-f/x0-f: max. 16*16 = 256 répertoires = 256*4 ko = 1024 ko
 * répertoires d'archives : 0-f/x0-f: max. 16*16 = 256 répertoires = 256*4 ko = 1024 ko
 * répertoires des vignettes : 0-f/x0-f: max. 16*16 = 256 répertoires = 256*4 ko = 1024 ko
 * répertoires temporaires : 0-f/x0-f: max. 16*16 = 256 répertoires = 256*4 ko = 1024 ko

Pour cela, la quantité d'espace nécessaire à la base sans aucune image téléversée est de 4 MB en théorie (bien que les répertoires soient créés seulement quand c'est nécessaire).

Pour chaque fichier, nous avons besoin de :


 * taille du fichier image original + 2 ko en moyenne pour les dépassements

Pour les fichiers qui ont besoin d'avoir leur vignette :


 * taille de la ou des vignettes créées + 2 ko en moyenne pour les dépassements (pour chacune)
 * répertoire des vignettes (4Ko) (chaque image possède son propre répertoire de vignettes)

Exemples :


 * image png de 20778 octets (petite taille, pas de vignette) : 24 ko pour l'image : total 24 ko
 * image jpeg de 123.000 octets (grande taille, vignette automatique) : 124 ko pour l'image, 4 ko pour le répertoire de la vignette, 64 ko pour la vignette: total: 192 ko

Accès aux fichiers
Les fichiers téléversés sont généralement distribués directement par le serveur web, et non pas via MediaWiki. Alors que l'on peut imaginer qu'il existe un niveau minimal de sécurité grâce à l'encodage des chemins (comme /c/c4/...), si  est initialisé, le chemin peut être calculé facilement à partir du nom de fichier ce qui ne fournit pas une réelle protection.

Pour limiter l'accès aux utilisateurs autorisés, voir.

Formulaire de téléversement
Voir la documentation sur la configuration du formulaire de téléversement.

Gestion des licences
Une fonctionnalité de MediaWiki permet à la page Special:Upload de centraliser les licences des images. La page de téléversement de Wikipedia possède une liste déroulante des licences sous le résumé de l'image. Cette fonctionnalité est désactivée par défaut dans MediaWiki. Pour activer cette fonctionalité, les administrateurs système doivent modifier les licenses de l'espace de noms MediaWiki (exemple : MediaWiki:Licenses). Ils peuvent faire cela en allant sur la page MediaWiki:Licenses de leur wiki et cliquer sur 'create' pour créer ou 'edit' pour mettre à jour.

La page MediaWiki:Licenses utilise le format défini dans une liste wiki.

La ligne 1 génère le texte de la license en substituant le modèle license 1 dans la page de l'image et en transcluant license 2.

La ligne 2 affiche un entête grisé avec le texte Header 1 :

La ligne 3 produit Attribution ShareAlike 2.5 et transclut le modèle cc-by-sa-2.5 sur la page de l'image.

Pour un exemple détaillé et concret, voir Wikipedia:MediaWiki:Licenses ou Commons:MediaWiki:Licenses.

Dépôts externes
Il est possible d'accèder aux fichiers stockés sur les dépôts externes, sans avoir à les téléverser sur le wiki, en initialisant le tableau. Cette fonctionnalité offre plusieurs possibilités :


 * ForeignAPIRepo permet d'accéder aux fichiers à partir d'une installation distante de MediaWiki telle que Wikimedia Commons, via son API
 * ForeignDBRepo permet d'accéder aux fichiers à travers une base de données, ce qui est utile pour la création de familles de wikis
 * FSRepo accède aux fichiers à partir d'un répertoire local

Dans tous les cas, il doit être possible d'inclure des fichiers dans une page en utilisant la syntaxe habituelle des images et de spécifier le nom du fichier dans le dépôt externe. Notez-bien que certaines des implémentations ci-dessus sont encore expérimentales et qu'elles ne peuvent pas forcément convenir pour des sites de production.