SPIP - français, ces 365 derniers jours

SPIP est un système de publication pour l’Internet qui s’attache particulièrement au fonctionnement collectif, au multilinguisme et à la facilité (…)



mardi 2 janvier 2024

  • Fusionner, associer et dissocier des mots-clés

    Lorsqu'on utilise des mots-clés leur liste a tendance à grossir au fil du temps et il peut être intéressant de faire le ménage.

    À partir de SPIP 4.0, il est possible pour les administrateur-trices de fusionner, associer et dissocier des mots-clés. Cela permet de réduire leur nombre en conservant les liens existants.

    Avertissement : certaines de ces actions ne sont pas réversibles, il convient donc de les utiliser avec prudence.

    - Dans la partie privée, aller sur la page du mot-clé à fusionner
    - En bas de page, cliquer sur le lien "Admin. avancée"


    - Un formulaire qui permet d'associer, fusionner, dissocier les mots-clés s'affiche


    - Comme certaines de ces opération sont irréversibles, une demande de confirmation est affichée avant de lancer l'action :


lundi 4 décembre 2023

  • Utiliser les plugins

    Qu'est ce qu'un plugin ?

    SPIP est fourni avec un nombre de fonctionnalités standard (le noyau ou "core").

    Il arrive souvent qu'on ait besoin d'autres fonctionnalités comme par exemple un agenda, une newsletter .... Pour répondre à ces besoins particuliers, SPIP dispose d'un système de plugins (parfois appelé "extensions") à travers une API normalisée qui permet de se brancher ("plug" en anglais) au système pour y ajouter ou compléter des fonctions.

    Organisation de plugins

    Il existe deux types de plugins :

    - Les plugins fournis par défaut dans SPIP
    Ils sont placés dans le répertoire réservé ./plugins-dist/. Ces "plugins-dist" sont verrouillés et il n'est pas possible de les désinstaller. Ils sont mis à jour lors de chaque mise à jour de SPIP.

    - Les plugins spécifiques au site
    Ils sont placés dans le répertoire ./plugins/
    Si vous souhaitez pouvoir les installer et mettre à jour automatiquement, il faudra créer un sous-répertoire ./plugins/auto/. (Ce sous-répertoire est automatiquement créé si vous installez SPIP via le spip-loader)

    Utiliser SVP le gestionnaire des plugins de SPIP

    SPIP dispose d'un système automatisé pour gérer les plugins qui s'appelle SVP (acronyme de "SerVeur d'information et de téléchargement des Plugins").

    Il permet de gérer et de mettre à jour au quotidien les plugins.

    La gestion des plugins est réservée aux administrateurs-trices complet-es du site.
    L'ajout, la mise à jour et suppression des plugins sont restreints aux webmestres.

    Gérer les dépôts

    SVP va chercher les plugins disponibles dans un "dépôt".
    Lors de la première installation le webmestre doit installer le dépôt et valider avec son mot de passe.

    Par défaut le dépôt "principal" "SPIP-Zone - Plugins" est proposé.

    Il est possible d'ajouter d'autres dépôts.
    Certains dépôts sont listés sur https://plugins.spip.net/spip.php?page=depots

    Pour des raisons de sécurité, il est nécessaire de saisir son mot de passe pour installer un nouveau dépôt.

    Chercher et trouver le plugin

    Il est possible de rechercher le plugin via l'interface de SVP, "ajouter un plugin"
    Il est peut être utile de rechercher le plugin adapté à votre besoin sur le site dédié aux plugins SPIP : https://plugins.spip.net/

    Ajouter un plugin

    Lorsque vous avez trouvé votre plugin, vous le sélectionnez et demandez son installation "télécharger et installer" ; SVP va alors proposer d'installer le plugin avec toutes les dépendances nécessaires à son fonctionnement.

    Une fois installés certains plugins proposent un bouton "Configurer" qui permet d'ouvrir un formulaire de configuration.

    Mettre à jour un plugin

    Un plugin comporte un numéro de version sous la forme x.y.z où

    • z représente une correction mineure,
    • y représente un ajout de fonctionnalités,
    • x représente un changement majeur présentant des risques d'incompatibilité.

    Lorsqu'une mise à jour est disponible (et que l'installation a été faite par SVP) une information s'affiche :

    • Une mise à jour corrective est disponible (up de z)
    • Une mise à jour fonctionnelle est disponible (up de y)
    • Une mise à jour majeure est disponible (X.0.0). Pensez à vérifier les incompatibilités. (up de x)

    Désactiver, Désinstaller et/ou Supprimer

    Les webmestres ont plusieurs options pour retirer un plugin installé :

    • Désactiver : le plugin passe dans les plugins inactifs,
    • Désinstaller : supprime les données et les paramètres de configuration du plugin, le plugin passe dans les plugins inactifs,

    Lorsque le plugin est inactif il est maintenant possible de le :

    • Supprimer : supprime les fichiers du plugins, pas les données ;
    • Réactiver : si le plugin a été désactivé (et non désinstallé) on retrouvera toutes les données et les paramètres.

    NB :
    - Par conséquent, pour retirer complètement un plugin et ses données, il faut d'abord le désinstaller, puis le supprimer.
    - Attention, ne pas oublier que désinstaller entraîne une perte de données

    Méthodes alternatives pour gérer les plugins

    Ajouter un plugin manuellement via l'interface SVP

    Il est possible d'installer un plugin manuellement via l'interface SVP, avec par exemple une version de zip récupérée sur git.spip.net.
    Pour des raisons de sécurité il est nécessaire de saisir son mot de passe webmestre lors de toute installation de plugin de cette manière.

    Gestion des plugins par FTP

    On peut déposer les plugins avec transférant par FTP les fichiers des plugins dans le répertoire ./plugins/. Une fois déposé, il faudra activer les plugins via SVP.

    Attention, cette méthode ne permet pas de mettre à jour automatiquement les plugins.

    Gestion des plugins par SPIP-Cli

    SPIP-Cli permet de gérer un site en ligne de commande. Il existe plusieurs commandes dédiées à la gestion des plugins. Pour en savoir plus se reporter à la documentation officielle de SPIP-Cli
    https://contrib.spip.net/SPIP-Cli

    Créer son plugin

    Si vous ne trouvez le plugin correspondant à vos besoins, il est toujours possible de le créer !

    Pour apprendre à coder, vos propres plugins :
    https://programmer.spip.net/-Developper-des-plugins-

    A noter : le plugin La fabrique permet de créer d'une façon simple et rapide un plugin à partir de zéro
    https://contrib.spip.net/La-Fabrique


mercredi 22 novembre 2023

  • #ID_LOGO_XXX

    Syntaxe

    Le type d'objet est spécifié dans le nom de la balise, tel que #ID_LOGO_ARTICLE ou #ID_LOGO_SITE.

    Pour les articles, ces balises ont quelques variantes :

    • La balise peut aussi demander explicitement le logo normal ou de survol, avec #ID_LOGO_ARTICLE_NORMAL ou #ID_LOGO_ARTICLE_SURVOL.
    • On peut demander un logo de rubrique en absence de logo sur l'article demandé avec #ID_LOGO_ARTICLE_RUBRIQUE

    Usage pour récupérer les informations du logo

    Une fois l'identifiant du logo récupéré, une boucle DOCUMENTS peut être utilisée, entre autres, pour récupérer le titre et le descriptif du logo (attention, il faut le modificateur {tout}, sinon, la boucle ne retourne rien) :

    Exemple :

     #TITRE, #DESCRIPTIF 

    Attention, piège avec #INFO_TITRE

    #INFO_TITRE{document, #ID_LOGO_ARTICLE} renvoie le titre du document si renseigné, sinon le nom du fichier [1].

    À lire aussi


    [1] C'est donc pour cela qu'une boucle sera plus précise


lundi 25 septembre 2023

  • Internationaliser les squelettes

    SPIP affiche naturellement les éléments d'interface (dates, intitulés des boutons) dans la langue choisie par l'utilisateur.

    Créer des squelettes multilingues

    Lorsqu'on crée un squelette multilingue, il est indispensable d'utiliser les chaînes de langue pour que le contenu de l'interface soit affiché dans la langue demandée.

    SPIP fournit déjà les intitulés les plus courants (comme "Plan du site", "Répondre à cet article" etc...).
    Cet article indique comment en ajouter des nouveaux selon vos besoins.

    De plus, utiliser les chaînes de langue améliore la maintenance de votre squelette (quand on modifie une chaîne de langue, toutes les pages sont modifiées)

    Utiliser des fichiers de langue

    Créer un fichier de langue
    Quelque soit la structure décidée pour le site (secteurs de langue ou pas) il suffit d'insérer une "chaîne de langue" comme ceci <:chaine_de_langue:> SPIP ira chercher la traduction dans un des fichiers SPIP ou dans un fichier lang/local_xx.php (xx étant la langue) que l'on aura créé.

    Le suffixe langue xx est celui généralement usité dans les normes ISO.
    Par exemple fr pour français

    On supporte aussi les variantes régionales :
    Par exemple pt_br pour le portugais brésilien

    Par exemple, on fait afficher une section musique dans notre site

    Musique

    Pour internationaliser, on passera le texte dans une chaine de langue

    <:musique:>

    Selon la langue retenue, la chaine <:musique:> sera affichée
    — en français, à la chaîne « Musique »,
    — en anglais, à la chaîne « Music »,
    — en japonais, à la chaîne « 音楽 »,

    Il faut donc créer autant que fichiers de langue que les langues utilisées par votre site.
    Dans le cas précédent il faut donc créer un lang/local_fr.php, lang/local_en.php et lang/local_ja.php

    La structure d'un fichier de langue

    Un fichier de langue est rangé dans un répertoire lang
    Il est structuré de la façon suivante :
    Les fichiers de langue contiennent les différentes traductions des codes que vous utiliserez ; ce sont des fichiers PHP contenant chacun un tableau associant aux codes les chaînes correspondantes dans chaque langue.

    Attention :
    Le nom de ces fichiers de langue ne devra pas contenir le caractère « _ » (« underscore » ou « tiret-bas ») sauf pour marquer la séparation avec l'initiale de la langue (en, fr, it,...). Par exemple, on créera « monperso_fr.php » et non « mon_perso_fr.php ».

    Ces fichiers contiendront par exemple :

    Version française (lang/monperso_fr.php) :

     <?php $GLOBALS[$GLOBALS['idx_lang']] = array( 'telechargement' => 'Télécharger la dernière version', 'quoideneuf' => 'Modifications récentes' ); 

    Version catalane (lang/monperso_ca.php) :

     <?php $GLOBALS[$GLOBALS['idx_lang']] = array( 'telechargement' => 'Descarregar la darrera versió', 'quoideneuf' => 'Modificacions recents' ); 

    Syntaxe des fichiers de langue
    - Chaque ligne de définition se termine par une virgule, sauf la dernière ligne.
    - Les apostrophes à l'intérieur de la chaîne doivent être échappées, c'est-à-dire précédées d'un antislash. Par exemple, la chaîne « sur l'internet » doit être écrite : sur l\'internet.
    - Il est possible de ne pas échapper les apostrophes à condition d'utiliser des apostrophes du type "guillemet simple fermant" '

    Créer ses propres codes

    Il est de plus possible de créer ses propres codes, correspondant à des chaînes que l'on désire ajouter soi-même.
    Il s'agit alors de créer des fichiers de langue personnels, sur le modèle des fichiers public_xx.php. Pour créer ses propres fichiers, on installera, dans un répertoire squelettes/lang (à créer le cas échéant)
    — local_fr.php pour définir les chaînes en français,
    — local_en.php en anglais,
    — ...

    La partie qu'il faut enrichir soit-même consiste en plusieurs lignes de définitions, sur le modèle :

     'code' => 'La chaîne à afficher', 

    Les plugins et les fichiers de langue

    Beaucoup de fonctionnalités sont assurées par des plugins, soit des plugins du core comme porte-plume ou svp, soit des plugins ajoutés par les webmestres parce qu'ils souhaitent utiliser une fonctionnalité spécifique. Tous ces plugins ont des fichiers de langue.

    Voir aussi

    Pour tout savoir sur les chaines de langue on pourra consulter https://programmer.spip.net/-Elements-linguistiques-

    Historique :

    les versions initiales de cet article présentaient d'autres solutions que les fichiers de langue pour rendre les squelettes multilingues. Notons simplement ici que ces solutions ne sont pas recommandées :
    - "un squelette par langue" (nécessitait le plugin "squelettes_par_rubrique") : c'est lourd à maintenir et simplement inutile pour un usage basique.
    - "les blocs multilingues" : ces blocs sont très utiles dans la partie rédactionnelle ; présenter un titre en différentes langues possibles, permettre d'afficher des légendes différentes par langue... mais à éviter dans la partie structure


mardi 15 août 2023

  • Installation de SPIP

    Vous trouverez ci-dessous différentes méthodes d'installation de SPIP, classées des plus faciles pour le plus grand public aux plus spécialisées.

    Préalables

    Avant d'installer SPIP, il faut s'assurer que votre hébergement remplit les conditions requises (voir Configuration requise).

    Méthodes grand public

    Préparation

    Il vous faut :

    • les identifiants pour accéder à l'hébergement (sFTP) et à la base de données (mySQL ou MariaDb) ;
    • un logiciel de transfert de fichiers sFTP [1].

    Méthode 1 : Avec spip_loader.php, alias « la voie de la tranquillité »

    Le script spip_loader.php télécharge et installe la version de SPIP souhaitée. C'est la méthode la plus simple pour installer SPIP :

    1. se rendre sur la page Utiliser spip_loader ;
    2. télécharger le script sur votre ordinateur ;
    3. le téléverser avec votre logiciel FTP à l'emplacement souhaité chez votre hébergeur ;
      Attention : paramétrez votre logiciel pour faire ce transfert en mode binaire [2].
    4. il ne vous reste plus qu'à vous rendre à l'adresse www.domaine.tld/spip_loader.php et à suivre les différentes étapes de la procédure d'installation.

    Méthode 2 : Téléversement par sFTP, « alias à l'ancienne »

    Après avoir téléchargé le zip via la page Télécharger SPIP et extrait son contenu sur votre ordinateur, transférez l'ensemble des fichiers sur votre serveur avec un logiciel FTP. Une fois les fichiers transférés, suivez les différentes étapes de la procédure d'installation.

    Note : si vous souhaitez utiliser l'installation automatique des plugins depuis l'interface privée de SPIP, il vous faut également créer manuellement les dossiers /plugins et /plugins/auto et éventuellement lib (pour certains plugins qui le requièrent).

    Dans tous les cas : finaliser l'installation

    Rendez-vous sur l'adresse www.domaine.tld/ecrire puis suivez les différentes étapes de la procédure d'installation :

    1. Choisissez la langue d'installation.
    2. Indiquez le type de base de données et les informations nécessaires.
    3. Choisissez votre base ou créez-en une nouvelle.
    4. Créez votre accès personnalisé au site en indiquant votre nom, adresse email, login et mot de passe.
    5. Finalisez l'installation en accédant à l'espace privé

    Autres méthodes, alias « pour aller plus loin »

    SPIP-Cli (installation via ligne de commandes)

    Une fois SPIP-Cli installé sur votre serveur (lire la documentation de SPIP-CLI), vous pouvez utiliser la commande spip pour installer, installer, mettre à jour et administrer SPIP.

    Pour télécharger la dernière version stable de SPIP, lancer la commande suivante depuis le répertoire voulu pour votre site :

    spip dl

    Ensuite, se positionner dans le dossier contenant votre SPIP et préparer les dossier et fichiers (droits des dossiers, mise en place du .htaccess...) :

    spip core:preparer

    Ensuite, suivez la méthode classique d'installation (voir paragraphe Installer SPIP ci-dessus).

    Pour mettre à jour, l'idéal est de commencer par mettre à jour SPIP-Cli, puis lancer la commande :

    spip up

    Plus d'infos sur SPIP-Cli :

    Le script checkout

    Le script checkoutpermet de télécharger ou mettre à jour des sources Git (ou Zip) et propose également une méthode pour télécharger les sources de SPIP.

    Méthodes alternatives

    Distributions Linux

    Debian

    Arch Linux

    Un paquet est disponible sur le dépôt utilisateur.

    Vagrant

    Si vous connaissez Vagrant, Ce projet vous intéressera.

    Docker

    Docker_(logiciel) automatise le déploiement d'applications dans des conteneurs logiciels.

    Plusieurs personnes ont imaginé leurs propres recettes pour utiliser cet outil :

    Softaculous

    Softaculous installe automatiquement des applications en ligne de commande ou à travers les panneaux de contrôle comme cPanel ou Plesk.

    Dans sa version gratuite il offre 50 applications mais SPIP fait partie de sa version payante :

    - https://www.softaculous.com/news/tag/spip

    Composer

    Composer est un outil de gestion de dépendances en PHP. Il vous permet de déclarer les bibliothèques dont votre projet dépend et il va les gérer (installer / mettre à jour) pour vous.


    [1] Nous vous conseillons d'utiliser Filezilla.

    [2] Dans Filezilla : menu Transfert > Type de transfert choisir Binaire.


mercredi 26 juillet 2023

  • Tenir un CHANGELOG

    Les fichiers de CHANGELOG suivent la norme Tenez un Changelog.

    Qu'est-ce qu'un changelog ?

    Un changelog (journal des modifications) est un fichier qui contient une liste triée antéchronologiquement des changements notables pour chaque version d'un projet.

    Pourquoi tenir un changelog ?

    Pour permettre aux utilisateurs et contributeurs de voir précisément quels changements notables ont été faits entre chaque publication (ou version) d'un projet.

    Plus de détails sur https://keepachangelog.com.

    Chaque entrée du changelog doit :

    • référencer le ticket (ou la PR s'il n'y a pas de ticket correspondant) ;
    • décrire clairement et de manière concise les modifications apportées par la PR ;

    Pour chaque version, indiquer le numéro de version suivi de la date au format ANNÉE-MOIS-JOUR.

    Les entrées sont regroupés par catégorie. Voici les catégories utilisées dans SPIP.

    Type d'entréeSignification
    Added Pour les nouvelles fonctionnalités
    Changed Pour les changements aux fonctionnalités préexistantes
    Deprecated Pour les fonctionnalités qui seront bientôt supprimées
    Removed Pour les fonctionnalités désormais supprimées
    Fixed Pour les corrections de bugs
    Security En cas de vulnérabilités

    Exemple de Changelog simple

    # Changelog ## 1.0.2 - 2023-07-25 ## Fixed - Ne pas afficher le texte du modèle `icone` et le mettre en `title` du lien ### Changed - mise à jour du README.md maintenant que la doc est sur contrib ## 1.0.1 - 2023-06-22 ### Added - ajout d'un CHANGELOG.md ### Changed - compatibilité SPIP 4.1+ - mise à jour de la documentation dans le README.md 

    Exemple de changelog complet

    Pour un exemple plus complet, voir celui de SPIP.


  • Écrire un message de commit

    Les messages des commits dans SPIP suivent la nomenclature des Commits Conventionnels. Ceci facilite la relecture a posteriori de l'historique du code, ainsi que l'analyse des PR.

    Le corps du message doit être clair et explicatif : décrire le problème traité et les évolutions ou corrections apportées.

    Structure d'un commit conventionnel

    1. Première ligne commençant par le type de commit, suivi de deux points (:), suivi d'un message résumant le commit.
    2. Le type peut éventuellement être complété par un scope entre parenthèses afin de préciser le composant ou la fonctionnalité modifiée.
    3. Optionnellement, on peut ajouter, après une ligne vide, un ou plusieurs paragraphes complémentaires décrivant plus en détail le commit. La syntaxe Markdown peut être utilisée.
    4. Enfin, une dernière ligne (séparée des précédentes par une ligne vide) doit contenir une référence au ticket auquel est lié le commit. La référence prend la forme suivant Refs: #XXX, ou Fix: #XXX pour fermer le ticket automatiquement lors de l'arrivé dans la branche main ou master.

    Exemple de commit conventionnel

    Exemple de log de commit complet :

    fix: réparer le lien vers la licence GPL dans le pied des pages du privé en le remplaçant par un simple lien vers le site officiel gnu.org Fix: #5328 

    Liste des types de commit

    TypeSignification
    build Modifie un script de compilation du programme ou modifie des dépendances externes. Indique également une montée en version.
    change Modifie l'implémentation d'une fonctionnalité — peut modifier des signatures de fonctions (≠ refactor)
    chore Travail de fond n'altérant pas le code (sortir une version, regénérer du code compilé)
    ci Relatif à l'intégration continue
    deprecate Déprécier (sans l'enlever) une fonctionnalité
    docs Relatif à la documentation (docs, readme, changelog)
    feat Ajoute une fonctionnalité
    fix Corrige un problème
    i18n Relatif aux traductions et chaînes de langue
    perf Améliore la performance d'algorithme ou du programme
    refactor Réécriture de code, sans en modifier l'implémentation
    remove Suppression de code ou de fonctionnalité (déprécié auparavant)
    revert Annule une modification précédente (commit)
    security Relatif à la sécurité
    style Relatif aux règles d'écriture du code (Coding Standard)
    test Relatifs aux tests du logiciel

    Pour aller plus loin

    Se référer au site www.conventionnalecommits.


mardi 18 juillet 2023

  • |typo

    Ce filtre effectue un traitement pour que les textes affichés suivent les règles de typographie. Il fait une protection préalable des balises HTML et SPIP et transforme les balises .

    Ce filtre est appliqué par défaut par SPIP sur les champs de texte.

    Voir aussi Des filtres


  • |propre

    Ce filtre est appliqué par défaut par SPIP aux textes longs (#TEXTE, #CHAPO, #PS, ...)

    Il applique à un texte les traitements typographiques et les raccourcis SPIP (italiques, gras, intertitres, etc.).

    Voir aussi Des filtres


Traduction

Publications

Derniers articles publiés

Sites favoris


131 sites référencés au total

Brèves

30 mai 2014 - Sur Facebook : Lac de Créteil - 94000 - Val de Marne -…

Lac de Créteil - 94000 - Val de Marne - France

24 février 2014 - Nous contacter

Pour nous contacter, cliquez sur l’enveloppe.http://laccreteil.fr/spip.php?page=…