Préambule

Les documents peuvent être de divers types : fichiers de divers formats (pdf, texte,…) , image, url, etc. Ils sont enregistrés dans la Médiathèque avec, chacun, un identifiant unique.

Un document peut être utilisé dans plusieurs articles, ce qui facilite sa gestion ; par exemple, en le modifiant (voir ci-dessous), les articles l’utilisant seront automatiquement mis à jour sans avoir à intervenir sur chacun d’entre-eux.

On peut aussi adapter certains paramètres du document, notamment les images, en les précisant dans la balise insérée dans les articles : taille, titre, position, descriptif,…

 

accéder à la Médiathèque

 

Insérer un document

Que le document à insérer dans un article soit présent ou non dans la Médiathèque, la démarche est identique ; ce qui change, c’est la source qui peut être :

• depuis votre ordinateur
• depuis la Médiathèque
• depuis internet
• depuis le serveur qui héberge le site
  ce qui est utile si le document a un poids trop lourd
  Contactez le webmestre si c’est le cas

En étant dans l’interface de rédaction, sur la page concernant un article, vous avez plusieurs possibilités pour ajouter un document :

• en passant par le bas de page
  la fonction « Ajouter un document »
  est située dans le bas de la page de l’article
• en passant par le mode modification
  la fonction est située sur la gauche quand on est passé en mode de modification de l’article
• directement dans la médiathèque
  la fonction est située dans le bas de la page « Médiathèque »

 

en passant par le bas de page

en passant par le mode modification

directement dans la médiathèque

 

Modifier un document

Si un document présent dans la Médiathèque a une nouvelle version, il est déconseillé de le supprimer de la médiathèque pour l’ajouter à nouveau : il aurait alors un identifiant différent, ce qui vous obligerait à modifier cet identifiant dans chaque article utilisant le document ; avec le risque d’en oublier… Et si des collègues utilisent le document, ils auraient la surprise de voir disparaître le document dans les articles l’utilisant.

Là aussi, il y a plusieurs possibilités pour modifier un document :

• en passant par le bas de page
• directement dans la médiathèque
• en passant par le mode modification
  mentionné pour mémoire : il est préférable d’utiliser l’une des autres possibilités qui permet de modifier des documents sans modifier le texte de l’article les utilisant
  par contre, cette possibilité peut être utilisée pour ajouter des légendes au document (voir ci-dessous)

 

en passant par le bas de page

Remarque : si la nouvelle version a un nom différent, le document, tout en gardant le même identifiant, prendra le nom de la nouvelle version. Cela permet d’éventuellement corriger une coquille dans le nom du document.

 

directement dans la médiathèque

 

Afficher un document

Depuis la version 4.0 de Spip, un seul modèle permet d’afficher les documents : <doc> ; cependant, les modèles <img> et <emb> restent actifs pour assurer une rétro-compatibilité mais ils ne permettent pas d’utiliser tous les paramètres associés au modèle <doc>.

Pour insérer un document, il suffit d’ajouter la balise <doc> dans le contenu de votre article. Par exemple, si l’identifiant du document est 25016, la balise à insérer sera <doc25016>.

Remarque : si vous utilisez les modèles <img> ou <emb>, seule la position indiquée sera active ; le titre sera visible via une info-bulle.

 

Position du document

Un document peut être à droite, à gauche ou centré : il suffit de le préciser dans la balise :

• position à droite : <doc25016|right>
• position à gauche <doc25016|left>
• position au centre <doc25016|center>

Remarque : dans le cas des positions à droite ou à gauche, le texte se trouve respectivement à gauche ou à droite. Si on veut que la suite du texte qui ne concerne plus l’image soit renvoyé dessous, vous pouvez par exemple ajouter la balise <div style="clear:both"></div>.

 

Redimensionner une image

Dans le cas d’un document qui est une image, dont les dimensions sont par exemple 500×800 [1], on peut diminuer ses dimensions en précisant une largeur ou une hauteur :

• diminuer la largeur : <doc25016|center|largeur=250>
• diminuer la hauteur : <doc25016|center|hauteur=600>

Cela est très pratique si une image doit être utilisée par différents articles : il suffira de préciser la taille souhaitée dans chaque article.

Remarque : la largeur ou la hauteur indiquée doit être plus petite ou égale à celle de l’image. Sinon l’image ne sera pas redimensionnée.

 

Ajouter une légende au document

On peut ajouter un titre, un descriptif, des crédits notamment, en les précisant dans la balise :

• ajouter un titre : <doc25016|center|titre=discours>
• ajouter un descriptif : <doc25016|center|descriptif=programme de la journée>
• combiner le titre et le descriptif : <doc25016|center|titre=programme de la journée|descriptif=à télécharger>

 
Il est possible d’ajouter ces légendes au document sans passer par une balise comme ci-dessus. Pour cela, utilisez le bouton Modifier (voir les explications à son sujet ci-dessus) :

• en passant par le bas de page
• directement dans la médiathèque
• en passant par le mode modification

Dans chacune de ces possibilités, après avoir cliqué sur le bouton Modifier, vous obtiendrez une fenêtre (voir ci-contre) vous permettant d’ajouter des légendes.

 

Recommandations pour les images

• Le poids des documents
  Ces documents étant stockés sur un serveur, il vaut mieux que leurs poids soient le plus petit possible ; cela favorise de plus la fluidité de navigation.

• Le format des images
  Le format des images à utiliser est le format jpg (ou jpeg, Joint Photographic Experts Group) sauf si vous voulez ajouter de la transparence : utilisez alors le format png (Portable Network Graphics).

• La taille des images
  Dans le cas particulier des images, elles sont limitées à un affichage d’une largeur de 640 px : il est donc inutile d’avoir une largeur plus grande dans la majorité des cas.
  Exception : pour des images dont il est utile de montrer certains détails (elles seront alors zoomables à l’aide d’un clic) ou que l’on voudra inclure dans un diaporama, on pourra leur donner une largeur de 1000 px.
  Images dans un tableau : on limitera leur largeur à 400 px (à adapter en fonction du nombre de colonnes), sauf si on veut qu’elles soient zoomables comme ci-dessus ; et dans ce cas on limitera leurs tailles à 400 px via un paramètre dans la balise incorporée dans le texte, l’image elle-même ayant été redimensionnée à 1000 px.

• Les droits des documents :
  Les documents utilisés dans l’article (y compris les images) sont-ils protégés par le droit d’auteur ou le droit à l’image et en avez-vous obtenu l’autorisation s’ils ne sont pas libre de droits ?

 

Cas des logos des articles et des rubriques

Les logos des articles et des rubriques sont des images spécifiques. Vous pouvez consulter l’article Rédiger un article qui contient une entrée à ce sujet :

• Ajout et modification d’un logo
  ajouter, modifier, taille, format

 

Exemple d’images dans un tableau
doc137887 : acces_mediatheque.jpg (largeur : 482 px) doc137902 : recherche_mediatheque_logo.jpg (largeur : 848 px) cette image sera zoomable codes respectifs : <doc137887|center|largeur=350|descriptif=~ pour accéder à {{la Médiathèque}} passez la souris sur [**Édition*] {un menu se déplie…} déplacez la souris pour cliquer sur [**Documents*]> <doc137902|center|largeur=450|titre=~ recherche dans la Médiathèque|descriptif=exemple avec «logo» dans le champ de recherche 297 documents sont trouvés avec «logo_apmep» on n'en trouve plus que 30 {cliquez sur l'image pour la zoomer}> noter les retours à la ligne (en comparant avec l’affichage)
affichage :

 

Des outils pour les documents

Framasoft propose des outils pour la gestion de vos documents, que ce soit pour convertir les formats des fichiers ou pour transformer, manipuler ou compresser des fichiers : accédez à des milliers d’utilitaires conviviaux pour modifier des images, du texte, des listes et des données, directement depuis votre navigateur.

• convertir un document
• boîte à outils pour documents

Ces outils sont conçus par Framasoft et vous pouvez lire ce qui a motivé leurs développements, que ce soit pour les outils de conversion ou ceux de la boîte à outils.

 

Références

La documentation officielle de Spip peut être consultée avec bénéfice car les informations et explications ci-dessus ne couvrent pas toutes les possibilités, notamment si une nouvelle version de Spip ouvre de nouvelles évolutions sur la gestion des documents ; par exemple, ce sera le cas si les logos des articles sont disponibles directement dans la Médiathèque.

La documentation officielle — extrait

• guide de rédaction
  • les raccourcis Spip
  • ajouter des images
• l’aide en ligne

Des contributions à la documentation

• cours Spip 4 pour rédacteur et rédactrice
• Spip 4 vu du côté de la rédaction
• Rédiger et publier sur votre site Spip