Sarka-SPIP 1.1.2 - nouveautés

Ceci est une ARCHIVE, peut-être périmée. Vérifiez bien les compatibilités !

Le développement de la version 1.1.2 de sarka-SPIP aura été pour le moins chaotique. Initialement, de légères modifications devaient être apportées à la version 1.1.1. Mais, plutôt que d’être intégrées comme prévu à des versions intermédiaires 1.1.1 a, b, c, ..., l’ensemble des évolutions développées pour répondre à certaines demandes a été intégré, brutalement, à cette nouvelle version.

Quelques fonctionnalités font encore défaut, et certaines parties du code mériteraient d’être optimisées. Cependant, Sarka-SPIP ayant été retenu pour le concours d’habillage proposé par la communauté, il a semblé nécessaire de publier Sarka-SPIP en l’état : la version 1.1.2 constitue ainsi le squelette sur lequel pourront se greffer les styles développés dans le cadre du concours.

Nouvelles fonctionnalités

-  Imprimer les articles

Plusieurs utilisateurs, dés la publication de la première version de Sarka-SPIP, ont exprimé leur souhait de voir une fonction « imprimer l’article » intégrée au squelette. C’est chose faite : les visiteurs peuvent à présent cliquer sur une petite icône en tête d’article pour générer une page dépouillée de toute fioriture pour la passer à la moulinette de leur imprimante.

Lire : http://sarka-spip.com/spip.php?arti...

-  Génération automatique des meta-balises

Dans la version 1.1.1 du squelette, toutes les meta-balises [1] utiles au référencement n’étaient pas renseignées. Les utilisateurs du squelette qui souhaitaient créer des mots-clés ou une description dans l’en-tête des pages html générées par sarka-SPIP devaient modifier manuellement les fichiers du squelette.

Les meta-balises keywords et description sont utilisées par certains moteurs de recherches et annuaires pour indexer les sites internet. Il m’a donc semblé utile de permettre aux utilisateurs du squelette de définir ces éléments depuis l’interface privée de SPIP. Le squelette a été modifié pour leur permettre d’attribuer des valeurs à ces balises en créant un groupe de mots-clés spécifique.

Lire : http://sarka-spip.com/spip.php?arti...

-  Un logo dans le bandeau

La version 1.1.1 de sarka-spip ne permettait pas d’afficher une image dans le bandeau sans modifier le fichier style.css. Une contribution a été publiée pour proposer aux utilisateurs de cette version une méthode permettant d’insérer « en dur » un logo en tête de page : Un logo dans le bandeau....

Il est désormais possible d’imposer l’affichage d’un logo dans le bandeau sans modifier le code, en utilisant les mots-clés. L’idée est la suivante : un mot-clé « spécial » est créé dans l’espace privé, et le logo associée à ce mot clé figurera dans le bandeau. Cette méthode s’inspire largement de la contrib d’Olivier GENDRIN, limiter le nombre de logos, qui permet d’associer un logo à une rubrique sans que les rubriques filles n’en héritent.

Lire : http://sarka-spip.com/spip.php?arti...

-  Affichage des sites dans les rubriques vides

Cette évolution répond à le suggestion publiée par Nathan en réponse à l’article Ils ont adopté Sarka-SPIP :

il m’a semblé que lors de la visite d’une rubrique sans article mais avec des sites référencés syndiqués, il serait possible de mettre en partie centrale la liste des sites et articles référencés

L’objectif de cette évolution est donc d’afficher dans la colonne centrale les sites référencés dans une rubrique, à partir du moment où cette rubrique est vide : pas d’article, pas de rubrique fille.

Ainsi, les utilisateurs du squelette Sarka-SPIP pourront créer une ou plusieurs rubrique(s) entièrement dédiée(s) au référencement de sites web. Cette fonctionnalité déroge à une règle qui prévalait jusqu’à la version 1.1.1 du squelette, selon laquelle les sites référencés n’étaient classés que par secteurs, sans plus de détail. Une telle « dérogation » permet d’assurer une gestion plus fine des sites inscrits.

Lire : http://sarka-spip.com/spip.php?arti...

-  Une page d’erreur 404 en cas de requête invalide

Jusqu’à présent, un visiteur demandant à Sarka-SPIP d’afficher un objet (article, rubrique ou auteur) qui n’existe pas tombait sur horrible page blanche (oh, l’angoisse) mentionnant : « il n’y a pas d’article/d’auteur/de rubrique à cette adresse ».

Prenons le cas du site http://sylvain.bellego.free.fr. Pendant plusieurs mois, ce site a hébergé des dizaines de pages contenant des informations sur les sciences de l’éducation, référencées par les moteurs de recherche. Lorsque les articles et les rubriques contenant ces ressources universitaires ont été supprimées de ce site, pour être hébergés sur un nouveau site, le contenu de ces pages a été « remplacé » par : « il n’y a pas de truc à cette adresse »... contenu indexé par les moteurs de recherche, et résultat déroutant pour les visiteurs « victimes » de l’inertie de ces moteurs.

Il m’a donc semblé utile de remplacer ce type d’avertissement par une page d’erreur 404, dont le titre (title) contient la mention de cette erreur, avec un lien vers le plan du site pour orienter les visiteurs égarés.

Lire : http://sarka-spip.com/spip.php?arti...

-  Un édito en page d’accueil grâce aux mots-clés

Plusieurs utilisateurs de Sarka-SPIP ont modifié le squelette pour afficher un texte spécifique dans la page d’accueil. Il peut s’agir soit d’une description du site, soit d’un article de type éditorial à mettre en valeur.

Le squelette a donc été modifié pour permettre à ceux qui le souhaitent d’imposer l’affichage d’un article en page d’accueil sans modifier le squelette. Cet article doit être associé au mot-clé edito, créé depuis l’espace privé de SPIP, éventuellement dans un groupe de mots.

Le dernier article publié avec le mot-clé edito est alors affiché en tête de la page d’accueil, et pour éviter les redondances il n’est pas « annoncé » dans la liste des articles récents.

Lire : http://sarka-spip.com/spip.php?arti...

Optimisation du code

-  URL absolues dans les fichiers inclus

Dans la version 1.1.1 se Sarka-SPIP, les liens présents dans les fichiers inclus (en-tête, colonne de gauche et colonne de droite) étaient codés en « relatif ». Ainsi, les liens générés dans le menu, pointant vers les rubrique du site, s’écrivaient ainsi :

<a href="rubrique.php3?id_rubrique=6">MaRubrique6</a>

Tant que la page consultée est située à la racine du site, pas de soucis. Le lien désignait :

http://monspip/rubrique.php3?id_rubrique=6.

Imaginons à présent qu’un webmaster souhaite utiliser ces blocs de codes pour intégrer un wiki à son squelette Sarka-SPIP (hypothèse hautement fantaisiste, j’en conviens). Dans ce cas, les pages du wiki seront vraisemblablement consultées depuis le dossier /spikini. Auquel cas, les liens relatifs tels qu’ils sont codés pour sarka-SPIP 1.1.1 pointeraient vers :

http://monspip/spikini/rubrique.php3?id_rubrique=6.

Et comme il n’existe aucune page rubrique dans le dossier /spikini, le visiteur serait dirigé vers une fort peu aimable erreur 404.

Pour permettre à ceux qui le souhaitent (moi le premier) d’intégrer un SpiKini à sarka-SPIP, j’ai donc décidé de coder les liens en absolu.

Lire : http://sarka-spip.com/spip.php?arti...

-  Commentaires dans le feuille de styles

Le fichier style.css de la version 1.1.1 du squelette méritait d’être mieux commentée : c’est chose faite.

Par ailleurs, le mode d’indentation des attributs a été modifiée : initialement créée par une succession d’espaces, cette indentation est à présent créée par uns seule tabulation. Quelques centaines d’octets sont ainsi gagnés (de 33,5 ko à 29,1 ko).

Lire : http://sarka-spip.com/spip.php?arti...

-  Internationalisation du squelette

Dans sa version 1.1.1, Sarka-SPIP était unilingue : de nombreux items étaient codés en dur dans les fichiers html, et les fichiers de langue étaient très peu utilisés. Conséquence : au moins trois utilisateurs du squelette ont eu la mauvaise surprise de constater que le squelette ne s’adaptait pas aux langues choisies dans l’interface privée de SPIP.

Il m’a donc semblé utile de suivre le conseil de ’Xavier’, qui m’a écrit pour me demander s’il était possible de faire évoluer Sarka-Spip vers le multilinguisme.

L’idée était d’utiliser les fichiers de langue proposés par SPIP, et de créer les chaînes de caractères spécifiques à ce squelette dans un fichier « local » de langues. Je vous invite à lire l’article internationaliser les squelettes sur http://spip.net (méthode des fichiers de langue) pour comprendre la façon dont le multilinguisme a été mis en oeuvre sur Sarka-SPIP.

Lire : http://sarka-spip.com/spip.php?arti...

-  Ne pas afficher les mots-clés « spéciaux »

Depuis la publication de la version 1.1.1 de Sarka-SPIP, plusieurs fonctionnalités utilisant les mots-clés ont été intégrées : création d’un logo dans le bandeau, génération automatique de meta-balises, etc.

Il était donc nécessaire d’imposer à la page de navigation par mots-clés de ne pas afficher ces mots-clés, utilisés pour définir les propriétés du squelette, et non pour indexer des objets.

Nous supposons que l’ensemble de ces mots-clés « spéciaux » ont été associés à un ou plusieurs groupes nommés squelette_xxx. Ainsi, le groupe utilisé pour la génération de meta-balises doit être nommé squelette_header et le mot-clé logo-site utilisé pour créer un logo dans le bandeau doit est « rangé » dans le groupe squelette_habillage.

Ainsi, il suffit d’ajouter, dans le fichier mot.html, un filtre interdisant l’affichage de tous les groupes de mots dont le titre commence par squelette_ pour éviter de « parasiter » le menu de navigation par mots-clés avec les mots « spéciaux ».

Lire : http://sarka-spip.com/spip.php?arti...

-  Suppression du filtre reduire_all_images

La version 1.1.1 de Sarka-SPIP utilisait un filtre personnalisé, nommé reduire_all_images, créé dans le fichier mes_fonctions.php3, dans l’objectif de réduire à la volée les images insérées dans le texte des brèves et des articles. Pour en savoir plus sur ce filtre, lire article 89.

Plusieurs utilisateurs ont signalé des erreurs dans la gestion des images. Lire à ce sujet les messages postés en réponse à l’article article 189. Visiblement, ces erreurs étaient produites par le filtre reduire_all_image sur les sites hébergés par OVH.

Plutôt que d’essayer de réparer le filtre, devenu obsolète, il m’a semblé plus simple de le remplacer par le filtre reduire_image qui peut s’appliquer aux balises #TEXTE à partir de la version 1.8.2 de SPIP [1] :

Le filtre |reduire_image est désormais capable de réduire les images à l’intérieur d’un texte, et peut donc être appliqué à la balise #TEXTE.

SPIP 1.8.2

Lire : http://sarka-spip.com/spip.php?arti...

-  Vers un squelette... vraiment « facile à installer » !

Dans le version 1.1.1 du squelette, les adresses url utilisées dans le header étaient codées comme suit (la première pointe vers la feuille de style, la seconde vers l’icône du site) :

<link rel="stylesheet" href="squelette-sarka-spip/styles/style.css" type="text/css">

<link rel="shortcut icon" href="squelette-sarka-spip/rblack.ico">

Smellup, en réponse à l’article article 160, a constaté que la façon dont ces liens étaient codé pouvait être source de problème. A propos d’un bug d’affichage observé sur son site, il indique :

C’était juste un souci de nom de dossier car j’avais renommé le dossier squelette-spip-sarka en squelette tout court pour faire mes propres modifications, mis à jour la variable $dossier_squelettes dans mes_fonctions.php3 mais pas modifiés les chemins de la feuille de style dans tous les fichiers html !!!

Cela me parait dommage de ne pas véritablement pouvoir modifier l’indirection vers le dossier squelette qu’une fois dans mes_fonctions.php3.

La documentation de SPIP 1.8.2 indique en effet qu’il est possible, depuis la version 1.8.2, d’utiliser la variable #DOSSIER_SQUELETTE pour coder « dynamiquement » des liens. Dans leur contribution comment faire un squelette facile à installer, James et l’équipe de SPIP-Contrib recommandent d’utiliser cette balise dans les liens vers la feuille de style : l’intérêt est de pouvoir créer un nouveau dossier pour le squelette en ne modifiant que le fichier mes_fonctions.php3 (ou mes_options.php3).

Lire : http://sarka-spip.com/spip.php?arti...

Organisation des fichiers

-  Un dossier pour les inclusions

Dans sa version 1.1.1, le squelette Sarka-SPIP comprenait un dossier nommé « squelette-sarka-spip », à la racine duquel étaient rangés tous les fichiers html et php3 (à l’exception de ceux qui doivent impérativement se trouver à la racine du SPIP).

La modification détaillée ici ne change strictement rien au « rendu » du squelette, mais elle en améliore la souplesse et la lisibilité : les fichiers html et php3 inclus dans les pages principales (article, rubrique, sommaire, etc.) grâce à la balise < INCLURE > ont été regroupés dans un dossier nommé inclusions. Je me suis inspiré de l’arborescence des fichiers créés par Vincent Robert pour l’excellent squelette Blip.

Ainsi, celui qui souhaite modifier le squelette pourra identifier plus rapidement les fichiers « primaires », correspondant chacun à une page, et les fichiers « secondaires », qui ne comprennent que des morceaux de page modulables.

Lire : http://sarka-spip.com/spip.php?arti...

Pagination

-  Alignement des liens « lire la suite de l’article » à droite

Dans la version 1.1.1 de sarka-SPIP, les liens intitulés « lire la suite de l’article », permettant au visiteur de passer de l’annonce de l’article à l’article intégral, était aligné à gauche.

T. Stouki a choisi de modifier l’affichage de ces liens, pour les aligner à droite : http://webpublic.ac-dijon.fr/pedago.... Cette position est mieux adaptée, pour reprendre ses propres termes, « pour aller vers la suite ».

Culturellement conditionnés pour associer une progression à un déplacement linéaire, de la gauche vers la droite, nous nous représentons la position d’un élément sur une page comme une incitation à progresser ou à régresser : un lien positionné à gauche est associé à un retour en arrière ; un lien positionné à droite est associé à un progès [2].

Lire : http://sarka-spip.com/spip.php?arti...

-  Ne pas afficher les documents et les images en doublon

Dans la version 1.1.1 de Sarka-SPIP, les documents et les images insérés dans le texte d’un article ou d’une rubrique étaient affichés dans les blocs documents joints et images jointes. Un message de LaGazzelleN sur la liste de diffusion de SPIP m’a motivé à « corriger » cela (bien qu’il s’agisse plus d’un défaut de conception que d’une erreur) :

j’écris un article concis sur l’histoire de la ville.
et je rajoute une photo. J’aimerais qu’en cliquant sur la photo, cela télécharge un pdf qui est un texte plus détaillé de l’histoire de la ville. Ca je sais faire. Mais j’aimerais que le pdf en question n’apparaisse pas en bas dans « documents joints à cet article »

lire le message de LaGazelleN

Le critère doublon a donc été ajouté aux boucles DOCUMENTS utilisées dans le squelette. Pour en savoir plus, lire la documentation de SPIP sur la boucle DOCUMENTS.

Lire : http://sarka-spip.com/spip.php?arti...

-  Refonte de la feuille de style

Dans sa version 1.1.1, Sarka-SPIP posait des problèmes d’affichage sous Internet Explorer - windows. La feuille de style a été modifiée, notamment pour permettre un affichage correcte en 800x600. Les modifications apportées au fichier style.css ont également impliqué quelques modifications (mineures) des fichiers html.

Lire : http://sarka-spip.com/spip.php?arti...

Notes

[1Sarka-SPIP ne sera donc plus compatible avec les version antérieures à 1.8.2 de SPIP

[2notons qu’en politique, ce référentiel culturel s’inverse...

Discussion

Aucune discussion

Ajouter un commentaire

Avant de faire part d’un problème sur un plugin X, merci de lire ce qui suit :

  • Désactiver tous les plugins que vous ne voulez pas tester afin de vous assurer que le bug vient bien du plugin X. Cela vous évitera d’écrire sur le forum d’une contribution qui n’est finalement pas en cause.
  • Cherchez et notez les numéros de version de tout ce qui est en place au moment du test :
    • version de SPIP, en bas de la partie privée
    • version du plugin testé et des éventuels plugins nécessités
    • version de PHP (exec=info en partie privée)
    • version de MySQL / SQLite
  • Si votre problème concerne la partie publique de votre site, donnez une URL où le bug est visible, pour que les gens puissent voir par eux-mêmes.
  • En cas de page blanche, merci d’activer l’affichage des erreurs, et d’indiquer ensuite l’erreur qui apparaît.

Merci d’avance pour les personnes qui vous aideront !

Par ailleurs, n’oubliez pas que les contributeurs et contributrices ont une vie en dehors de SPIP.

Qui êtes-vous ?
[Se connecter]

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici

Ce champ accepte les raccourcis SPIP {{gras}} {italique} -*liste [texte->url] <quote> <code> et le code HTML <q> <del> <ins>. Pour créer des paragraphes, laissez simplement des lignes vides.

Ajouter un document

Suivre les commentaires : RSS 2.0 | Atom