Carnet Wiki

Vers DOC SPIP3.3

Version 7 — Mars 2021 JLuc

-  liste des nouveautés :

-  Incompatibilités ? En établir la liste

-  réécrire : https://www.spip.net/fr_article5627.html car la moitié de plus valable en 3.3. Du coup voir comment présenter ça.

Doc balise_img à reporter

Compléter 1 ) compléter la remarque qui dit que ça ne s’applique aux SVG par l’indication Pour les versions de SPIP antérieures à SPIP 3.3 et ajouter tout ce qui suit  :

2 ) ajouter tout ce qui suit  :
À partir de SPIP 3.3, |balise_img peut s’appliquer aux fichiers .svg et accepte des paramètres supplémentaires.

|balise_img est survitamine :

1 ) -# il peut prendre en premier argument argumenr une balise img déjà deja formée si besoin (par exemple issue d’un filtre image) : [(#FICHIER|image_reduire{200,200}|balise_img{'un nuage','spip_logo'})]

2 ) -# il accepte un dernier argument size pour forcer la taille. sous plusieurs formes  : Cet argument peut prendre plusieurs formes :

-  x1.5, x2 ou x3 permet de forcer une densité de 1.5, 2 ou 3 (le x est ici le multiplicateur de densité par rapport a la taille initiale). Une image de largeur 200px affichée avec un x2 aura donc un attribut width='100'.

-  Un nombre seul comme 64 pour forcer une image carrée avec width='64' height='64'

-  Une largeur ET une hauteur sour la forme 1024x640 pour avoir un width='1024' height='640'

-  Une largeur seule et une hauteur automatique sous la forme 1024x* pour avoir donc un width='1024' et un height ajusté automatiquement pour respecter les proportions initiales de l’image.

Pour faciliter l’utilisation du filtre, l’argument de taille (optionnel) arrive toujours en dernier, même si on ne precise pas de alt ou de class :

[(#FICHIER|balise_img{1024x640})]
[(#FICHIER|balise_img{'un nuage',1024x640})]
[(#FICHIER|balise_img{'un nuage','spip_logo',1024x640})]

Mais si jamais le alt ou la class sont ambigu et peuvent être interpretés comme une taille, il suffit d’indiquer une taille vide pour lever l’ambiguité :
[(#FICHIER|balise_img{'un nuage','x2',''})]

Le filtre peut donc ainsi facilement être utilisé pour ajuster l’affichage d’image en x2 ou x3 pour prendre en compte les écrans rétina : [(#FICHIER|image_reduire{400,400}|balise_img{'Mon image HD',x2})]

Remarques Exemples d’usage

- L’emploi d’un paramètre x2 pour la densité de l’image force, quoiqu’il arrive, une double taille même si l’écran n’est pas HD. Ça ne remplace donc pas les plugins spécialisés qui gèrent ça (adaptive_image et image_responsive par ex), mais ça les complète pour gérer par exemple des petites images de décoration ou des pictogrammes png : il suffit de fournir le pictogramme en 64px et on l’affiche en 32px pour qu’il soit de bonne qualité partout.

- Pour les images SVG, ce filtre permet de contrôler la taille d’affichage indépendamment de la taille par défaut inscrite dans le fichier.

Chantiers pas DOC

Certains chantiers sont en cours doivent être finis et d’autres reportés à une version ultérieure.
-  API declarer_parents

Faciliter les releases

Marcimat a créé un ticket sur un truc pas trop compliqué à faire qui faciliterait les releases : améliorer le script qui genère (les ZIPs ?) des branches. Ticket : https://gitlab.com/magraine/spip-releases/-/issues/1