Sarka-SPIP

Bug SPIP du 3 septembre 2010

_Christophe_ — 2010-09-03T08:00:46Z

Certains d'entre vous ont constaté avec stupeur que leurs sites étaient « plantés » ce matin, aucun article n'étant plus affiché sur la partie publique.

Il s'agit d'un bug SPIP (et non Sarka-SPIP), ne touchant, selon les informations que j'ai pu recueillir, que :

les dernières versions de SPIP (2.1.x),
les sites animés par un serveur 32 bits.

L'explication « officielle » est disponible ici et le résumé du correctif ici.

La procédure que je vous conseille est la suivante :

rapatrier votre fichier « quete.php » situé dans ecrire/public en local,
(facultatif) renommer ce fichier distant, par exemple en « -quete.php »,
éditer localement votre fichier et corriger la ligne 82 comme indiqué,
déposer le fichier « quete.php » corrigé par Ftp dans ecrire/public.

Sarka-SPIP, une reprise en douceur !

_Eric_ — 2010-07-17T17:09:01Z

C'est avec beaucoup de plaisir que je vous annonce qu'une nouvelle équipe vient de reprendre le flambeau de Sarka-SPIP ! Laure, Yveline, Christophe, Joseph et Gregory forment maintenant la nouvelle « Sarka-Team ».

La première étape de reprise de l'hébergement est terminée, les coordonnées de contact ayant été transférées à Laure... Le nouveau Webmestre a été choisi -bravo Christophe- et les clés lui ont été données.
Le site reste donc hébergé chez Infomaniak qui m'a toujours donné entière satisfaction et qui j'espère, continuera à vous permettre de surfer rapidement sur le site de Sarka-SPIP.

Concernant les sites de démos, je suis en train de les transférer vers l'hébergement du site de référence en ne gardant qu'un seul site en SPIP 2.1. Il sera accessible via un sous-domaine de sarka-spip.net. Je ferai une communication dès que ce site sera fonctionnel.

Maintenant, les prochaines étapes vont consister pour l'équipe à définir les nouvelles orientation et organisation éditoriales, la politique des forums, l'accès au site, la feuille de route des développements. J'ai idée qu'un prochain édito ne tardera pas à paraître pour présenter tout ça et faire appel, de façon plus ciblée, aux bonnes volontés.

Pendant cette phase de transition au moins, j'ai passé tout le monde « visiteur » afin de figer l'espace privé. La nouvelle équipe définira ensuite comment attribuer le statut de rédacteur à ceux qui seront prêts à rédiger des articles. Le forum reste bien sur ouvert à tous les visiteurs enregistrés et j'essayerais d'ici peu de proposer une nouvelle présentation plus accessible : un cadeau de retraite !

Voilà, donc plus d'inquiétude, Sarka-SPIP continue son petit bonhomme de chemin.

Bonnes vacances !

Utiliser correctement la typographie de SPIP

_Equipe_ — 2010-07-04T12:46:10Z

Cette page présente un échantillon de chacun des enrichissements typographiques disponibles sur un site SPIP. Leur habillage est réalisé par le webmestre, en CSS, via des feuilles de style externes. En l'occurence, vous pouvez sur ce site constater l'habillage résultant des CSS Sarka-SPIP.

Ce paragraphe constitue donc le chapeau.

Paragraphes

Premier paragraphe. Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Sed non risus. Suspendisse lectus tortor, dignissim sit amet, adipiscing nec, ultricies sed, dolor. Cras elementum ultrices diam.
Ici, retour à la ligne, généré par le raccourci SPIP « _ ». Espace insécable.

Second paragraphe. Proin porttitor, orci nec nonummy molestie, enim est eleifend mi, non fermentum diam nisl sit amet erat. Duis semper. Duis arcu massa, scelerisque vitae, consequat in, pretium a, enim. Pellentesque congue.

Troisième paragraphe, précédé d'une ligne horizontale de séparation, générée par le raccourci SPIP « ---- ». Praesent egestas leo in pede. Praesent blandit odio eu enim. Pellentesque sed dui ut augue blandit sodales.

Un intertitre normal

Voici du texte en italique et du texte en gras.
Voici un ~~texte supprimé~~ et le texte inséré en correction.
Une définition de terme avec la balise .
Un sigle, par exemple W3C, est lu lettre par lettre, tandis que SPIP est un acronyme puisqu'il forme un mot qui est lu normalement.

Texte de gauche à droite et Texte de droite à gauche avec .
Mise en exposant ² et mise en indice : H₂O.
Et voici une note de bas de page [1].

Ici, exemple de puce générée par le raccourci SPIP « - ». Attention, leur succession ne constitue pas une liste !

— Un tiret long, généré par le raccourci SPIP « -- », utile pour les dialogues.

Hyperliens

SPIP distingue lien interne et liens externes dont URLs directes : http://www.spip.net, et lien généré par le raccourci [->site2] : site2.
Mieux vaut spécifier la langue de destination, par exemple : SPIP.
Lien vers une définition du glossaire prédéfini : Wikipédia
Courriel : moi@moi.org
Une ancre vers les citations : #citations

Listes

Liste non ordonnée (ul), générée avec le raccourci SPIP « -* » :

Élément de liste non numérotée
Élément de liste non numérotée
Élément de liste non numérotée
- Plantes
  - Ficus
  - Olivier
- Animaux de compagnie
  - Chat
  - Chien

Et une liste numérotée (ol), générée avec le raccourci SPIP « -# » :

Voici ma main : elle a cinq doigts. En voici deux, en voici trois.
Le premier, ce gros bonhomme, C'est le pouce qu'il se nomme.
L'index qui montre le chemin, Est le second doigt de la main.
Entre l'index et l'annulaire, Le majeur paraît un grand frère.
L'annulaire porte l'anneau, Avec sa bague, il fait le beau.
Le tout petit auriculaire Marche à côté de l'annulaire.

Regardez mes doigts travailler. Chacun fait son petit métier.

N'oublions pas les listes de définition, générées avec les balises HTML

,
: Le kiwi C'est un fruit mais aussi un petit animal Le litchi Un excellent fruit exotique Tableaux Titre du tableau (caption) entête entête entête valeur valeur valeur valeur valeur valeur valeur valeur valeur Citations Lorem ipsum dolor sit amet, consectetuer adipiscing elit. Ceci est une citation au fil du texte (avec la balise HTML ). Ceci est une citation ordinaire, avec la balise HTML . Cras eleifend tristique quam. Fusce gravida lectus vel enim convallis tempor. Second paragraphe. Maecenas laoreet interdum elit. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Phasellus tristique wisi ut lacus. Ceci est une citation générée avec le raccourci SPIP . Cras eleifend tristique quam. Fusce gravida lectus vel enim convallis tempor. Second paragraphe. Maecenas laoreet interdum elit. Pellentesque habitant morbi tristique senectus et netus et malesuada fames ac turpis egestas. Phasellus tristique wisi ut lacus. Je le vis, je rougis, je pâlis à sa vue Un trouble s'éleva dans mon âme éperdue Mes yeux ne voyaient plus, je ne pouvais parler Je sentis tout mon corps et transir et brûler. Ceci est une citation du Phédre de Racine, générée avec le raccourci SPIP , idéal pour les vers des poèmes et chansons. Maecenas mollis. Et voici du code, généré avec le raccourci SPIP : // ceci est du langage php echo "bonjour"; ?> Le raccourci SPIP <cadre> permet publier des extraits de code que l'on peut facilement copier-coller. <?php // ceci est du langage php echo "au revoir"; ?> Sans oublier un raccourci-clavier (), un extrait de script () et une variable (). Et pour finir en beauté, voici une formule mathématique, générée avec : À éviter Ces balises ne doivent plus être utilisées car elles sont dépréciées en XHTML 1.0 Strict : exemple de basefont, exemple de font, exemple de u, exemple de s, exemple de strike, etc. Celles-ci sont déconseillées : exemple de b, exemple de i, exemple de big, exemple de small, exemple de tt.

Titre du tableau (caption)
entête	entête	entête
valeur	valeur	valeur
valeur	valeur	valeur
valeur	valeur	valeur


		Voir en ligne : Exemple de « Lien hypertexte »
		
		[1] Une note de bas de page est, habituellement, signalée par un numéro placé à l'intérieur du texte, numéro repris en bas de page et proposant un complément d'information. Cette fonctionnalité est automatisée dans SPIP.
		Ceci est le texte du Post-Scriptum, où je place habituellement des liens pour en savoir plus, par exemple, vous aurez certainement besoin de : article 12.

Si cela vous aide, vous pouvez comparer cette page avec une autre charte typo.

Pour l'insertion des documents, consultez : article 15



This is the end...
_Eric_ — 2010-06-26T18:22:51Z
A tous ceux qui nous ont suivi et soutenu depuis des années, je fais mon article d'adieu...
		Cela faisait quelques temps que je n'avais plus trop participé à la vie du site, occupé à d'autres plugins SPIP ou à rien de particulier même ! L'envie n'y était plus, l'usure du temps, du SAD (service après don), du squelette lui-même !
 Pourquoi continuer ? Pour qui ? On peut s'étonner de telles questions quand on a une base de sites installés qui doit avoisiner voire dépasser les 2000 unités. Et pourtant, je me les suis posées.
 Mais plus encore, la question qui me taraude depuis plusieurs mois est : avec qui ? L'aventure Sarka-SPIP est comme tout ce que je fais, une aventure d'équipe et non un plaisir solitaire. Le collectif Sarka-SPIP n'est plus ; Sylvain est devenu un utilisateur, Toufik nous suis de loin, Xavier, mon compagnon de maints développements -on a refait deux fois le squelette- a décidé de s'occuper plus de sa petite famille et Shizuka, notre miss graphisme qui a contribué à rendre le squelette plus conforme aux canons actuels de la beauté standard du web 2.0, s'étiole comme moi jour après jour...
 Sans équipe mais aussi sans relève, il ne devenait plus possible de faire vivre le site, d'écrire la documentation, d'alimenter les forums, de mettre à jour les sites de démo et de développer le squelette au gré des évolutions de SPIP. J'ai écrit plusieurs articles à ce sujet mais tous les appels sont restés sans réponse ou du moins sans engagement pérenne.
 Alors chers utilisateurs, Shizuka et moi-même, nous vous léguons cette 3ème version de Sarka-SPIP : le code est sur la Zone, le site est ici encore pour quelques temps et sera fermé si personne ne renouvèle le bail de l'hébergeur et le nom de domaine. Si vous êtes intéressé par une reprise, faites-le nous savoir par mail, nous vous donnerons toutes les clés du royaume en espérant sincèrement que cette aventure trouvera un nouveau souffle pour les années qui viennent.
 Avec tendresse...


Utiliser les pipelines
_Equipe_ — 2010-04-12T14:03:09Z

		Introduction
Comme décrit dans l'article La structure des noisettes de Sarka-SPIP, les pipelines permettent d'injecter des affichages spécifiques à des endroits prédéfinis du squelette. On distingue principalement trois types de pipelines :
  ceux qui insèrent du code dans le bandeau et le pied
 ceux qui ajoutent des noisettes aux colonnes
 celui qui permet d'ajouter des boutons au menu des pages spéciales.
Cet article donne un aperçu de la mise en œuvre de chacun de ces types de pipelines.
 Personnaliser le pied de page
Le but de cet exemple est de rajouter une ou plusieurs lignes au début du pied de page, avant les lignes copyright et outils du squelette. On utilise donc le pipeline _PERSO_PIED_DEBUT, dans lequel on va injecter le fichier de code perso/inc_maxime.html.
 La première étape consiste à rajouter le code suivant dans le fichier config/mes_options.php :
define('_PERSO_PIED_DEBUT', 'perso/inc_maxime');
La deuxième étape consiste ensuite à créer le fichier inc_maxime.html dans le dossier squelettes/perso/. La dernière version du plugin Skeleditor permet de réaliser cette opération directement via l'interface privée du site. Sinon, un éditeur de code et un client FTP font toujours l'affaire.
 On choisit une petite maxime de Victor Hugo pour agrémenter le pied de page :
[(#REM)  ]

Les mots sont les passants de l'âme
 Télécharger
On obtient alors un pied de page personnalisé comme illustré ci-dessous :
    
 Ajouter une noisette en haut de la colonne « Extra »
Cette fois, le but de cet exemple est de rajouter une noisette standard en haut de la colonne « Extra ». On utilise donc le pipeline _PERSO_COLONNE_EXTRA_DEBUT, dans lequel on va injecter le fichier de code perso/inc_traduction.html.
 La première étape consiste toujours à rajouter le code suivant dans le fichier config/mes_options.php :
define('_PERSO_COLONNE_EXTRA_DEBUT', 'perso/inc_traduction');
La deuxième étape consiste encore à créer le fichier inc_traduction.html dans le dossier squelettes/perso/.
 Cette fois on va utiliser la structure standard des noisettes de Sarka-SPIP décrite dans l'article La structure des noisettes de Sarka-SPIP pour créer un bloc de traduction issu d'un script de Google :
[(#REM)  ]


 <:sarkaspip:titre_traduction:>

 
 
 

 

 




[(#REM)  ]





[(#REM)  ]

 Télécharger
Pour parfaire l'affichage, il est nécessaire de créer un item de langue <:sarkaspip:titre_traduction:> dans le fichier lang/local_fr.php. On obtient alors une colonne personnalisée comme illustrée ci-dessous dans une configuration de site en layout 18 :
    
 Ajouter une entrée au menu des pages spéciales
Ce dernier exemple a pour but de rajouter une entrée en fin du menu des pages spéciales. C'est aujourd'hui le seul menu qui autorise ce type d'opération. On utilise donc le pipeline _PERSO_MENU_PAGES_SPECIALES_FIN, dans lequel on va injecter le fichier de code perso/inc_menu.html.
 La première étape consiste à rajouter le code suivant dans le fichier config/mes_options.php :
define('_PERSO_MENU_PAGES_SPECIALES_FIN', 'perso/inc_menu');
La deuxième étape consiste bien entendu à créer le fichier inc_menu.html dans le dossier squelettes/perso/.
 On va donc ajouter une entrée de menu nommée « Documentation SPIP » permettant de nous renvoyer vers le site de SPIP.net. Le plus important dans ce cas est de suivre la logique de construction de menu qui est assez compliquée car elle nécessite d'utiliser les bons CSS mais aussi les paramètres d'environnement du pipeline :
[(#REM)  ]

[ class="(#ENV{classe_li})"]>
 [(#ENV{position}|=={bandeau_bas}|oui)[ id="mh_n(#ENV{no_menu})"]] href="http://www.sarka-spip.net/"><:sarkaspip:doc_spip:>



[(#REM)  ]

#SET{no_menu, #GET{no_menu}|plus{1}}
 Télécharger
Pour parfaire l'affichage, il est nécessaire de créer un item de langue <:sarkaspip:doc_spip:> dans le fichier lang/local_fr.php. On obtient alors un menu des pages spéciales avec une entrée supplémentaire comme illustré ci-dessous qui peut aussi s'afficher dans le bandeau de façon parfaite :
    
 Diagnostiquer et corriger les erreurs
Ce type de personnalisation n'est pas anodine. Elle demande de connaître un minimum de rudiments de codage HTML/CSS ainsi que la structure d'un fichier PHP pour créer config/mes_options.php.
 Certaines erreurs de syntaxe pourront être diagnostiquées par SPIP lors de la compilation. Par contre, si vous vous trompez dans la référence du fichier injecté, le squelette vous affichera un message d'erreur avertissant que le fichier est introuvable [1].
     
		
		[1] Fonction disponible à partir de la révision 37167


La structure des noisettes de Sarka-SPIP
_Equipe_ — 2010-04-10T21:30:59Z

		Introduction
Le vocable de noisette est aussi largement répandu que controversé dans la littérature SPIP. A la base, une noisette est une inclusion au sens programmatique du terme, à savoir, un bout de programme réutilisable. Cependant, toute inclusion n'est pas noisette !
 En effet, dans le cadre du squelette, une noisette se matérialise par un bloc standard affiché dans une des zones principales du site. Aujourd'hui seul les zones « Navigation » et « Extra », c'est-à-dire les colonnes, possèdent des noisettes dont la structure est présentée ci-après [1].
 La version actuelle du squelette possède un répertoire noisettes/ qui contient en fait toutes les inclusions dont certaines représentent effectivement des noisettes. La prochaine évolution du squelette permettra de mieux distinguer les « vraies » noisettes.
 Conteneur standard des noisettes
Toute noisette de Sarka-SPIP est incluse dans bloc standard de type 
 dont les caractéristiques principales sont :
  la largeur correspond à celle de la zone parente « Navigation » ou « Extra », soit 180 pixels
 la marge basse, à savoir, le margin-bottom, est de 15 pixels, toutes les autres marges étant à zéro. Cela permet de positionner les noisettes les unes sous les autres en s'assurant qu'elles soient correctement espacées.
    
Le conteneur englobant la noisette possède donc toujours la classe CSS « noisette ». Mais afin de distinguer une noisette d'une autre et éventuellement les styler différemment, on rajoute systématiquement :
  soit un id, comme « noisette_statistiques » pour la noisette des statistiques
 soit une classe dérivée comme « menu_rub1 » pour le menu des rubriques en version déroulante.
Tous les styles CSS associés aux noisettes de Sarka-SPIP sont regroupés dans le fichier css/noisettes.css.html.
 Contenu standard des noisettes
Si le conteneur de toute noisette est identique, le contenu, lui, peut varier. Cependant, il existe quelques structures standardisées pour afficher du texte, des listes, des titres, des liens...
 Le contenu d'une noisette est en général constitué :
  d'un titre, comme Statistiques ou Agenda
 d'une liste de blocs de contenu dont chacun peut contenir un sous-titre et un bloc de texte.
Cette structure est parfaitement illustrée par la noisette « Statistiques » comme le montre l'illustration ci-dessous :     
 Le titre de la noisette
 Comme illustré ci-dessus, le titre de la noisette est un bloc de classe CSS « intitule ». Ce bloc est matérialisé par une balise 
. Cependant, suivant que ce titre est un lien vers une page du site ou pas le code du titre varie, à savoir :
 

<:sarkaspip:statistiques:>
 Télécharger



 #URL_PAGE{album,id_article=#ID_ARTICLE}">
 <:sarkaspip:album_une:>
 

 Télécharger
Le sous-titre du contenu de la noisette
 De même, le sous-titre du contenu de la noisette est un bloc de classe CSS « titre_bloc ». Ce bloc est matérialisé par une balise 
. Cependant, suivant que ce titre est un lien ou pas le code du titre varie, à savoir :
 

<:sarkaspip:maj:>
 Télécharger



 [#URL_SYNDIC" title="<:sarkaspip:go_syndication:>">
 (#NOM_SITE)
 ]

 Télécharger
Le texte du contenu de la noisette
 Cette portion du contenu de la noisette est en général un bloc de classe « texte » qui peut contenir la plupart des éléments HTML classiques. On obtient un code HTML résultant tel que :
 <div class="texte">
 <p>
 le texte de la noisette avec les balises HTML nécessaires...
 </p>

</div>
 Télécharger
En outre, il est possible aussi de de trouver des blocs de classe « liste » pour des noisettes particulières comme les listes d'articles ou d'autres objets.

C'est le cas, par exemple, de la noisette de navigation dans les articles de la même rubrique, dont le code résultant est du type :
 <div class="liste">
 <ul>
 <li><a title="bulle info" href="url du lien" class="titre">nom du lien</a></li>
 <li><a title="bulle info" href="url du lien" class="titre">nom du lien</a></li>
 <li><a title="bulle info" href="url du lien" class="titre">nom du lien</a></li>
 </ul>

</div>
 Télécharger
Cependant, il est souvent nécessaire de définir des blocs un peu moins standard. C'est le cas de beaucoup de noisettes de Sarka-SPIP. Aussi, pour reproduire une noisette donnée, en plus de lire cet article, il est donc conseillé de consulter la structure exacte de la noisette modèle.
 Composition des blocs
 Tous les blocs décrits précédemment ne sont pas obligatoires. Il est possible de les composer à loisir à partir du moment où l'on respecte leur inclusion dans le conteneur « noisette ». C'est, par exemple, le cas de la noisette « Sites favoris » qui ne contient pas de sous-titre ou des menus qui ne possèdent pas de titre.
		
		[1] Dans un futur proche, la partie centrale du site possèdera aussi son lot de noisettes


Créer les mots-clés utiles au squelette
_Equipe_ — 2010-04-01T21:17:34Z

		Introduction
Depuis la version 3, la plupart des mots-clés utilisés dans la version 2 ont été remplacés avantageusement par de la configuration. Cependant, il est encore nécessaire d'utiliser des mots-clés pour activer les fonctions suivantes :
  le Top Album, présenté dans la noisette splickrbox,
 l'article en Une, exposé sur la page d'accueil.
Créer le groupe de mots-clés
Les mots-clés nécessaires au squelette doivent appartenir à un groupe nommé squelette_habillage. Pour créer ce groupe, il est nécessaire de se rendre dans l'espace privé, de cliquer sur l'entrée « Mots-clés » du menu « Edition » puis sur le bouton « Créer un nouveau groupe de mots ».
 Après avoir nommé le groupe squelette_habillage et éventuellement saisi un texte explicatif, il faut positionner les options complémentaires, à savoir :
  les objets pouvant être associés. A minima le squelette nécessite de pouvoir associer les mots-clés à des articles
 les auteurs autorisés à les attribuer. Il est préférable de limiter cette option aux administrateurs.
Ce groupe de mot-clé est géré de façon spéciale par le squelette. Il est exclu de tous les affichages de mots-clés - comme le nuage - et de toutes les recherches par mots-clés car il n'a pas de réalité éditoriale. Vous pouvez donc l'utiliser pour y insérer vos propres mots-clés utilisés dans vos développements personnalisés.
 Créer les mots-clés
Dans le bloc du groupe, il faut cliquer sur le bouton « Créer un nouveau mot-clé » et remplir le nom et éventuellement le texte. Les deux mots-clés à créer sont :
  album_une, pour choisir le Top Album présenté dans la noisette splickrbox
 article_une, pour désigner l'article en Une sur la page d'accueil.
    


Les pipelines de Sarka-SPIP
_Equipe_ — 2010-03-30T20:31:35Z

		Introduction
Les pipelines de Sarka-SPIP ont pour but de faciliter la personnalisation du squelette en autorisant l'ajout de noisettes à des endroits précis sans modifier les fichiers source du dit squelette. Cette fonctionnalité est disponible depuis la version 3.0.1 de Sarka-SPIP mais a été fortement améliorée dans la version 3.0.2.
 Un pipeline est un point d'entrée dans le code d'un programme. Ce point d'entrée autorise l'injection d'un code externe au programme source. Le code injecté reçoit le contexte du programme offrant le pipeline.
 Dans Sarka-SPIP, tous les pipelines sont situés dans les zones principales du squelette, à savoir, le bandeau, le pied de page et les deux colonnes. La position de ces pipelines est définie une fois pour toute dans le squelette : la personnalisation induite est donc limitée à ces emplacements spécifiques.
 Mise en œuvre dans le squelette
D'un point de vue technique, les pipelines sont matérialisés par un appel à la balise #PIPELINE dans le code HTML du squelette comme l'illustre le code ci-dessous inclus dans le fichier noisettes/navigation/inc_menu_pages_speciales.html :
 [(#PIPELINE{
 menu_pages_speciales_fin,
 [(#ARRAY{args, [(#ARRAY{position, #ENV{position}, classe_li, #GET{classe_li}, no_menu, #GET{no_menu}})], data, ''})]}

)]
 Télécharger
Le premier argument désigne l'identifiant du pipeline, menu_pages_speciales_fin. Cet exemple concerne donc le pipeline permettant d'ajouter une entrée à la fin du menu des pages spéciales.
 Le second argument est le contexte, c'est-à-dire un tableau de tous les paramètres fournis en entrée du script appelé. Dans notre exemple, les paramètres disponibles sont « position », « classe_li » et « no_menu ». Le script appelé pourra utiliser ces paramètres via la balise #ENV de la manière suivante : #ENV{position}.
 Description des pipelines
Le tableau ci-après liste tous les pipelines proposés par le squelette, leur identifiant, la position dans la page et le contexte.
 
Position Identifiant Contexte


Ajout en début de colonne extra
_PERSO_COLONNE_EXTRA_DEBUT
dépend de la page affichée

Ajout en fin de colonne extra
_PERSO_COLONNE_EXTRA_FIN
dépend de la page affichée

Ajout en début de colonne navigation
_PERSO_COLONNE_NAVIGATION_DEBUT
dépend de la page affichée

Ajout en fin de colonne navigation
_PERSO_COLONNE_NAVIGATION_FIN
dépend de la page affichée

Ajout en fin du menu des pages spéciales
_PERSO_MENU_PAGES_SPECIALES_FIN
position, classe_li, no_menu

Ajout en début de la partie haute du bandeau
_PERSO_BANDEAU_HAUT_DEBUT
id_rubrique

Ajout en fin de la partie haute du bandeau
_PERSO_BANDEAU_HAUT_FIN
id_rubrique

Ajout en début de la partie basse du bandeau
_PERSO_BANDEAU_BAS_DEBUT
id_rubrique

Ajout en fin de la partie basse du bandeau
_PERSO_BANDEAU_BAS_FIN
id_rubrique

Ajout en début de pied
_PERSO_PIED_DEBUT
-

Ajout en fin de pied
_PERSO_PIED_FIN
-


Utilisation des pipelines
Pour utiliser les pipelines et personnaliser le squelette il est nécessaire de déclarer les pipelines utilisés et les noisettes ajoutées dans le fichier mes_options.php en suivant la syntaxe ci-dessous :
 define('_PERSO_COLONNE_EXTRA_DEBUT', 'noisettes/extra/noisette1:noisettes/noisette2:noisette3');
Dans l'exemple ci-dessus, les noisettes seront insérées dans l'ordre prescrit - de 1 à 3 - au début de la colonne « Extra ». Le chemin des noisettes est relatif au répertoire squelettes/ dans lequel elles doivent être placées mais l'arborescence sous squelettes/ est à votre discrétion. L'extension des noisettes n'est pas précisée car ce sont toujours des fichiers .html.
 Les noisettes sont des fichiers dont la structure est normalisée par le squelette Sarka-SPIP. Il est donc essentiel de conserver cette structure pour créer des noisettes personnalisées cohérentes avec le design du site. Consulter l'article La structure des noisettes de Sarka-SPIP à cet effet.


Créer un thème
_Equipe_ — 2010-03-28T16:23:28Z

		Introduction
La version 3 de Sarka-SPIP permet aujourd'hui d'utiliser des thèmes pour simplifier la personnalisation. Il est en outre aisé de créer des thèmes en utilisant la puissance de l'interface de configuration du squelette, sans écrire une ligne de code - ou presque - et en se consacrant uniquement au design.
 Il est cependant recommandé de connaître a minima les propriétés CSS relatives aux images d'arrière plan dont vous trouverez un résumé dans l'article Config Sarka/styles - case propriétés des arrières-plan sur le site de Shizuka.
 Préliminaires
Même si vous êtes impatient de commencer, nous vous recommandons de suivre les étapes suivantes :
  Lire l'article Un thème Sarka-SPIP : c'est quoi ? pour comprendre la structure d'un thème.
 Réfléchir au style que vous souhaitez donner à votre site en fonction de vos goûts, du sujet et du public visé ? Très graphique, dépouillé, fantaisiste ou plus formel ... ? 
 Définir votre jeu de couleurs : pastel, chaudes, froides, contrastées, sombres ... ?
 Définir votre layout, fluide ou fixe ?
 Etablir un petit croquis sur papier libre et/ou faire une maquette sur un logiciel comme Gimp, Fireworks, Photoshop...
Il est utile parfois de s'inspirer de sites dont vous appréciez le graphisme (en respectant bien sûr les droits d'auteurs et les licences d'utilisation). Il existe aussi des sites qui propose des thèmes libres tels :
  http://www.opendesigns.org/
 http://wordpress.org/extend/themes/
 http://themes.dotaddict.org/
Il faudra bien entendu les adapter au squelette mais il est aisé de réutiliser la même palette de couleurs voire les images de fond. Concernant les couleurs une liste d'outils en ligne est disponible sur le site de Shizuka dans la rubrique Palette graphique
 Installation du kit de démarrage
Le but de ce kit est d'installer une ossature de base, répertoires et fichiers, constituant un thème vide mais fonctionnel, au sens de Zen Garden, et prêt à être personnalisé. Ce kit est à installer dans le dossier themes/.
 Pour ce faire, copier l'archive jointe sarkaspip_nomdutheme.zip dans le répertoire themes/ et la dézipper. Le résultat obtenu est le suivant :
    
 Ensuite, renommer le dossier sarkaspip_nomdutheme/ en remplaçant « nomdutheme » par le nom de votre choix mais en laissant le préfixe « sarkaspip » pour bien identifier ces thèmes de ceux de ZPIP, par exemple.
 Activation du thème de démarrage
Pour admirer les futures personnalisations graphiques du thème à développer, il est nécessaire d'activer le thème correspondant au kit de démarrage dans l'interface privée de Zen Garden.
    
 A ce stade, tout est prêt pour commencer à développer le thème en visualisant à chaque étape les modifications effectuées.
 Description du thème
La première chose est d'améliorer la description du thème visible dans l'interface de Zen Garden. Le nom, le descriptif, l'auteur, la licence sont autant de champs qu'il faut remplir de façon précise pour informer au mieux les futurs utilisateurs.
 Pour ce faire, éditer le fichier plugin.xml en prenant garde de respecter la syntaxe XML et l'écriture des caractères accentués et spéciaux avec des entités HTML. L'image ci-dessous illustre le fichier plugin.xml tel que fourni dans le kit.     
 Il est important, par contre, de ne pas toucher aux balises définissant le préfixe, la catégorie et l'utilisation limitée au squelette Sarka-SPIP et dans une moindre mesure au nom de la vignette sauf si vous souhaitez utiliser un autre format. Pour les autres champs, vous pouvez rectifier à tout moment les informations saisies si celles-ci se révèlent erronées ou incomplètes.
 Définition des éléments graphiques du thème
La configuration du squelette
 La première étape dans la construction graphique du thème consiste à utiliser l'outil de configuration du squelette. En effet, la base d'un thème Sarka-SPIP est constituée par le paramétrage des pages de configuration :
  « Layout », « Bandeau » et « Pied de page », qui définissent l'agencement des zones du squelette ainsi que les blocs visibles dans chacune de ces zones
 « Styles », qui définit couleurs, décorations et images de fond
 « Coins arrondis », qui permet d'arrondir certains blocs sans utiliser les CSS. Néanmoins, il est recommandé de ne pas utiliser cette fonction sachant que la méthode choisie pose des problèmes sur certains navigateurs.
Seuls les éléments structurant ont un intérêt à être défini, comme le layout, l'affichage du bloc bandeau haut ou bandeau bas, l'affichage du pied de page...

Par contre, fixer le titre du site, l'affichage du menu des pages spéciales dans le bandeau, les informations du pied de page n'a aucun intérêt car les utilisateurs doivent avoir le choix de ces paramètres : il est donc conseillé de laisser les valeurs par défaut pour ces paramètres.
 Ensuite, le plus gros du travail consiste à configurer les couleurs, les décorations et autres images de fond via la page de configuration « Styles ». Pour être prises en compte, les images de fond doivent être placées dans themes/nom_du_theme/images/.
 Attention, n'oubliez pas de sauvegarder régulièrement vos modifications des pages de configuration - via la page de « Maintenance » - pour éviter de recommencer votre travail en cas de manipulation erronée.
 Le jeu d'icônes
 La deuxième étape consiste à adapter l'iconographie du squelette au thème : favicon, puces, boutons... Sarka-SPIP propose en standard un jeu d'icônes décliné dans 11 couleurs différentes : mais rien ne vous interdit d'en créer d'autres, voire de les proposer pour enrichir la collection actuelle.
 Bien entendu, ces icônes doivent être déposés dans le dossier themes/nom_du_theme/images/.
 Transfert de la configuration dans le thème
Sauvegarde de la configuration
 Une fois que le configuration du thème est figée, il est nécessaire de l'importer dans le dossier du thème en cours de construction. En effet, à chaque fois que l'on enregistre une page de configuration, les valeurs sont stockées en base de données. Pour un thème, la configuration est stockée dans des fichiers.
 Pour ce faire, il faut tout d'abord se rendre dans la page « Maintenance » et faire une sauvegarde complète ou du moins des pages de configuration « Layout », « Bandeau », « Pied de page », « Styles » et « Coins arrondis ». Vous obtenez des fichiers texte qui contiennent toutes vos valeurs de configuration, stockés dans des dossiers tmp/cfg/sarkaspip_nomdepage/ et nommés sarkaspip_nomdepage_date_heure.txt.
    
 Copie et renommage
 Ensuite, il suffit de copier la dernière sauvegarde des cinq fichiers cités ci-dessus dans le dossier idoine du thème, à a savoir, themes/sarkaspip_nomdutheme/cfg/ en renommant les fichiers de façon à supprimer la date et heure comme illustrés dans l'image ci-après.
    
 Définition du copyleft
Pour conclure la création du thème, il ne reste plus qu'à choisir la licence du thème et les éventuels crédits que vous souhaitez afficher dans le pied de page. Le kit de démarrage inclus le fichier noisettes/pied/inc_pied_habillage.html avec un affichage par défaut. Pour apposer votre signature d'artiste et la mention souhaitée éditez et modifiez ce fichier en respectant la syntaxe HTML.
 Publication du thème
Si vous souhaitez partager votre thème et en faire profiter toute la communauté vous pouvez, soit le déposer sur la Zone avec l'outil SVN, soit envoyer votre zip complet à l'un des membres de l'équipe afin que nous le faisions pour vous. Le thème sera alors intégré à la liste des thèmes Sarka-SPIP publiée sur ce site et sur SPIP-Contrib.


Mars... et ça repart !
_Eric_ — 2010-03-21T16:34:43Z
Le printemps c'est le retour des oiseaux, des bourgeons, des fleurs et aussi... des nouveautés Sarka-SPIP. Et pas qu'une seule !
 Ce week-end a été l'occasion de deux sorties majeures :
  Une nouvelle version de lignée Sarka-SPIP 3.0, la 3.0.3 dont le zip est déjà disponible sur ce site et aussi sur Files. Les nouveautés sont décrites dans l'article Quoi de neuf dans Sarka-SPIP 3.0.3 ? mais cette version est d'ores et déjà compatible avec SPIP 2.1 !
 Un nouveau thème de saison concocté par Shizuka et en démonstration sur notre site.
Comme d'habitude, le zip sarkaspip_30_encours.zip, contiendra les corrections de la version 3.0.3.
 Pendant ce temps, je continue à développer la nouvelle lignée 3.1. Le contour technique n'est pas encore décidé mais les réflexions tournent actuellement autour de Z, Compositions et du Noisetier. Concernant le nouveau forum, il est aussi prévu d'être inclus dans cette lignée mais étant donné que les ambitions de celle-ci grandissent de jour en jour, je finirais peut-être par l'intégrer dans la prochaine version 3.0.4...
 Wait and see.
		Nous cherchons toujours à recruter des bonnes volontés pour créer des thèmes, écrire de la documentation et animer le site. Avis aux amateurs !

Position	Identifiant	Contexte
Ajout en début de colonne extra	_PERSO_COLONNE_EXTRA_DEBUT	dépend de la page affichée
Ajout en fin de colonne extra	_PERSO_COLONNE_EXTRA_FIN	dépend de la page affichée
Ajout en début de colonne navigation	_PERSO_COLONNE_NAVIGATION_DEBUT	dépend de la page affichée
Ajout en fin de colonne navigation	_PERSO_COLONNE_NAVIGATION_FIN	dépend de la page affichée
Ajout en fin du menu des pages spéciales	_PERSO_MENU_PAGES_SPECIALES_FIN	position, classe_li, no_menu
Ajout en début de la partie haute du bandeau	_PERSO_BANDEAU_HAUT_DEBUT	id_rubrique
Ajout en fin de la partie haute du bandeau	_PERSO_BANDEAU_HAUT_FIN	id_rubrique
Ajout en début de la partie basse du bandeau	_PERSO_BANDEAU_BAS_DEBUT	id_rubrique
Ajout en fin de la partie basse du bandeau	_PERSO_BANDEAU_BAS_FIN	id_rubrique
Ajout en début de pied	_PERSO_PIED_DEBUT	-
Ajout en fin de pied	_PERSO_PIED_FIN	-

Sarka-SPIP

Bug SPIP du 3 septembre 2010

Sarka-SPIP, une reprise en douceur !

Utiliser correctement la typographie de SPIP

Paragraphes

Un intertitre normal

Hyperliens

Listes

Tableaux

Citations

À éviter

This is the end...

Utiliser les pipelines

Introduction

Personnaliser le pied de page

Ajouter une noisette en haut de la colonne « Extra »

<:sarkaspip:titre_traduction:>

Ajouter une entrée au menu des pages spéciales

Diagnostiquer et corriger les erreurs

La structure des noisettes de Sarka-SPIP

Introduction

Conteneur standard des noisettes

Contenu standard des noisettes

<:sarkaspip:statistiques:>

#URL_PAGE{album,id_article=#ID_ARTICLE}"> <:sarkaspip:album_une:>

<:sarkaspip:maj:>

[#URL_SYNDIC" title="<:sarkaspip:go_syndication:>"> (#NOM_SITE) ]

Créer les mots-clés utiles au squelette

Introduction

Créer le groupe de mots-clés

Créer les mots-clés

Les pipelines de Sarka-SPIP

Introduction

Mise en œuvre dans le squelette

Description des pipelines

Utilisation des pipelines

Créer un thème

Introduction

Préliminaires

Installation du kit de démarrage

Activation du thème de démarrage

Description du thème

Définition des éléments graphiques du thème

Transfert de la configuration dans le thème

Définition du copyleft

Publication du thème

Mars... et ça repart !

#URL_PAGE{album,id_article=#ID_ARTICLE}">
<:sarkaspip:album_une:>

[#URL_SYNDIC" title="<:sarkaspip:go_syndication:>">
(#NOM_SITE)
]