Journal Le printemps pointe le bout de ses bourgeons, SPIP sa version 4.1

Posté par  (site web personnel, Mastodon) . Licence CC By‑SA.
Étiquettes :
18
12
mar.
2022

Avec le printemps qui pointe le bout de ses bourgeons et SPIP dont la version 4.1 va bientĂ´t sortir, il Ă©tait temps de le faire.

Le, c’est le guide à l’attention des personnes qui doivent animer un site tournant avec le logiciel de gestion de contenu (CMS) SPIP. J’en avais rédigé la toute première version pour une cliente il y a quelques années (qui s’est empressée de le perdre, mais passons) et l’ai un peu revu pour le mettre en téléchargement. Au départ, je n’avais pas la moindre intention d’y retoucher. Mais, comme il a été repris sur SPIP-Contrib, il m’a semblé que, finalement, une mise à jour s’avérait utile, si pas nécessaire.

Cette version a été entièrement revue, de la cave au grenier et certains chapitres complètement réécrits, d’une part parce que, outre l’aspect de l’interface de SPIP qui a changé d’allure, le traitement des médias a aussi subi de profonds changements, d’autre part parce que la cible étant moins ciblée, une re-rédaction de certains passages s’imposait.

À qui est-il destiné ?

Aux personnes amenées à alimenter un site sous SPIP, « simples » rédacteurs ou administrateurs. Il n’est pas destiné aux personnes qui « mettent les doigts dans le cambouis » pour fabriquer et maintenir le site sous l’aspect technique, même si ça peut aussi leur servir.

De quoi ça parle ?

De l’art et la manière de travailler avec SPIP pour pondre un article, l’illustrer ou pas, voire le traduire. Et, évidemment, ça parle d’accessibilité, de la nécessité de remplir le champ « alternative textuelle » seulement quand c’est nécessaire pour la compréhension (donc pas systématiquement).

Les grands chapitres :

  • Chapitre 1 : SPIP : prĂ©sentation gĂ©nĂ©rale
  • Chapitre 2 : AccĂ©der Ă  l’espace privĂ©
  • Chapitre 3 : Saisir un article
  • Chapitre 4 : Ajouter des mĂ©dias et des documents
  • Chapitre 5 : VĂ©rifier, traduire et publier

Secrets de fabrique

Secrets, c’est vite dit. En effet, comme je n’avais pas bien compris le nouveau fonctionnement d’insertion des images dans SPIP, j’ai lancé un SOS sur le site d’entraide du CMS d’où il en est ressorti :

  1. qu’il était conseillé de n’utiliser qu’une façon d’insérer les images <doc>, qui les insère en ajoutant les données des champs : Titre, Description et Crédits en légende aux images ;
  2. qu’on pouvait tout de même ajouter des images avec un titre (bien pratique pour naviguer dans la médiathèque) sans légende si on ne remplit pas les champs Description et Crédits en utilisant ce code <doc41|left|titre=>, la mention titre= devant être suivie d’une espace insécable que l’on peut faire de plusieurs manières :
    • code html : &nbsp;
    • Unicode : Ctrl + Maj + U suivi de 00a0
    • une façon simple qui ne fonctionne pas dans LinuxFr (soupirs) : ~ suivi d’un espace ;
  3. que ça a motivé l’auteur du squelette SoyezCréateurs à pondre un bout de code qui comprend que, quand on ajoute une image sous la forme <imgNN>, le contenu des champs Titre, Crédits et Description ne doit pas s’afficher.

Sinon, la couverture du guide c’est un arrière-plan en SVG et le texte, ben c’est du texte et rien que du texte (un truc qu’on peut faire avec les styles dans Writer, voyez). Le panache est la queue de l’écureuil du logo de SPIP.

Comment ça s’appelle ?

Le titre : SPIP 4 : vu du côté de la rédaction

Le sous-titre : Un guide pour bien savoir utiliser SPIP pour faire vivre un site.

La couverture

C’est un pdf de 1,3 Mo à télécharger.

Un peu plus sur SPIP

  • # Commentaire supprimĂ©

    Posté par  . Évalué à 1. Dernière modification le 14 mars 2022 à 08:51.

    Ce commentaire a été supprimé par l’équipe de modération.

    • [^] # Re: Version web

      Posté par  (site web personnel, Mastodon) . Évalué à 6.

      Ce n'est pas le même besoin. Il y a des gens qui préfèrent avoir un pdf, voire, qui préfèrent l'imprimer. C'est pour ça, par exemple que le logiciel Garradin propose une version de l'aide en téléchargement. C'est une demande des utilisateurs et des utilisatrices. Soit dit en passant, la version pdf de l'aide de Garradin m'est aussi utile pour voir ce qui a été traité, ce qui ne l'a pas été et ce qui doit êre amélioré.

      En outre, ce guide peut servir de support de formation. Et enfin, ça s'ajoute seulement à la documentation de SPIP mais centré et ramassé sur un seul sujet. Par ailleurs, de toute façon, j'ai aussi écrit quelques tutoriels pour SPIP. Mais c'est important de diversifier les sources et les type d'information. Cela permet de mieux s'adapter aux différents publics.

      « Tak ne veut pas quʼon pense à lui, il veut quʼon pense », Terry Pratchett, Déraillé.

      • [^] # Commentaire supprimĂ©

        Posté par  . Évalué à 2. Dernière modification le 14 mars 2022 à 12:43.

        Ce commentaire a été supprimé par l’équipe de modération.

        • [^] # Re: Version web

          Posté par  (site web personnel, Mastodon) . Évalué à 6. Dernière modification le 14 mars 2022 à 13:31.

          Je n'ai pas dit que ce n'était pas incompatible. J'ai seulement exposé la démarche qui, par ailleurs, au niveau rédactionnel est différente de celle consistant à faire des tutoriels web sur tel ou tel sujet. Ce sont deux façons de faire et de voir différentes. Et aussi, le traitement de texte permet des choses que ne permet pas le html et vice-versa.

          Ensuite, de mon passé de formatrice (et d'apprenante, ce que je suis toujours), j'ai constaté la nécessité de la redondance. Ce qui n'est pas compris sous une forme par certaines personnes, sera mieux compris par sous une autre. D'où une nécessaire diversité.

          Et, oui mon site de tutoriels offrait un moment la possibilité de télécharger le tutoriel en version pdf. Je l'ai virée je ne sais plus pour quelle raison. Mais ce n'est pas du tout la même chose, ni la même démarche, ni ne répond au même besoin.

          « Tak ne veut pas quʼon pense à lui, il veut quʼon pense », Terry Pratchett, Déraillé.

        • [^] # Re: Version web

          Posté par  (site web personnel, Mastodon) . Évalué à 3. Dernière modification le 15 mars 2022 à 23:45.

          SPIP gère ça de la même façon : il faut que le squelette utilisé prévoit une feuille d'impression sinon le navigateur se débrouille avec celle de lecture écran. Par défaut (thème pas terrible/bling-bling mais hyper-fonctionnel) ça le fait bien.
          Sauf que la gestion de la table des matières de l'impression en PDF laisse quand même à désirer…

          Il faut bien entendu faire des adaptations pour certains plugins ; et on a le même souci avec certaines fonctionnalités ou certains thèmes de ReadTheDoc.

          Après, on peut avoir le besoin d'un document imprimé/imprimable (oui, directement du papier distribué aux gens sur place ou un PDF) qui sera différent de l'impression web ; ça correspond souvent à des besoins bien particuliers. Les deux ne sont pas incompatibles, même si idéalement on ne devrait pas démultiplier les efforts.

          “It is seldom that liberty of any kind is lost all at once.” ― David Hume

Suivre le flux des commentaires

Note : les commentaires appartiennent à celles et ceux qui les ont postés. Nous n’en sommes pas responsables.