Aller au contenu principal

11 - Les documents et les PDF

Iris traite les documents comme des médias à part entière : ils ont une vignette, une description, un compteur de téléchargements, et une présentation soignée sur le site.

Les vignettes

Chaque document porte une feuille de couleur selon sa famille (texte, tableur, présentation, PDF, archive…), avec son extension : on les reconnaît d'un coup d'œil. Un PDF reçoit en plus une vraie miniature de sa première page, si le serveur a Imagick et Ghostscript. À partir d'Iris 3.0.210, cette miniature est en WebP quand le serveur sait l'écrire, en JPEG sinon. Sur le site, l'étiquette des documents Word est toujours bleue, quelle que soit la couleur principale du site. L'état du serveur est affiché dans Paramètres → Formats, Miniatures des PDF : vous savez tout de suite si c'est possible, et sinon ce qu'il faut demander à l'hébergeur.

Sur le site

Un document inséré ou présenté dans une galerie annonce son format et son poids avant qu'on clique, et propose Ouvrir et Télécharger. Quatre présentations : Tuiles, Image à gauche, Image au-dessus, Liste compacte. Un document seul occupe la moitié de la largeur ; le réglage Présentation d'un document inséré fixe la présentation par défaut.

Dans une galerie, à partir d'Iris 3.0.210 : en Tuiles, les boutons sont sous le texte, côte à côte, et le bouton dit simplement Télécharger, sans le nom du fichier. Un texte de lien que vous avez saisi vous-même est gardé.

Affiches (aperçu en grand) (3.0.302) : une présentation pour les affiches à imprimer. La première page de chaque PDF s'affiche en grand, au format portrait, et s'ouvre dans la visionneuse : on lit l'affiche avant de la télécharger. Elle se choisit pour une galerie, dans le module Iris Galeries, ou pour un document inséré seul.

Les téléchargements

Chaque téléchargement depuis le site est compté. Le nombre s'affiche dans la fiche du document, et, si vous le souhaitez, sous le document sur le site.

L'empreinte numérique (SHA-256)

Ce que c'est. L'empreinte est une suite de 64 chiffres et lettres calculée à partir du contenu exact d'un fichier, comme une empreinte digitale. Deux fichiers identiques ont la même empreinte ; si on change une seule virgule dans le document, l'empreinte change entièrement. Iris la calcule avec l'algorithme SHA-256, le plus courant aujourd'hui.

À quoi elle sert. Affichée sous le document, elle permet à chacun de vérifier que le fichier téléchargé est exactement celui que le site a publié, sans retouche. C'est utile pour tout document qui fait foi : les arrêtés et délibérations d'une commune, qui doivent être publiés « dans des conditions propres à garantir leur intégrité » (code général des collectivités territoriales, article R. 2131-1), un règlement, des statuts, des conditions générales, un tarif.

L'activer. Elle est éteinte par défaut.

  • Dans une galerie : réglages de la galerie, partie Documents, Empreinte SHA-256 sur Oui. Le module Iris Galeries peut garder le choix de la galerie ou le remplacer.
  • Pour un document inséré seul dans un article : Paramètres d'Iris, onglet Dans Joomla, Empreinte d'un document inséré sur Oui. Le réglage vaut pour tout le site.

Sur le site, la ligne Empreinte SHA-256 : suivie des 64 caractères apparaît sous le format et le poids du document.

Vérifier un document téléchargé. Comparez l'empreinte affichée sur le site avec celle calculée sur votre ordinateur. Les deux doivent être identiques, caractère pour caractère (majuscules et minuscules n'ont pas d'importance).

  • Sous Windows, dans PowerShell : Get-FileHash .\nom-du-fichier.pdf (l'algorithme SHA-256 est celui par défaut).
  • Sous macOS ou Linux, dans le Terminal : shasum -a 256 nom-du-fichier.pdf.

Ce que l'empreinte ne fait pas. Il faut le dire clairement à ceux qui la lisent :

  • Elle ne dit pas qui a écrit ou signé le document. Pour prouver l'auteur, il faut une signature électronique du PDF, qui se pose avant l'envoi sur le site.
  • Elle prouve qu'un fichier téléchargé n'a pas été modifié depuis sa publication. Elle ne prouve pas que le fichier publié n'a jamais été remplacé : si quelqu'un remplace le document sur le site, l'empreinte affichée change avec lui. Pour garder une trace, notez l'empreinte ailleurs au moment de la publication (registre, procès-verbal, courrier), ou faites horodater le document par un service de confiance.
  • Elle ne chiffre rien et ne protège pas le document : il reste lisible et téléchargeable par tous.

Coût pour le site. L'empreinte est calculée une seule fois, au premier affichage du document, puis gardée dans media/com_iris/empreintes. Si le fichier est remplacé (date ou poids différents), elle est recalculée. Ce dossier est supprimé à la désinstallation d'Iris.

À jour pour Iris 3.0.302. Les nouveautés postérieures à la 3.0.045 portent la version qui les apporte.