Vader[FR] : ce n'est pas un blog, c'est un Sith

Cloner un site SPIP

Vader[FR] — 2015-09-11T16:39:38Z

Pour copier un site SPIP d'un serveur à un autre, il suffit de suivre une procédure assez simple.

Les deux sites doivent avoir la même version de SPIP.

1) sauvegarder la base SPIP

Menu Maintenance, Sauvegarder la base.
Effectuer une sauvegarde en cochant "Sauvegarder toutes les tables".

Cette option vous permet de sauvegarder le contenu de la base dans un fichier qui sera stocké dans le répertoire tmp/dump/.
N'oubliez pas également de récupérer l'intégralité du répertoire IMG/, qui contient les images et les documents utilisés dans les articles et les rubriques.

2) Copier les fichiers

Copier les fichiers du site, à minima tmp/dump et IMG , via SCP, Rsync, FTP... du serveur "nominal" au serveur "copie".

3) Configuration de la base de données

ne faire que lors de la première copie
Il faut créer sur le serveur "copie" l'utilisateur SQL avec les mêmes identifiants et droits que sur le serveur "nominal", afin de ne pas avoir à modifier le fichier de configuration de SPIP.

4) Installation de SPIP pour connexion à la base de données

ne faire que lors de la première copie

Installer le site SPIP en indiquant selon le cas sur le serveur "nominal" :

les identifiants accéder à la base de données
le nom de la base et des tables
authentification avec LDAP ou non

5) Restaurer la base SPIP

Dans l'interface privée de SPIP du site copié, aller dans le menu Maintenance, Restaurer la base.

Effectuer une restauration en choisissant le fichier créé à l'étape 1, lequel a été copié à l'étape 2 avec tmp/dump.
De même, restaurer toutes les tables et valider aux différents messages de confirmation.

Cette option vous permet de restaurer une sauvegarde précédemment effectuée de la base. À cet effet, le fichier contenant la sauvegarde doit avoir été placé dans le répertoire tmp/dump/

Tuto Spip - Lutter contre le SPAM avec le plugin couteau suisse

Vader[FR] — 2015-05-18T15:49:50Z

Principes de base

Laisser la possibilité aux visiteurs de réagir aux articles, apporter ou demander des précisions, souligner leur qualité, voire même critiquer de manière constructive pour permettre d'améliorer les articles futurs, est utile aux webmestres et rédacteurs, mais il y a un problème auquel tôt ou tard tous sont confrontés : le spam.

En effet, des anonymes viennent essayer de pourrir le site web en y postant de la pub pour leur site web, quand ce n'est pas pour du viagra ou des services d'escort.

Il y a deux fonctions à combiner dans Spip afin de lutter contre le spam :

la première est une action de prévention, qui consiste à ne pas publier directement les messages sans l'aval d'un administrateur. Exactement comme pour les articles.
la seconde est un filtre anti-spam qui ne laissera pas les spammeurs écrire ce qu'ils veulent, le message ne sera donc même pas proposé. Ce filtre anti-spam est fourni par le méta-plugin Couteau Suisse.
- les messages de l'administrateur pourront être validés directement en utilisant l'outil "Modération modérée", un outil de type "Administration" du Couteau Suisse.

voir aussi

Prévention

Menu Configuration -> Forum,

dans le cadre "Mode de fonctionnement par défaut des forums publics", choisir "Modération a priori (les contributions ne s'affichent publiquement qu'après validation par les administrateurs)."
dans le cadre "Forum", juste en dessous, ne pas activer les liens hypertexte et ne rien indiquer comme extension de document autorisé, ce qui, de fait, interdit aux visiteurs anonymes de joindre des documents.

Ne pas oublier d'enregistrer les modifications en cliquant sur le(s) bouton(s).

Répression

Le méta-plugin "couteau suisse" dispose d'un outil de lutte contre le Spam.

Une fois le plugin couteau suisse installé, aller dans le menu configuration -> Le Couteau Suisse puis Outils actifs/inactifs et Sécurité.
Il pourra être utile d'activer également l'outil "Taille des forums".

Il faudra donc lister les séquences interdites dans le cadre texte du même nom [1], typiquement les adresses des site web dont les spammeurs veulent faire la promotion.
Les http://, https://, www et "/" final peuvent être enlevés pour plus d'efficacité.

Pour ce faire, il suffira de regarder les messages de forum supprimés, et copier/coller le lien en ne gardant que la racine du site web. Par exemple, http://www.airportescorts.com.au/scarpe/shop-shoes.html deviendra http://www.airportescorts.com.au/, avant d'être à nouveau épuré à l'étape suivante et devenir finalement airportescorts.com.au.

Organisation

Cette procédure sert pour du traitement "de masse", et ne serait, à priori, pas d'une grande utilité pour mettre à jour une adresse unique d'un site spammeur [2].

Afin d'organiser la liste et de s'y retrouver, il est possible de suivre la méthode suivante :

Sous Linux (ou Windows avec Notepad++), copier les liens dans un fichier texte (Gedit, Kwrite...)
puis effacer les / finaux ainsi que les http:// avec la fonction "rechercher et remplacer" (par défaut CTRL+H [3])
les espaces entre chaînes seront par la même fonction remplacés par des retour à la ligne, habituellement codés \n
le fichier sera ensuite trié par ordre alphabétique, ce qui permettra de repérer les doublons. Sous Linux, la commande sort s'en chargera : sort fichier > fichier_trie
une fois le fichier trié, remplacer les retours à la ligne \n par des espaces pour avoir une liste au même format qu'au début.
puis recopier la liste organisée dans le cadre des séquences interdites du Couteau Suisse.

Modération Modérée

Une fois le plugin couteau suisse installé, aller dans le menu configuration -> Le Couteau Suisse puis Outils actifs/inactifs et Administration.

[1] Le plugin contient quelque exemples de chaînes

[2] mais permet d'éviter facilement les doublons

[3] Dans Spip ce raccourci clavier ne remplace pas mais applique le style "intertitre"

IX) Spip/Zpip et le multi-linguisme

Vader[FR] — 2014-12-25T19:04:57Z

SPIP est capable de gérer des langues différentes pour un même site.

Activer le multilinguisme et choisir les langues du site

Menu configuration, puis "Langue principale du site" et "Multilinguisme"

Choisir la langue principale du site et le jeu de caractères, si ce n'est pas déjà fait.

Puis choisir d'activer ou non les menus de langues par objets (rubriques, articles, brèves)

et choisir les langues qui seront proposées par le site. Il y en a... un paquet.

Édition du squelette pour les pages publiques

Il y a globalement deux manière de faire du multilinguisme :

langues différentes selon les secteurs (rubriques principales). Cela sera plutôt pour les sites assez importants, dont les différentes rubriques principales (différentes langues) seront assez autonomes. Par exemple spip.net
de "simples" traductions des articles. Les rubriques sont mufti-lingues, mais un filtre dans les boucles permet de n'afficher que les articles de la langue choisie. Ce sera préférable pour les petits sites et sites personnels.

Dans le deuxième cas, des blocs multilingues permettront de proposer des titres de rubriques en plusieurs langues.
Le titre d'une rubrique sera alors par exemple [fr]Revue de presse[en]Press Book, chaque chaîne de langue étant précédée d'un code sur 2 lettres selon les langues gérées par SPIP dans le menu configuration - multilinguisme.

Dans un squelette de de rubrique, pour n'afficher que les articles correspondant à la langue choisie, il suffira de filtrer la liste dans une boucle SPIP par le filtre {lang}, comme par exemple dans cette rubrique,
Dans le squelette d'un article, pour afficher les liens de traduction (versions de l'article dans d'autres langues), utiliser le code SPIP habituellement fourni et présent dans le cartouche :

[(#REM) Inclure le modele des liens de traductions ]
#MODELE{article_traductions}

Traduire des articles

Dans la page d'édition d'un article dans l'espace privé (mode visualisation), il y a un en bas du cadre "Langue de l'article" un lien "Écrire une nouvelle traduction"

Cela créé un nouvel article, considéré comme une traduction du précédent.
Le titre sera par ailleurs de la forme : "nouvelle traduction - titre de l'article".

Une fois le nouvel article traduit dans la langue souhaitée, il ne restera plus qu'à en changer sa langue, par le bouton "changer" du cadre "Langue de l'article" en mode visualisation dans l'espace privé.

Tuto SPIP/Zpip - création de thème

Vader[FR] — 2013-10-22T11:24:41Z

Les sites SPIP utilisant des squelettes de type Zpip peuvent utiliser des thèmes Zengarden.
Vous trouverez plus d'informations à ce sujet ici et sur les forums de SPIP.

1) Prérequis

un site SPIP avec plugin squelette Zpip et le plugin Zengarden
Firefox et ses outils de développement web
éventuellement le module complémentaire ColorZilla pour Firefox
Notepad++ sous Windows, Gedit ou autre éditeur de texte sous Linux

2) Création du thème

Le plus simple pour créer un thème est d'utiliser un thème existant, contenant déjà le "squelette", surtout en cas de squelette Zpip personnalisé.
Les différents blocs et classes existant sur les pages du site (entête, pied de page, navigation, contenu, zone droite...) étant déjà déclarés et ne devant à priori pas changer, cela facilitera les choses.

Pour créer un thème de A à Z, c'est la même chose : créer un dossier pour le thème, identifier avec l'inspecteur (outils de développement web) les éléments de la page, leur appliquer un style.

Il faudra alors renommer le dossier du (nouveau) thème et éditer le fichier plugin.xml comme expliqué dans cet article afin de déclarer le nouveau thème.

Quand à la vignette illustrant le thème (champ du fichier plugin.xml), elle doit avoir 250px de large.

Il est possible et recommandé (pour simplifier la gestion des thèmes) d'avoir à la racine des thèmes (donc dans le dossier themes à la racine du site) un fichier de style commun, pour la position et la taille des blocs ainsi que le texte.
Le fichier en question sera ensuite importé par le fichier css du thème.

/* import de la feuille commune des positions de blocs et tailles de texte */ @import url("../commun.css");

3) Édition du style

Une fois le thème déclaré, le style peut être créé en expérimentant avec les outils de développement web de Firefox.
Cela permet de naviguer dans la page et de voir dans le cadre de droite le style associé aux éléments situés dans l'arborescence du cadre de gauche.
Il est alors possible d'éditer en temps réel les propriétés de style.

Cela permet aussi de voir l'ensemble des propriétés valables pour l'élément (onglets Calculé et DOM), la taille et l'espacement des éléments (onglet Apparence), ainsi que le style associé aux évènements par l'onglet Style, menu déroulant, :hover pour le style lorsque la souris passe au dessus, :active et :focus

Il faudra ensuite éditer le fichier CSS (voir ici et là) à la ligne indiquée par l'inspecteur pour y mettre les propriétés css.


Edition du thème par Firebug

Par exemple, dans l'illustration ci-dessus, l'inspecteur (outils de développement web de Firefox) permet de voir que le style associé aux blocs dépliants situés à droite des articles est déclaré dans le fichier habillage.css (du thème), ligne 45, et que les propriétés de style background-image et opacity surchargent en complétant les propriétés de positionnement bottom et top déclarées dans le fichier commun à tous les thèmes commun.css, ligne 321.

La compression du CSS par SPIP rend ce genre de "débogage" impossible.

La propriété d'image d'arrière plan a été désactivée dans l'inspecteur, et une propriété de couleur a été ajoutée. En tapant "darkg" l'outil propose de compléter pour avoir "darkgray".

Tuto Spip - Création galerie d'images

Vader[FR] — 2013-09-22T12:39:38Z

Il peut être intéressant, pour illustrer un site et attirer plus de visiteurs, de créer une ou plusieurs galeries d'images.

SPIP est capable de proposer des "galeries d'image" au format d'un portfolio lié à un article.

Mais en cas d'un grand nombre d'images, il sera préférable de diviser la galerie en onglets.

Malheureusement cela peut s'avérer fastidieux si on ne sait pas comment s'y prendre.

1) Génération des vignettes par SPIP

Tout d'abord, afin d'alléger - aussi bien techniquement que visuellement - la page chargée par l'utilisateur, on mettra dans l'article non pas les images grande taille, mais des vignettes.
Ces vignettes seront automatiquement générées par SPIP. Il suffit pour cela d'aller dans le menu Configuration> Fonctions avancées du site, dans l'espace privé.

Cliquer sur la vignette de meilleure qualité dans la page de configuration permet de choisir la méthode de fabrication des vignettes.

Ensuite, il faudra indiquer la taille maximale des vignettes générées, et bien sûr sélectionner le bouton radio "Générer automatiquement les miniatures des images".

Un bouton situé en bas à droite du cadre, non visible sur la capture d'écran, permet d'enregistrer les modifications.

2) Envoi des images sur le serveur

Envoyer un grand nombre d'images en même temps sur le serveur en passant par le formulaire SPIP peut être très long, et même échouer si l'on envoie trop d'images de trop grande taille.

Afin de ne pas se perdre dans les images il est préférable :
- de les envoyer par paquets de 50 maximum.
- de nommer les images avec un numéro croissant pour pouvoir plus facilement les identifier dans une série plus tard. Des noms comme "Capture01, Capture02".... ne sont pas des plus pratiques.

Et pour aller (beaucoup) plus vite :
- il faut envoyer les images par FTP dans le répertoire tmp/upload du site, en utilisant un client FTP comme FileZilla
- puis dans l'interface web de SPIP, choisir de téléverser les images depuis "le serveur".

S'il y a des images dans tmp/upload, SPIP proposera une liste déroulante des fichiers, avec en plus une option pour tout charger.

Une fois les images chargées, il ne reste plus qu'a les intégrer à l'article dans l'ordre, les organiser et les commenter.

Pour intégrer les images plus rapidement, voici une petite page html avec un script JavaScript permettant de générer tous les liens de type , qu'il suffira de copier-coller ensuite.


Générateur de liens de documents pour SPIP

3) Organisation des images dans l'article

Afin d'alléger visuellement la page, il est recommandé d'utiliser la fonctionnalité d'onglets du plugin Couteau suisse.

La fonction recherche (CTRL+F) du navigateur permettra d'aller image par image dans le bon ordre, avant de cliquer sur le lien proposé par SPIP.
Il faudra choisir l'alignement "left".
La zone de recherche restant active dans la page, il suffit de changer un numéro et de cliquer sur "suivant" pour aller à l'image suivante dans la série.

Les images n'ayant pas de titre, le seul lien proposé pour le moment est img

Or, les images ajoutées devront apparaître sous forme de vignette et non en grande taille, c'est pourquoi le code devra être transformé en .
Cela peut aisément se faire en copiant tout le texte de l'article (CTRL+A dans la zone de saisie puis CTRL+C) et en le collant (CTRL+V) dans un éditeur de texte comme Notepad++ (Windows) ou Gedit (Linux).
Ensuite, la fonction rechercher et remplacer (habituellement CTRL+H, ou située dans le menu édition) de l'éditeur de texte permettra de remplacer tous les par . Copier-Coller à nouveau, cette fois depuis l'éditeur de texte vers l'article, et le tour est joué.


A ce moment, il est possible d'enregistrer l'article, en gardant éventuellement une copie de son texte dans l'éditeur précédemment utilisé, au cas où l'enregistrement échouerait.
 img affiche l'image en grand, sans titre ni descriptif
 emb affiche l'image en grand, avec titre
 doc affiche la vignette

`4) Titrer les vignettes`


Afin de mieux référencer les images et pour les décrire brièvement à un visiteur néophye, il est ensuite recommandé de les titrer.

Cela étant long et fastidieux dans la fenêtre d'édition de l'article, il sera plus simple d'aller dans le menu Edition > Documents de SPIP.
Une boîte de recherche spécifique à la médiathèque (à ne pas confondre avec la boîte de recherche générale du site, située dans l'entête) permettra de n'afficher que les images de la série.


Par défaut et ce que je conseille, l'affichage se fait
 par identifiant décroissant, et donc en mettant les images les plus récentes (et pas encore titrées) d'abord.
 en paginant les images par 10
Il suffit alors de cliquer avec la molette de la souris (= ouvrir dans un nouvel onglet) sur les 10 liens "Modifier" des images non titrées, puis dans chaque onglet, de mettre un titre, valider, passer à l'onglet suivant pendant que l'onglet courant recharge et faire de même.

Une fois qu'un onglet a rechargé, il est possible de le fermer en cliquant sur sa petite croix.

Lorsque les 10 premières images sont titrées, on clique sur le lien de pagination pour aller aux 10 suivantes, et ainsi de suite.
Une fois les images envoyées au serveur, triées et organisées dans l'article, et titrées, il ne reste plus qu'à publier l'article.



XI) Le couteau suisse
Vader[FR] — 2013-04-28T12:43:53Z

		Généralités

Ce méta-plugin comporte tout un tas de fonctionnalités plus utiles les unes que les autres.
Ces fonctions peuvent être activées indépendamment dans la configuration du couteau suisse, menu configuration -> le couteau suisse.


Les modules sont ensuite listés par catégorie, les inactifs à gauche et les actifs à droite.

A la sélection d'un module, ses options apparaissent en bas.

Pour activer/désactiver le(s) module(s) sélectionné(s), il suffit de cliquer sur les flèches tournantes verte et rouge au milieu.


Administration

Les principaux outils utiles sont :
 Modération modérée : modérer la modération des forums publics configurés à priori pour les utilisateurs inscrits. Exemple : Je suis le webmestre de mon site, et je réponds à un message d'un utilisateur, pourquoi devoir valider mon propre message ? Modération modérée le fait pour moi !
 SPIP et le cache… : permet de modifier l'utilisation et la taille du cache.
Il y a aussi d'autres outils moins utiles :
 Dossier du squelette : permet de choisir le squelette utilisé. pas vraiment utile avec un squelette de type Zpip, qui correspond lui-même a un plugin.
 Format des URLs
 La corbeille : empêcher SPIP de vider la corbeille automatiquement au bout de 24 heures
 Liste des webmestres : Les webmestres ici définis ont le privilège de ne plus être obligés de passer par FTP pour valider les opérations sensibles du site, comme la mise à jour de la base de données ou la restauration d'un dump. Utile seulement s'il y a plusieurs administrateurs "système" du site.
 Paragrapher : insère des balises  et 
 dans tous les textes qui sont dépourvus de paragraphes.
 Pas de verrouillage de fichiers : Désactive le système de verrouillage de fichiers en neutralisant la fonction PHP flock(), certains hébergements posant des problèmes. N'activez pas cet outil si votre site fonctionne normalement.
Sécurité

Les principaux outils utiles sont :
 Ecran de sécurité
 Lutte contre le SPAM : Tente de lutter contre les envois de messages automatiques et malveillants en partie publique. Certains mots, tout comme les balises en clair , sont interdits. La liste des mots interdits est éditable.
 Pas de forums anonymes : Incite tous les auteurs de messages publics à fournir (d'au moins d'une lettre !) un nom et/ou un courriel afin d'éviter les contributions totalement anonymes.
 Taille des forums : Par défaut les messages de forum ne sont pas limités en taille. Si cet outil est activé, un message d'erreur s'affichera lorsque quelqu'un voudra poster un message d'une taille supérieure à la valeur spécifiée.
 Limites mémoire : Afin d'alléger la mémoire de votre serveur, permet de limiter les dimensions (hauteur et largeur) et la taille du fichier des images, logos ou documents joints aux divers contenus de votre site.
Il y a aussi d'autres outils moins utiles :
 Gestion du JavaScript
 MailCrypt : Masque tous les liens de courriels présents dans vos textes en les remplaçant par un lien JavaScript permettant quand même d'activer la messagerie du lecteur. Cet outil antispam tente d'empêcher les robots de collecter les adresses électroniques laissées en clair dans les forums ou dans les balises de vos squelettes.
 Mises à jour automatiques : permet de gérer facilement la mise à jour de vos différents plugins installés dans le dossier plugins/auto/
 Pas de stockage IP : Désactive le mécanisme d'enregistrement automatique des adresses IP des visiteurs de votre site par soucis de confidentialité
 autorisations:nom
Interface privée

Les principaux outils utiles sont :
 Bouton « Voir le site public » : remplace l'image du bouton standard « Voir le site public » (en haut à droite sur cette page) par le logo du site, s'il existe.
 Dans la même rubrique : définit le nombre d'objets listés dans le cadre nommé « Dans la même rubrique » et présent sur certaines pages de l'espace privé.
Il y a aussi d'autres outils moins utiles :
 Allègement de l'interface privée : Désactive le menu de changement rapide de statut d'un article au survol de sa puce colorée, utile pour optimiser les performances client.
 Boîtes privées : certaines boîtes du couteau suisse apparaissent ici ou là dans l'interface privé
 Largeur d'écran : Détermine la largeur d'écran imposée à tous en partie privée : inutile en cas d'utilisation de mon style d'interface privée "corrigé" et rendu adaptatif à la taille de l'écran,
 Les tris de SPIP : Pour personnaliser la navigation en partie privée et lorsque SPIP le permet, n'utilisez le tri personnalisé en SQL que si vous savez ce que vous faites.
 Page des auteurs : Cet outil configure l'apparence de la page des auteurs, en partie privée, nombre par page et statuts à afficher.
 Réglage des sélecteurs :
Améliorations des textes

Les principaux outils utiles sont :
 Citations bien balisées : Afin de respecter les usages en HTML dans les contenus SPIP de votre site, cet outil remplace les balises  par des balises  quand il n'y a pas de retour à la ligne. Les citations courtes doivent être entourées par  et les citations contenant des paragraphes par .
 Smileys : Insère des smileys dans tous les textes où apparaît un raccourci du genre . Idéal pour les forums.
Il y a aussi d'autres outils moins utiles :
 Belles URLs
 Belles puces : ne pas activer en même temps que le plugin Enluminures typographiques
 Corrections automatiques : outil en cours de développement !!
 Exposants typographiques : améliore le rendu typographique des abréviations courantes, pour être conformes à celles de l'Imprimerie nationale (Lexique des règles typographiques en usage à l'Imprimerie nationale)
 Glossaire interne
 Guillemets typographiques : Remplace automatiquement les guillemets droits (") par les guillemets typographiques de la langue de composition.
 Intertitres en image : Transforme tous les intertitres « {{{Mon intertitre}}} » en image typographique paramétrable.
 Retours de ligne automatiques : utile sous SPIP 2, plus sous SPIP 3. Permettait en phase transitoire de continuer de prendre en compte les retour à la ligne forcés par "_" en début d'une nouvelle ligne au sein d'un paragraphe.
 Sommaire automatique : Construit un sommaire pour le texte de vos articles et de vos rubriques afin d'accéder rapidement aux gros titres (balises HTML Un gros titre) ou aux intertitres SPIP (de syntaxe  {{{Un intertitre}}})).
 Titres typographiés : Par défaut, les raccourcis typographiques de SPIP ({, {{, etc.) ne s'appliquent pas aux titres d'objets dans vos squelettes, cet outil active donc l'application automatique des raccourcis typographiques de SPIP sur toutes les balises #TITRE et apparentées (#NOM pour un auteur, etc.). Exemple d'utilisation : le titre d'un livre cité dans le titre d'un article, à mettre en italique.
Raccourcis typographiques

Les principaux outils utiles sont :
 Blocs Dépliables : permet d'insérer un bloc replié ou déplié via une barre d'outil, et de déterminer le comportement des blocs (un seul ouvert à la fois par page, animation, etc)


exemple

texte du bloc
 Chatons : un peu comme les smiley, permet d'insérer une image située dans le répertoire img/chatons du couteau suisse. Il faut vider le cache du couteau suisse (local et tmp) et retourner dans la configuration du couteau suisse afin qu'il régénère les raccourcis


exemple le chaton :winner
 Découpe en pages et onglets : permet de faire un découpage en onglets (comme le présent article), ou en numéro de pages, afin d'alléger visuellement la page vue par le visiteur.

De même, un bouton de la barre d'outil (voir "blocs dépliables") permet d'insérer les balises correspondantes.
en cas d'utilisation de thèmes différents avec Zengarden, pour avoir une certaine cohérence il faudra soit déclarer une couleur de texte spécifique aux blocs d'onglets, soit enlever dans couteau_suisse/outils/decoupe.css la couleur d'arrière plan de div.onglets_bloc .onglets_contenu  afin d'avoir un onglet transparent au lieu du blanc, permettant d'utiliser les couleurs du thème choisi, comme sur cet article.
 Tout en couleurs : Permet d'appliquer facilement des couleurs à tous les textes du site (articles, brèves, titres, forum, …), toujours via des boutons de la barre d'outil.


T pour le texte, F pour le fond.
Attention aux couleurs choisies, selon le thème... du texte blanc, si la couleur de fond du thème est blanc, ne se verra pas.
Il y a aussi d'autres outils moins utiles :
 Blocs multilingues : comme dans vos squelettes, permet d'utiliser librement les chaînes de langues dans tous les contenus de votre site (articles, titres, messages, etc.) à l'aide du raccourci <:ma_chaine:>. La contrainte étant que chaque chaîne doit être déclarée dans un fichier de langue...
 Décoration : De nouveaux styles paramétrables dans vos textes et accessibles grâce à des balises à chevrons.
 Filets de Séparation : Insère des filets de séparation, personnalisables par des feuilles de style, dans tous les textes de SPIP. « __code__ », où « code » représente soit le numéro d'identification (de 0 à 7) du filet à insérer en relation directe avec les styles correspondants, soit le nom d'une image placée dans le dossier plugins-dist/couteau_suisse/img/filets/.
Affichage public

Les principaux outils utiles sont :
 SPIP et les liens… externes : permet d'ouvrir les liens externes dans un nouvel onglet/une nouvelle fenêtre, et donc sans fermer la fenêtre/l'onglet de votre site.
Il y a aussi d'autres outils moins utiles :
 Affiche tout : afficher toutes les rubriques ou tous les auteurs de votre site sans tenir compte de leur statut (pendant la période de développement par exemple).
 Ancres douces : Offre à votre site public un défilement adouci de la page lorsque le visiteur clique sur un lien pointant vers une ancre, pour éviter de se perdre dans une page complexe ou un texte très long...

Attention, cet outil a besoin pour fonctionner de pages au « DOCTYPE XHTML » (non HTML !) et de deux plugins jQuery
 Désactive jQuery : Attention : certains outils du Couteau Suisse nécessitent les fonctions de jQuery.
 Désactive les objets flash : Supprime les objets flash des pages de votre site et les remplace par le contenu alternatif associé.
 Force la langue : Force le contexte de langue pour les jeux de squelettes multilingues disposant d'un formulaire ou d'un menu de langues sachant gérer le cookie de langues.
 Jolis Coins : « Jolis Coins » est un outil permettant de modifier facilement l'aspect des coins de vos cadres colorés en partie publique de votre site. voir ici (autoriser toute la page avec NoScript pour que cela s'affiche correctement)
 Message d'alerte : Affiche en tête de toutes les pages publiques un bandeau d'alerte pour diffuser un message d'urgence.
 SPIP et ses raccourcis… : Vous pouvez y définir certains raccourcis de SPIP. Une valeur vide équivaut à utiliser la valeur par défaut.
 Visiteurs connectés : offre une noisette (= fonction,  ) pour votre squelette qui affiche le nombre de visiteurs connectés sur le site public.
Balises, filtres, critères

Les principaux outils utiles sont :
 Balise #INSERT_HEAD : Active automatiquement la balise #INSERT_HEAD sur tous les squelettes, qu'ils aient ou non cette balise entre  et , les plugins pourront insérer du JavaScript (.js) ou des feuilles de style (.css).
Il y a aussi d'autres outils moins utiles :
 Balise #INTRODUCTION : Cette balise à placer dans les squelettes sert en général à la une ou dans les rubriques afin de produire un résumé des articles, des brèves, etc..
 Balise #SET étendue : Afin d'alléger les écritures du type #SETx,#GETx|un_filtre, cet outil vous offre le raccourci suivant : #SET_UN_FILTREx. Le filtre appliqué à une variable passe donc dans le nom de la balise.
 Balises #TITRE_PARENT/OBJET : Au sein d'une boucle, il est courant de vouloir afficher le titre du parent de l'objet en cours. Traditionnellement, il suffirait d'utiliser une seconde boucle, mais cette nouvelle balise #TITRE_PARENT allégera l'écriture de vos squelettes.
 Horloge : Outil en cours de développement. Vous offre une horloge JavaScript . Balise : #HORLOGE. Modèle : 
 Liens en clair : Met à votre disposition le filtre : 'liens_en_clair', pour les liens hypertexte qui ne sont pas visibles lors d'une impression. Ce filtre ajoute entre crochets la destination de chaque lien cliquable (liens externes ou mails).
 Masquer du contenu : Cet outil permet de masquer sur le site public et sans modification particulière de vos squelettes, les contenus (rubriques ou articles) qui ont le mot-clé défini. Si une rubrique est masquée, toute sa branche l'est aussi.
 Orientation des images : 3 nouveaux critères pour vos squelettes : portrait, carre et paysage. Idéal pour le classement des photos en fonction de leur forme.
 Trousse à balises : Outil en cours de développement. Vous offre quelques balises très simples et bien pratiques pour améliorer la lisibilité de vos squelettes.
 Version texte : 2 filtres pour vos squelettes, pour produire des pages plus légères. version_texte : contenu texte d'une page html sauf quelques balises élémentaires, version_plein_texte : contenu texte d'une page html en texte brut.
Développement

Peu d'outils vraiment utiles sur un site en production ici :
 Débogueur de développement : Cet outil vous permet de voir les erreurs PHP à l'écran. Vous pouvez choisir le niveau d'erreurs d'exécution PHP qui sera affiché.
 Décalage horaire : permet de définir le décalage horaire à utiliser sur le site. Depuis PHP 5.4.0, la variable d'environnement TZ et les informations disponibles via l'OS ne sont plus utilisées pour deviner le décalage horaire.
 SPIP et les logs : les différents paramètres pris en compte par SPIP pour la journalisation des évènements particuliers du site. rotation, emplacement, nom, gravité....
 Site en travaux : comme le plugin "en travaux", permet d'afficher un message personnalisable sur tout le site public, éventuellement la partie privée pendant une phase de maintenance, et aussi limiter l'accès à l'espace privé.
 Traductions manquantes : Toutes les chaînes de langue qui ne sont pas internationalisées (donc présentes dans les fichiers lang/*_XX.php) vont apparaitre en rouge.
 Validateur XML : Active le validateur XML pour l'espace public, visible que des administrateurs du site, pour valider la syntaxe de vos pages finales, et résoudre les problèmes d'accessibilité du Web aux déficients visuels.
Divers

Il n'y a qu'un seul outil : Comportements du Couteau Suisse.

Celui-ci n'est pas très utile sur un site en production.
 Logs :
 Obtenez de nombreux renseignements à propos du fonctionnement du Couteau Suisse dans les fichiers spip.log que l'on peut trouver dans le répertoire : tmp/log/.
 Configurez les options de journalisation grâce à l'outil « SPIP et les logs ».
 Options SPIP.
 SPIP ordonne les plugins dans un ordre spécifique. Afin d'être sûr que le Couteau Suisse soit en tête et gère en amont certaines options de SPIP.
 Si les droits de votre serveur le permettent, le fichier config/mes_options.php sera automatiquement modifié pour inclure le fichier tmp/couteau-suisse/mes_spip_options.php.
 Requêtes externes :
 D'une part, le Couteau Suisse vérifie régulièrement l'existence d'une version plus récente de son code et informe sur sa page de configuration d'une mise à jour éventuellement disponible.
 D'autre part, ce plugin comporte certains outils qui peuvent nécessiter d'importer des librairies distantes.



X) "Correction" du style de l'interface privée
Vader[FR] — 2012-09-14T19:02:20Z
Pa défaut, l'interface privée propose 2 styles :
 écran petit, sur 2 colonnes, pour les petites résolutions
 écran large, sur 3 colonnes, pour les écrans larges (jusque là, normal)
Mais ces styles sont prévus pour des résolutions précises, et la taille des éléments, dans un cas comme dans l'autre, est fixe.

Le style "large" est prévu pour un écran de 1024 ou 1280px "seulement", car la première colonne fait 200px de large, et la colonne du milieu, celle du contenu fait 540px.
Je me suis donc permis de "corriger" ce style afin de rendre les blocs "adaptables" à la taille de l'écran, 1280px, 1680px, ou plus, ou moins, et ce en utilisant des blocs en position "absolute", dont certains en taille fixe pour les menus.
Petite précision toutefois, le style modifié est celui de l'écran "petit", ce qui implique deux choses :
 En choisissant l'écran "large" dans les préférences de l'auteur, le style sera....mixte : conteneur avec taille adaptable, et dedans des blocs de taille fixe (comme les deux premiers décrits plus haut).
 Il n'y a "que" 2 colonnes.
Le style "corrigé" se présente comme suit :
 entête et menus en haut, centrés sur toute la largeur.
 pied de page (en bas, donc...) avec version de Spip, de l'écran de sécurité, et lien vers la mise à jour de Spip s'il y a lieu.
 cadre conteneur entre les deux, sur toute la largeur, divisé en deux sous-cadres, un de navigation (de 200px de large) et un de contenu (rubrique, article....), à taille adaptable.
Visuellement, ça ressemble à ça :



Pour ceux qui souhaiteraient une interface privée au style à taille variable, les fichiers modifiés du style de l'interface privée (et les autres en fait, je n'ai pas vraiment fait de détail) sont dans l'archive 7z ci jointe ;


Style interface privée

Bien sûr, il pourrait être utile de sauvegarder les fichiers avant de les remplacer, au cas où le nouveau style de l'interface privée ne vous conviendrait pas.

L'archive est à décompresser dans le répertoire prive/themes/spip/ du site web.
Il faudra ensuite vider le cache dans local/cache-css/ et tmp/cache/


VIII) le squelette Zpip et les thèmes
Vader[FR] — 2012-06-21T08:33:12Z
Squelette Zpip
Le squelette générique Zpip
Le squelette Zpip est un plugin qui fournit un squelette générique "par défaut" que l'on peut ensuite adapter.
En cas d'adaptation du squelette, il faudra penser à placer le plugin dans le répertoire plugins, sinon, il est possible de le placer dans le répertoire extensions (Spip 2) ou plugins-dist (Spip 3).
La généricité du squelette permet ensuite de développer (ou tout simplement d'utiliser) des thèmes qui pourront changer non seulement le style mais la structure du site, car un thème peut redéfinir le fichier squelette body.html (et seulement celui-ci).
Zpip est requis par le plugin zen-garden, qui, lui, propose un sélecteur de thèmes, y compris (si toutefois on en fait le choix) sur l'espace public.

Zpip est un modèle de squelette réutilisable, modulaire et disposant d'une galerie de thèmes. Ce modèle de squelette rend l'installation d'un site avec son thème plus facile, et la personnalisation plus efficace.
Zpip-dist est la version de base de ce modèle de squelette, que vous pouvez utiliser telle quelle ou personnaliser et enrichir selon vos besoins.
Vous pouvez tester les thèmes disponibles sans installer Zpip ni spip, en vous rendant sur http://zpip.spip.org. Vous pourrez ensuite les personnaliser, ou définir vous même les thèmes de votre site, sur la base de l'architecture de Zpip.

Dans le squelette Zpip, la structure globale du contenu (ou corps de page, , contenant les blocs principaux de contenu, navigation, extra...) est définie dans le fichier body.html, et seules les boucles de contenus correspondant se trouvent dans les fichiers de squelette situés dans les répertoires contenu, inclure, extra, navigation... une variable d'environnement permettant de choisir le morceau de squelette correspondant. 

Ce fichier body est re-déclaré par les thèmes, qui peuvent donc simplement changer les principaux blocs conteneurs, modifier le style des éléments existants, mais pas en créer d'autre (sinon ce seraient des squelettes et non des thèmes).
La structure globale de la page, incluant l'entête () de la page, est déclaré par le fichier structure.html
Exemple structure.html
[         #SPIP_CRON  
Le système est relativement simple :
 le fichier body.html (principalement) définit les bloc conteneurs de la page et y inclut les 6 éléments prédéfinis Zpip (entete, barre-nav, contenu, extra, navigation et pied)
 le contenu de ces éléments est ensuite détaillé dans les répertoires du même nom.
On peut donc ensuite placer ces éléments "standards" (normalisés) dans les blocs que l'on souhaite. Un bloc par élément, plusieurs éléments dans le même bloc... puis donner un style et positionnement aux blocs. 

C'est le principe d'un thème.
Exemple de fichier body.html (d'un thème) :
  [(#REM)	HEADER / ENTETE ]  
  
     [(#REM)	CONTENT / CONTENU ]  
   [(#REM)	SECONDARY NAVIGATION SIDEBAR / Navigation laterale secondaire ]  
  [(#REM)	EXTRA INFORMATIONS / Informations complementaires]   [(#REM)	FOOTER / Pied de page ]  
 
Ainsi, au lieu de redéfinir les différents éléments communs dans toutes les pages du squelette (comme l'entête, le menu de navigation, le pied de page...), ces éléments ne sont définis qu'une seule fois.
Précision toutefois, dans le squelette "normal" de SPIP il est possible d'utiliser les directives  afin de faire référence aux éléments communs, sans les définir à chaque fois.

L'ennui, c'est que là où le bloc "contenu" par exemple, pouvait avoir une classe et donc un style différent selon que l'on soit dans un squelette page sommaire, rubrique, ou article, avec Zpip, le bloc reste le même (car défini une seule fois dans le fichier body.html), seul le contenu change.
Tout comme le squelette traditionnel spip, le squelette Zpip permet de définir des pages squelettes différentes selon les rubriques (rubrique=X ou rubrique-X) ou articles (article=X ou article-X).
Si toute la structure de la page change, les pages squelette seront à la racine du plugin Zpip, sinon dans les répertoires contenu/navigation/extra... en fonction du bloc de la page qui change.
Ainsi, pour faire que la "fausse" rubrique n°1, "Accueil", affiche la page sommaire, il suffit de créer un fichier rubrique=1.html à la racine de zpip, contenant le même code que la page sommaire, .
Le contenu chargé sera celui de contenu/page-sommaire.html, de même pour le bloc extra (extra/page-sommaire.html), l'entête de la page (head/page-sommaire.html).

Pour le contenu navigation, contenant le menu, il n'y a habituellement qu'une seule page "par défaut" valide pour tous les types de pages : sommaire, article, rubrique, recherche, auteur, mot clé... : dist.html
Exemple navigation/dist.html
[">(#LOGO_SITE_SPIP)] #FORMULAIRE_RECHERCHE [(#REM) Menu de navigation par rubriques ]   Vous avez désactivé JavaScript. Il est conseillé d'activer JavaScript pour profiter au mieux des fonctionnalités du site 
     
 
Comme on peut le voir, le squelette navigation va chercher une page, à savoir inclure/rubriques.html, qui contient la boucle pour le menu des rubriques principales.
[(#REM) Barre de navigation,
[(#REM) Barre de navigation, ouverte sur la hierarchie courante On fait un plan, et, quand on avance vers une rubrique, on l'affiche si son parent est expose ou est la racine du site. ]   <:rubriques:>
    [(#TITRE|couper{80})] 
  
 
 
On pourra aussi trouver dans inclure  des morceaux de squelettes pour les blocs "statiques", comme l'entête et le pied de page, ainsi que la partie "fixe" de l'entête () de la page.
Pour plus d'infos, consulter la doc sur le site SPIP-contrib ici
Thèmes
Les thèmes

Les thèmes sont malheureusement la plupart du temps à tailles fixes. Il est donc possible, voire recommandé, d'éditer les thèmes, surtout pour les adapter aux squelettes Zpip modifiés.
Le outils de développement web de Firefox seront alors utiles pour avoir une bonne visualisation de la structure de la page, des feuilles de style associées, et tester les différents styles possibles.
Les thèmes se mettent dans le dossier themes, a créer à la racine du site.

Dans ce dossier, chaque thème aura son propre répertoire du type theme_nomtheme
Un thème est composé de :
 plugin.xml = fichier descriptif du thème pour les utilisateurs
 body.html = redéfinition des blocs principaux de la page et inclusion des éléments normalisés Zpip
 habillage.css = style et positionnement des blocs et du contenu de la page.
 Astuce : pour plus de facilité il est possible de référer un fichier css de positionnement/tailles commun à tous les thèmes, en mettant dans le fichier habillage.css.
 @import url("../commun.css");
 le fichier commun.css sera donc dans themes/
 img = répertoire des images utilisées par le theme
 une vignette, au format png, largeur 250px, hauteur maxi 150px, référencée dans le fichier plugin.xml
exemple d'un fichier plugin.xml de thème, dans theme_graindimage2.
 Grain d'Image 2 Vader[FR] GNU/GPL, utilisation libre 1.0 Thème modifié du site Grain d'Image, diaporama de page de garde plus grand, fil d'ariane et titres de rubriques retirés... theme graindim_sombre.png stable theme  
Il y a d'autres balises possibles, dont par exemple :
 , qui ici indique qu'il faut une version de Spip entre 2.0.10 et 3.0.99
 Mon Zoli theme a moi
 http://...  le lien vers le thème à télécharger (spip-contrib, site perso...)
Le nom du thème référencé ici est destiné aux humains, et n'est donc pas forcément le même que le nom du répertoire du thème.
Attention !

Il y a ici des différences entre SPIP 2 et SPIP 3 :

 Sous Spip 2, le préfixe est "theme"
 Sous Spip 3, le préfixe est le reste du nom du répertoire, sans l'underscore "_" entre les deux.
Par exemple, pour un thème "theme_fedora16_gnome3"

préfixe Spip 2 = theme 

préfixe Spip 3 = fedora16_gnome3






VI) Publier du contenu par l'interface web de SPIP
Vader[FR] — 2012-06-08T13:06:25Z
Généralités

SPIP étant précisément conçu pour permettre facilement la mise en ligne de contenu à ceux dont l'informatique et le web ne sont pas le métier, l'interface web de publication est assez simple.
A la manière d'un journal, le site se divise en rubriques, dans lesquelles il y a des articles.
Ces articles ont bien sûr un titre et un texte, mais peuvent aussi avoir un logo, un site web "de référence", un surtitre/sous-titre...
Il est également possible de joindre divers documents et images à un article.
En cas de travail collaboratif sur un article, SPIP sera capable de gérer les accès concurrents en verrouillant l'édition d'un article et en ayant un historique des modifications de chaque article, si toutefois cette fonctionnalité a été activée par l'administrateur (menu configuration puis fonctions avancées).
SPIP gère plusieurs raccourcis clavier :
 CTRL+S permet d'enregistrer (article, rubrique..)
 CTRL+B pour mettre un texte sélectionné en gras
 CTRL+I pour .... italique
 CTRL+H pour définir un texte sélectionné comme intertitre.
 CTRL+L pour faire un lien
 CTRL+Q pour une citation
 ...
Rubriques
Les rubriques
Dans n'importe quelle rubrique (comme la rubrique implicite "racine", par exemple) il est possible de créer une sous-rubrique ou d'écrire un article, via des boutons correspondants.
Les rubriques créées peuvent ensuite être modifiées.
Selon les paramètres "contenu du site" choisis par l'administrateur, divers champs peuvent apparaître pour les rubriques :
 Titre
 Descriptif
 Texte
 Logo : on ne peut l'affecter à la rubrique qu'une fois celle-ci créée.
 Mots-clés (pour les recherches ou filtres)
 Document joint
De fait, le texte d'une rubrique n'est que rarement utile.
Il faut se rappeler qu'une rubrique est un conteneur destiné à recevoir des articles, et non du contenu détaillé, qui sera réservé aux articles.
Articles
Les articles
Selon les paramètres "contenu du site" choisis par l'administrateur, divers champs peuvent apparaître pour les articles :
 Surtitre
 Soustitre
 Descriptif
 Chapeau
 Texte
 Post-scriptum
 Date de rédaction antérieure
 Lien hypertexte : un site ou une page à visiter au sujet de l'article
 Article virtuel : article sans contenu, qui va simplement rediriger vers une autre page
 Logo : le logo ne peut être affecté à l'article qu'une fois celui-ci créé.
 Mots-clés (pour les recherches ou filtres)
 Documents joints : ils peuvent être inclus à l'intérieur du texte de l'article ou laissés en marge dans le portfolio.
Spip propose une interface simple avec des boutons pour mettre en forme le texte avec divers attributs, nul besoin de connaître la syntaxe correspondante, il suffit de sélectionner le texte à mettre en forme puis cliquer sur le bon bouton.
 

 intertitre, titre de niveau 2 ou 3, alignement à droite, encadrement du paragraphe, cadre de saisie...
 mise en gras, barré, en évidence (couleur 1 ou 2) avec plugin enluminures typographiques, texte en exposant/indice, code source non interprété avec style particulier
 Italique, petites lettres capitales...
 ajout d'un lien ou d'une note de bas de page
 listes, listes indentées et liste numérotées...
 ajout et édition de tableaux. Un tableau devra toujours avoir un titre.
 blocs de citation, de poésie, blocs dépliants (avec plugin couteau suisse)...
 séparateur de pages, onglets (toujours avec le plugin couteau suisse)
 ...et d'autres fonctions, selon les plugins Spip activés pour le site.
Avant SPIP 3, pour forcer le retour à la ligne au sein d'un même paragraphe (sans ligne vide, donc), il fallait ajouter un "_" suivi d'un espace au début de la ligne.
Un cadre situé sur le côté permet d'ajouter un ou plusieurs documents.


Ceux-ci peuvent ensuite être modifiés (rotation des images, ajout d'un titre/descriptif...) dans leurs propres cadres, situés en dessous du cadre de téléversement.


Il ne restera alors plus qu'à incorporer le document au texte de l'article, en cliquant par exemple sur les liens  ou .. selon la position souhaitée du document dans le texte de l'article.
Si une image dispose d'un titre/descriptif, SPIP proposera un lien  au lieu du lien . Le lien  permet de mettre une vignette au lieu de l'image entière. La vignette dispose d'un lien vers l'image. 

Exemple pour une galerie

Une fois l'article créé, on pourra lui affecter un logo.


De même, en fonction des paramètres choisis par l'administrateur, on pourra activer ou désactiver le "forum" lié à l'article, qui permet aux visiteurs de "répondre à l'article".


Et quand l'article sera fini, il faudra changer son état de publication, pour soit le publier directement, s'il on est administrateur de la rubrique, soit le proposer à la publication si l'on est que rédacteur, auquel cas il faudra que l'article soit validé par un administrateur pour apparaître sur le site.


Les articles virtuels
Si l'administrateur a activé cette fonctionnalité, il est possible de créer des "faux" articles, qui ne feront que rediriger le visiteur.


Cela permet d'avoir tout de même une référence à un article ou une page dans le site Spip.


L'interface de Spip étant vaste, le plus simple est de la tester.



VII) Maintenance du site
Vader[FR] — 2012-06-05T12:54:32Z
Mise à jour de SPIP
Il est préférable de d'abord sauvegarder la base de données du site.

Ensuite, il suffit de télécharger la dernière version de SPIP, de la décompresser en local, puis d'envoyer sur le FTP du site tout le contenu de l'archive sauf :
 config
 squelettes-dist
 local (vide)
 tmp (idem)
 IMG (idem)
Puis en allant sur l'interface de SPIP dans /ecrire, la procédure de mise à jour débutera.
Sauvegarde de la base
Menu configuration (SPIP 2) ou maintenance (SPIP 3) puis "sauvegarder la base"
Cela permet de faire une sauvegarde des informations saisies dans SPIP.
Cela ne sauvegarde pas les documents joints aux articles !


Le fichier créé par la sauvegarde pourra ensuite être récupéré par FTP.
Le plugin "sauvegarde automatique" peut envoyer automatiquement par mail des sauvegardes à l'administrateur. Ces sauvegardes ne sont pas au format SPIP, et la procédure de restauration de ces sauvegardes est donc différente.
Restauration de la base
Menu configuration (SPIP 2) ou maintenance (SPIP 3) puis "restaurer la base"
Un fichier de sauvegarde présent sur le FTP (dans tmp/dump) peut être restauré dans la base.
Cela ne restaure pas les documents joints aux articles !
Une sauvegarde peut être envoyée sur le FTP pour restaurer le site en cas de crash majeur.


Changement dans le squelette ou le style et remise à zéro du cache
En cas d'édition du squelette ou du style, il faudra réinitialiser le cache pour que SPIP n'envoie pas l'ancienne version des pages, qu'il compresse et stocke pour optimiser le temps de réponse.
Cela se fait par le menu configuration (SPIP 2) ou maintenance (SPIP 3) puis "vider le cache".
Perte du login/mot de passe administrateur
La solution la plus simple est d'utiliser le formulaire "mot de passe oublié" de SPIP.
Cependant, si l'adresse mail n'est pas renseignée, ou que l'envoi par mail échoue, il faut réinitialiser le compte d'administration.
Pour ce faire, il suffit de renommer ou d'effacer via FTP le fichier connect.php du répertoire config.
L'absence de ce fichier déclenchera la procédure d'installation en allant dans /ecrire.