Home

PDF – 3.3 Mo - SPIP

1. Certaines inclusions peuvent d pendre du contexte Par exemple imaginons un squelette hierarchie qui affiche le chemin menant une rubrique depuis la racine du site on appelerait cette page par une URL de la forme lt hierarchie php3 id_rubrique xxx Dans les squelettes voulant afficher la hi rarchie partir de la rubrique courante il faut donc indiquer que le param tre concern est id_rubrique si n cessaire on aura cr une boucle permettant de r cup rer le num ro de la rubrique concern e et on installera le code suivant l int rieur de cette boucle lt INCLUREhierarchie php3 id rubrique gt Note dans ce cas le squelette hierarchie html commencera certainement par une boucle rubriques avec le crit re id rubrique On peut imaginer que dans certains squelettes on d sire r cup rer non pas la hi rarchie en fonction d une rubrique variable au gr du contexte par exemple le param tre pass dans l URL mais en fonction d une rubrique dont on conna t l avance le num ro Pour cela on peut fixer la valeur du param tre ainsi lt INCLURE hierarchie php3 id_rubrique 5 gt N B Il est possible d indiquer plusieurs param tres dans la balise lt INCLURE gt cependant ce cas est tr s rare en pratique Evitez d ajouter des param tres inutiles qui rendront le cache moins efficace et votre site plus lent N B Le fichier inclus tant lui m me un squelette il
2. HSURTITRE retourne le surtitre TITRE retourne le titre de l article HSOUSTITRE retourne le soustitre H DESCRIPTIF retourne le descriptif CHAPO retourne le texte d introduction chapeau TEXTE retourne le texte principal de l article PS retourne le post scriptum Les dates DATE DATE_ REDAC DATE_ MODIF sont explicit es dans la documentation sur La gestion des dates HID_RUBRIQUE est l identifiant de la rubrique dont d pend l article HID_ SECTEUR est l identifiant du secteur dont d pend l article le secteur tant la rubrique situ e la racine du site HNOM SITE et URL_SITE correspondent aux donn es du lien hypertexte de l article si vous avez activ cette option HVISITES est le nombre de visites sur cet article HPOPULARITE donne le pourcentage de popularit de cet article voir la documentation La popularit des articles LANG donne la langue de cet article Les balises calcul es par SPIP Les l ments suivants sont calcul s par SPIP Ils ne peuvent pas tre utilis s comme crit re de classement http www spip net fr_article902 html 4 of 6 2006 04 17 19 10 42 SPIP La boucle ARTICLES NOTES les notes de bas de page calcul es partir de l analyse du texte HINTRODUCTION SPIP 1 4 si l article contient un descriptif c est celui ci qui est utilis ici sinon SPIP affiche les 600 premiers caract res
3. par num crit re Par exemple lt BOUCLE_articles ARTICLES id_rubrique affiche les articles d une rubrique class s selon l ordre chronologique invers les plus r cents au d but les plus anciens la fin et lt BOUCLE_articles ARTICLES id_rubrique les affiche selon l ordre alphab tique de leur titre enfin lt BOUCLE_articles ARTICLES id_rubrique les affiche selon l ordre du num ro de leur titre remarque l option par num titre ne fonctionne pas pour les plus anciennes versions de MySQL ant rieures la version 3 23 Classer selon plusieurs crit res A partir de SPIP 1 8 on peut classer selon plusieurs crit res par crit rel crit re2 Onindique ainsi des ordres de classement cons cutifs Les r sultats seront d abord tri s selon le crit rel puis le crit re pour les r sultats ayant le m me crit rel On peut sp cifier autant de crit res que nescessaire Par exemple par date titre trierales r sultats par date puis les r sultats ayant la m me date seront tri s par titre Avec SPIP 1 8 2 on peut sp cifier plusieurs crit res par pour une boucle pour arriver au m me r sultat Par exemple par date par titre est quivalent l exemple pr c dent http www spip net fr_article900 html 2 of 8 2006 04 17 19 13 8 SPIP Les crit res communs toutes les boucles Remarque Quand on utilise plusieurs crit res de tri le crit re inverse ne
4. er Fe z aia boucl elle m me reproduit la boucle x qui contient la boucle n et ainsi de suite jusqu SIGNATURES ce que la boucle x ne donne plus aucun r sultat m La boucle HIERARCHIE Cette technique permet de cr er notamment l affichage des thread des forums m Les crit res Cela devient tr s simple une premi re boucle fabrique l entr e des threads nn a toutes Jes messages qui r pondent directement un article une seconde boucle affiche es boucIes 7 4 7 eZ les r ponses ces messages et une boucle r cursive provoque la r cursivit sur m Les balises res eu sie cette seconde boucle m Les formulaires m Les boucles de lt BOUCLE_forum FORUMS id_article gt recherche lt p gt TITRE m Les filtres de lt B_reponses gt SPIP lt UL gt m Les boucles lt BOUCLE_reponses FORUMS id_parent r cursives z E La popularit LIS TITRE des articles lt BOUCLE recursive boucle reponses gt m La gestion des lt BOUCLE _recursive gt dates lt BOUCLE_reponses gt m Exposer un lt UL gt article dans une liste On peut ainsi en tr s peu de lignes provoquer l affichage de l int gralit de la structure rubriques sous rubriques du site http www spip net fr_article914 html 2 of 2 2006 04 17 19 15 26 SPIP La popularit des articles E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle
5. gamma Gamma varphi centrer des formules complexes MAIS LAIT d n AN er anaal fun dN AA m ne one mm em lun m Le syst me est limit l affichage de formules math matiques De ce fait toutes les autres fonctions de TEX sont d sactiv es Parmi la plus importante interdiction il n est pas possible de d finir ses propres macros def est d sactiv et les macros utilis es en dehors des formules math matiques ne seront pas reconnues l usage on trouvera d autres limitations en se souvenant toujours que le but est d int grer des formules math matiques dans ses textes et rien de plus http www spip net fr_article3016 html 3 of 4 2006 04 17 19 23 30 SPIP Ins rer des formules math matiques en LATEX Pour les webmestres Le traitement des quations se fait sur le mode client serveur les formules sont envoy es un serveur centralis qui retourne votre site les fichiers graphiques de ces quations videmment les fichiers sont sauvegard s sur votre syst me et l change n a lieu qu une seule fois par quation Pour plus d informations sur le syst me utilis vous pouvez consulter la page du Wiki de SPTP Vous y trouverez notamment les explications pour monter votre propre serveur d quations afin de ne plus d pendre de notre serveur central SN http www spip net fr_article3016 html 4 of 4 2006 04 17 19 23 30 SPIP SPIP 1 8 l interface graphique m S
6. PHP majuscules s applique galement aux lettres accentu es justifier fait passer le texte en justification totale lt P align justify gt aligner droite fait passer le texte en justification droite lt P align right gt aligner_gauche fait passer le texte en justification gauche lt P align left gt centrer centre le texte lt P align center gt Les filtres des dates Les filtres suivants s appliquent aux dates DATE affdate par exemple affdate affiche la date sous forme de texte par exemple 13 janvier 2001 SPIP 1 8 tend la notation de ce filtre On peut lui passer un param tre de formatage de la date correspondant un format spip saison etc ou un format de la commande php date Y m a Par exemple e DATEl affdate Y m affichera num riquement l ann e et le mois de la date filtr e s par s par un tiret e lanotation DATE affdate saison esttotalement quivalente DATE saison Il existe aussi des variantes de affdate qui fournissent des raccourcis affdate_ jourcourt affiche le nom du mois et la valeur num rique du jour e g 19 Avril Si la date n est pas dans l ann e actuelle alors l ann e est aussi affich e 1 Novembre 2004 affdate_ court affiche le nom du mois et le num ros du jour e g 19 Avril Si la date n est pas dans l ann e actuelle alors on affiche seulement le mois et l
7. Spip et les feuilles de style a lt INCLURE gt d autres squelettes a R aliser un site multilingue Internationaliser les squelettes Utiliser des URLS personnalis es Le moteur de recherche Les variables de personnalisation a Tidy validation XHTML 1 0 m Le support LDAP Le traitement des images a Ins rer des formules math matiques en LaTEX a SPIP 1 8 l interface graphique Le calendrier de SPIP 1 8 2 http www spip net fr_rubrique257 html 1 of 2 2006 04 17 19 20 44 SPIP Guide des fonctions avanc es squelettes m Principe g n ral m lt INCLURE gt d autres squelettes Les balises propres au site m La boucle ARTICLES m SPIP 1 8 3 m Les filtres de SPIP m Traitement automatis des images m Images typographiques a Images typographiques Titres graphiques avec la police de son choix a Couleurs automatiques Traitement automatis des images La structure de la base de donn es http www spip net fr_rubrique257 html 2 of 2 2006 04 17 19 20 44 SPIP Spip et les feuilles de style m Spip et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue E nternationaliser les squelettes E Utiliser des URLS personnalis es m Le moteur de recherche m Les variables de personnalisation m Tidy validation XHTML 1 0 m Le support LDAP m Le traitement des images m Ins rer des formules math matiques en LaTEX m SPIP 1 8 l in
8. http www spip net fr_article1054 html 1 of 3 2006 04 17 2 23 28 SPIP FAQ webmestre en convaincre Il est donc dommage de garder la mise en page d origine m me si celle ci est tr s utile pour se mettre le pied l trier 2 Est il possible d crire ces squelettes soi m me Oui c est un des int r ts majeurs de SPIP Pour cela allez voir le tutorial pour comprendre les bases de la programmation des squelettes le manuel de r f rence qui liste toutes les possibilit s de programmation 3 Je ne sais pas ne veux pas apprendre programmer Peut on utiliser des mises en pages d j existantes Oui En dehors de la mise en page par d faut d autres jeux de squelettes sont disponibles sur le site des contributions SPIP dans la rubrique Squelettes Il suffit en g n ral de r cup rer l archive voulue le fichier au format zip ou tar gz au choix de la d compresser chez vous et de transf rer son contenu par FTP la racine de votre site SPIP Vous pouvez faire une sauvegarde de vos fichiers html actuels au cas o vous voulez revenir en arri re 4 Il n y a pas beaucoup de jeux de squelettes disponibles Pourquoi Ces jeux de squelettes sont aliment s par les webmestres SPIP qui nous fournissent leurs cr ations Nous comptons donc sur les webmestres pour compl ter cette base de squelettes afin d encourager l entraide et la richesse des sites SPIP cf section Partager plus
9. http www spip net fr_article1846 html 1 of 3 2006 04 17 19 15 42 SPIP La popularit des articles DOCUMENTS m La boucle SYNDIC_ ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives E La popularit des articles m La gestion des dates m Exposer un article dans une liste point si c est un article que l on consulte depuis le site lui m me en suivant un lien et 2 points si c est une entr e directe depuis un site ext rieur moteur de recherche lien hypertexte syndication toutes les 10 minutes le score obtenu est multipli par un petit facteur d escompte qui fait qu un point attribu par une visite 10h12 le mercredi ne vaut plus le lendemain la m me heure qu un demi point et le vendredi 10h12 un quart de point le tout est calcul de mani re ce que dans l hypoth se o l article re oit toujours le m me nombre x de visites par unit de temps son score se stabilise sur cette valeur x Autrement dit si la fr quentation de l article est stationnaire sa popularit finira par refl ter exactement son nombre de visites par jour modulo le score 2 donn pour les entr es directes cette popularit s exprime de deux mani res l une la popularit absolue exprime l
10. l int rieur de la boucle MOTS vous pouvez utiliser TYPE pour afficher cette valeur http www spip net fr_article909 html 3 of 3 2006 04 17 19 11 38 SPIP La boucle SITES ou SYNDICATION E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle DOCUMENTS Pars m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La boucle SITES ou SYNDICATION m fran ais m catal m Deutsch m English m Espa ol w italiano La boucle SITES SPIP 1 3 retourne une liste de sites r f renc s Si l on a syndiqu des sites r f renc s cette boucle s utilise naturellement associ e une boucle SYNDIC_ARTICLES qui permet de r cup rer la liste des article de ces sites lt BOUCLEN SITES crit res gt Avant la version 1 3 de SPTP cette boucle tait nomm e SYNDICATION car seuls des sites syndiqu s pouvaient tre r f renc s Les deux d nominations sont rigoureusement quivalentes mais SITES correspond mieux au fait que depuis la version 1 3 il s agit d un syst me de r f rencement de sites la syndication tant une option lt BOUCLEn SYNDICATION
11. Date de naissance Ville Jacques 5 10 1970 Paris Claire 12 2 1975 Belfort Martin 1 31 1957 Nice Marie 23 12 1948 Perpignan Nom Date ie Ville naissance Jacques 5 10 1970 Paris http www spip net fr_article1177 html 4 of 8 2006 04 17 19 21 0 SPIP Spip et les feuilles de style Claire 12 2 1975 Belfort Martin 1 31 1957 Nice Marie 23 12 1948 Perpignan Les feuilles de style permettent de param trer finement l affichage de tels tableaux table spip table spip tr row_ first background color FCF4D0 table spip tr row_odd background color HCOCOC0 table spip tr row_even background color FOFOFO table spip td padding 1px text align left vertical alian center table spip permet de modifier le comportement g n ral du tableau notamment sa position gauche centr table spip tr row first d finit le comportement de la premi re ligne du tableau ici en jaune pour que la premi re ligne soit prise en compte il faut que les l ments qu elle contient soient plac s en gras table spip tr row_odd pour les lignes impaires table spip tr row_even pour les lignes paires table spip td permet de modifier le comportement des cases du tableau Un des int r ts repose sur le choix de couleurs diff rentes pour row_ odd et row _ even permettant de faire une pr sentation de couleurs alter
12. Il n y a pas d article Ily a un seul article dans cette rubrique Dans ce cas tr s simplement la page HTML est construite sur le mod le de la boucle e Titre de l article e Sous titre e Texte de l article Il y a plusieurs articles dans cette rubrique La description de la mise en page placer ici va alors tre calcul e successivement pour chacun des articles Ce qui donne simplement e Titre de l article 1 e Sous titre de l article 1 e Texte de l article 1 e Titre de l article 2 Sous titre de l article 2 http www spip net fr_article894 html 3 of 4 2006 04 17 19 10 0 SPIP Des boucles et des balises e Texte de l article 2 e Titre du dernier article e Sous titre du dernier article e Texte du dernier article La suite de ce guide de r f rence se construira donc de la mani re suivante syntaxe g n rale des boucles syntaxe g n rale des balises de SPIP et ensuite une page sp cifique chaque type de boucles indiquant quelles balises on peut y utiliser http www spip net fr_article894 html 4 of 4 2006 04 17 19 10 0 SPIP La syntaxe des boucles E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle m SPIP syst
13. Il s agit d une s lection sur le t i t re selon une expression r guli re indique une s lection selon une expression r guli re dont la syntaxe est au d but du titre indique le d but de la cha ne test e il y a un ou plusieurs indique au moins un des caract res pr c dents caract res compris entre 0 et 9 0 9 signifie caract res compris entre 0 et 9 inclus suivis du caract re point Notez enfin qu on ne s lectionne qu un seul article ainsi num rot 0 1 de cette fa on l int rieur de la boucle ne sera effectu qu une seule fois De plus il suffit qu il existe un seul article num rot pour provoquer l affichage d une liste par ordre num rot Cette boucle affiche ainsi Il existe un article num rot dans cette rubrique s il y a au moins un article dont le titre est pr c d d un num ro dans la rubrique et Il n y a pas d article num rot sinon Il suffit maintenant d installer la place de ces mentions des boucles d affichage des articles selon l ordre de pr sentation d sir lt BOUCLE test numero ARTICLES id_rubrique titre 1 0 9 0 1 gt lt BOUCLE_ ordre numeros ARTICLES id_rubrique par num titre gt lt li gt TITRE supprimer_numero lt BOUCLE _ ordre numeros gt lt BOUCLE test _numero gt lt BOUCLE_ ordre _date ARTICLES lid mibrianlfnmer Adntallinunrnanl h
14. Si cette balise n est pas pr sente sur le site le moteur de SPIP effectue ses calculs en temps utile apr s avoir envoy une page un visiteur malheureusement php ne permet pas de fermer la connexion la fin de la page et dans certains cas cela peut conduire certains visiteurs malchanceux ceux dont le passage d clenche une proc dure un peu longue notamment la syndication constater une certaine lenteur dans l affichage de la page demand e La balise SPIP_CRON permet de contourner ce probl me son r le est de g n rer un marqueur lt div gt invisible dont la propri t background pointe sur le script spip_background php3 ce script son tour effectue les calculs n cessaires en t che de fond et renvoie une image transparente de 1x1 pixel Cette astuce permet donc d viter tout sentiment de ralentissement en d portant les ventuelles lenteurs sur un script annexe A noter cette balise n est pas strat gique et sa pr sence ou son absence ne modifient en rien la r gularit du calcul des t ches p riodiques du site SAR Aeg AR http www spip net fr_article1902 html 4 of 4 2006 04 17 19 13 23 SPIP Les formulaires E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou
15. a pas pu tre test e en situation de production dans SPIP En th orie cela fonctionne mais tout retour d exp rience de la part de webmestres int resse les d veloppeurs sur la liste spip dev Nous avons besoin de retours d exp rience sur les versions 1 et 2 de Tidy c est dire sur des sites en PHP 4 en PHP 5 mais galement des installations via PEAR Tidy comme programme ind pendant Il est par ailleurs possible d utiliser Tidy en ligne de commande c est dire en tant que programme ind pendant de PHP s ex cutant directement sur le serveur Cette version est particuli rement pratique puisque il existe des versions de Tidy d j compil es pour la plupart des syst mes d exploitation il est souvent possible et simple d installer ces versions de Tidy sur un h bergement sans avoir d acc s root certains administrateurs de sites ont subi des incompatibilit s lors de l installation de Tidy en extension PHP avec semble t il ImageMagick la version en ligne de commande ne provoque pas ce genre de probl me Avant toute chose v rifiez que Tidy n est pas d j pr sent sur votre serveur Pour cela installez dans le fichier ecrire mes_options php3 les lignes suivantes define _TIDY COMMAND tidy xhtml true Et v rifiez sur votre site public si les pages sont modifi es soit transform es en XHTML soit affichage du message Erreur tidy Si cela ne fonctionne pas
16. ann e sans le num ros du jour Novembre 2004 affdate mois _ annee affiche seulement le mois et l ann e Avril 2005 Novembre 2003 jour affiche le jour en nombre http www spip net fr_article901 html 2 of 11 2006 04 17 19 14 18 SPIP Les filtres de SPIP mois affiche le mois en nombre annee affiche l ann e SPIP 1 0 2 heures affiche les heures d une date les dates fournies par SPIP contiennent non seulement le jour mais galement les horaires SPIP 1 0 2 minutes affiche les minutes d une date SPIP 1 0 2 secondes affiche les secondes nom_ jour affiche le nom du jour lundi mardi nom_ mois affiche le nom du mois janvier f vrier saison affiche la saison hiver t SPIP 1 8 introduit le filtre unique qui retourne la valeur de l l ment filtr seulement si c est la premi re fois qu elle est rencontr e Ce filtre n est pas limit aux dates mais est int ressant pour par exemple afficher une liste d articles par date lt BOUCLE_ blog ARTICLES par date inverse lt br gt gt lt hr gt lt h1 gt DATE affdate mois annee uniaue lt h1 gt 1 cette balise n affichera la date qu chaque changement de mois Voici un autre exemple lt BOUCLE_ blog2 ARTICLES par date inverse gt lt hr gt lt h1 gt DATE anneelunique lt h1 gt lt h2 DATElaffdate Y m unique nom _mois lt h2 gt 1
17. dans un sens on cherche le second plus r cent des articles age_relatif gt 0 car le plus r cent avec la comparaison non stricte ne peut tre que l article lui m me dans l autre le plus g des articles publi s strictement plus tard Les crit res jour_relatif mois _ relatif et annee relatif fonctionnent comme l age relatif mais prennent en compte des dates arrondies au jour au mois et l ann e respectivement par exemple si l URL comporte la variable date 2003 01 01 la boucle suivante donnera tous les les articles du mois de mars 2003 lt h3 gt Articles de HDATE nom_mois HDATE annee lt h3 gt lt BOUCLE_ blog ARTICLES mois_relatif 0 oar dateH lt br gt gt La date de r daction ant rieure Si vous avez activ l utilisation des dates de publication ant rieure la plupart des http www spip net fr_article1971 html 3 of 4 2006 04 17 19 16 3 SPIP La gestion des dates crit res pr sent s ci dessus fonctionnent il suffit d ajouter _redac au crit re Ainsi age_redac gt 365 affichera les articles dont la date de publication ant rieure remonte plus d un an Si une boucle s lectionne un article dont la date redac est d finie une boucle interne comportant le crit re annee_relatif_redac 0 ira chercher les articles dont la date de publication ant rieure appartient la m me ann e Un exemple de sommaire de site tri par date A titre
18. est pas n cessaire et de limiter les risques d erreurs 1 SPIP propose trois niveaux d interface diff rents pour choisir les langues affect es aux articles et br ves etc par ordre croissant de complexit Par secteur rubrique de premier niveau chaque rubrique de la racine du site correspond une langue modifiable par les administrateurs qui concerne toutes ses sous rubriques ainsi que les articles et les br ves y publi s ce r glage devrait satisfaire les besoins de la plupart des sites multilingues tout en conservant une structure et une interface simples Par rubrique de mani re plus fine avec ce r glage on peut changer la langue pour chacune des rubriques du site pas seulement celles de premier niveau http www spip net fr_article2124 html 2 of 8 2006 04 17 19 21 27 SPIP R aliser un site multilingue Par article la langue peut tre modifi e au niveau de chaque article ce choix est compatible avec les pr c dents on peut par exemple choisir la langue par rubrique mais appliquer des exceptions de ci de l certains articles et permet toutes les finesses imaginables mais attention ne pas produire un site la structure incompr hensible Blocs multilingues SPIP 1 7 2 Certains objets comme les auteurs ou les mots cl s peuvent s orthographier diff remment selon qu ils sont affect s un article dans une langue ou dans une autre Cependant il serait absurde de concevoir d
19. lt math gt Ici on extrait les formules math matiques lt math gt Puisque seules les formules math matiques sont trait es on peut en r alit ajouter lt math gt lt math gt de mani re tr s large en clair on peut ajouter lt math gt tout au d but du texte et lt math gt tout la fin La seule incompatibilit sera le cas o l on souhaite afficher le symbole dollar dans le texte ce symbole tant utilis pour d limiter les formules C est la raison en r alit de l existence des codes lt math gt lt math gt http www spip net fr_article3016 html 2 of 4 2006 04 17 19 23 30 SPIP Ins rer des formules math matiques en LATEX l int rieur de ces pseudo tags on code ensuite les formules de math matiques selon les normes de TEX en les encadrant de dollars ou de double dollars pour les formules centr es Voici un exemple 100 On peut ins rer des matrices Q a 0 on peut placer des l a fractions telles que T utiliser des lettres grecques T I centrer des formules complexes N 1 1 a N X un Ai y t dt n 1 3 lt Co m que l on pourra coder ainsi On peut ins rer des matrices pmatrix 18 amp 08 amp 0 cr 0 amp a amp 0 cr 0 amp 0 amp b cr on peut placer des fractions telles que 1 over z 1 over displaystyle 1 1 over x utiliser des lettres grecques alpha beta
20. origine transparent selon la m me valeur de transparence Si l image d origine est d j transparente les informations sont m lang es de fa on conserver les deux infos de transparence Si on a le fichier masque suivant nomm decoupel png qu on applique ainsi FICHIER image masque decoupe1 png http www spip net fr_article3327 html 10 of 13 2006 04 17 19 26 49 SPIP Traitement automatis des images on obtient l image suivante L image d origine a t redimensionn e aux dimensions de decoupel png et les zones transparentes du masque sont devenues les zones transparentes du r sultat Masque de luminosit Dans l exemple ci dessus l image masque est enti rement en gris 50 Les couleurs de l image d origine sont alors laiss es inchang es on s est content de d couper l image En faisant varier les couleurs du masque on va appliquer ces diff rences de luminosit l image trait e Lorsqu un pixel du masque est plus clair alors le fichier r sultant est clairci si le pixel du masque est fonc alors on fonce le fichier r sultant Par exemple si notre masque est decoupe2 png http www spip net fr_article3327 html 11 of 13 2006 04 17 19 26 49 SPIP Traitement automatis des images FICHIER image masque decoupe2 png on obtient l image suivante Dans ces deux exemples le masque est plus petit que l image
21. un pense b te pour ne pas se perdre dans le feu de l action http www spip net fr_article2434 html 1 of 2 2006 04 17 19 29 53 SPIP Pour en savoir plus une traduction en fran ais du standard CSS2 assez aride En anglais Listes d l ments des exemples d effets graphiques foison de tr s bons tutoriaux sur le positionnement d objets avec les CSS le W3C a ses propres tips n tricks et pour ceux qui ont le go t du risque l int grale des sp cifications originales du W3C Petits outils Si vous utilisez l excellent navigateur Firefox le plug in EditCss vous permet de modifier et tester les feuilles de style la vol e depuis votre brouteur 4 ai http www spip net fr_article2434 html 2 of 2 2006 04 17 19 29 53 SPIP Trucs et astuces fran ais O tout le site Modifications r centes Le calendrier de SPIP 1 8 2 m nternationaliser les squelettes m Principe g n ral m lt INCLURE gt d autres squelettes Les balises propres au m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Trucs et astuces Trucs et astuces Afficher automatiquement selon la date ou selon un ordre impos Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier Plusieurs logos pour un article Afficher les derniers articles de vos r dacteurs par rubrique Afficher des l ments pa
22. ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle arr VAUT LEE m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La popularit des articles m fran ais m catal mDeutsch mEnglish m Espa ol mitaliano La notion de popularit expos e ci dessous appara t dans SPIP 1 4 Comment d compter des visites Des centaines de m thodes statistiques existent pour d compter des visites sur un site donn La plupart donnent des courbes horaires ou par jour qui permettent de savoir si son site monte ou descend et de v rifier qu il y a plus de gens sur le net en fin d apr s midi et dans la semaine que le week end ou la nuit Notre objectif est un peu diff rent il s agit d attribuer chaque article une valeur de popularit refl tant assez rapidement une tendance et permettant de comparer l activit de diff rents articles soit de mani re globale sur tout le site hit parade soit l int rieur d une rubrique soit parmi les articles d un m me auteur etc La m thode retenue est la suivante rassurez vous vous pouvez sauter cette explication si vous n tes pas l aise en maths chaque visite sur un article ajoute un certain nombre de points cet article 1
23. FORMULAIRE_SITE SPIP 1 4 Le FORMULAIRE_SITE affiche une interface permettant aux visiteurs du site de proposer des r f rencements de sites Ces sites appara tront comme propos s dans l espace priv en attendant une validation par les administrateurs Ce formulaire ne s affiche que si vous avez activ l option G rer un annuaire de sites dans la Configuration sur site dans l espace priv et si vous avez r gl http www spip net fr_article1827 html 2 of 5 2006 04 17 19 13 40 SPIP Les formulaires Qui peut proposer des sites r f renc s sur les visiteurs du site public Les sites r f renc s tant dans SPIP attach s aux rubriques on ne peut placer ce FORMULAIRE_ SITE qu l int rieur d une boucle RUBRIQUES H FORMULAIRE ECRIRE AUTEUR SPIP 1 4 Plac l int rieur d une boucle AUTEURS ce formulaire permet d envoyer un mail l auteur d un article Cela permet en modifiant les squelettes qui par d faut affichent les liens contenant les adresses email des auteurs des articles de pouvoir crire aux auteurs sans afficher leur adresse email sur le site public SPIP 1 8 2 Plac dans une boucle ARTICLES ce formulaire permet d envoyer un mail tous les auteurs de cet article SPIP 1 8 2 Plac dans une boucle FORUMS ce formulaire permet d envoyer un mail directement l auteur du message si l auteur est enregistr sur le site Inscription aut
24. affichera une liste ressemblant 2005 mars article de mars autre article de mars f vrier http www spip net fr_article901 html 3 of 11 2006 04 17 19 14 18 SPIP Les filtres de SPIP article de f vrier 2004 d cembre un article On utilise la notation af fdate Y m pour afficher le nom du mois chaque ann e En effet e si l on ne faisait que DATE nom_mois unique les noms de mois ne seraient affich s que la premi re ann e e Si le filtrage tait DATE unique nom_mois on afficherait toutes les dates En effet DATE retourne une date compl te qui contient aussi l heure Il y a donc une grande chance que les dates compl tes de deux articles publi s le m me jours soient diff rentes C est pourquoi on garde juste le mois et l ann e de la date avant de la passer au filtre unique On peut passer un argument optionnel ce filtre pour diff rencier deux utilisations ind pendantes du filtre Par exemple DATE affdate_ mois_anneel unique ici n aura pas d incidence sur DATE affdate_mois_anneel unique la Filtres de texte La plupart de ces filtres ont t introduits dans la version SPIP 1 4 liens_ ouvrants transforme les liens SPIP qui donnent vers des sites ext rieurs en liens de type popup qui ouvrent dans une nouvelle fenetre c est l quivalent du target blank du HTML N B les d veloppeurs de SPIP estiment qu il s agit en g n ral d une impolites
25. automatis des images m La structure de la base de donn es Dans le fichier ecrire mes_options php3 1 cr er le cas ch ant vous pouvez d clarer une variable PHP contenant le type d URLs utiliser En l absence de ce r glage SPIP utilisera Stype_urls standard La variable type_urls d termine le nom du fichier PHP qui est appel pour g rer les URLs Avec la d claration par d faut ci dessus c est inc urls standard php3 Vous remarquerez que SPIP propose aussi les fichiers inc urls html php3 inc urls propres php3 amp tinc urls propres2 php3 Lefichier inc urls html1 php3 permet de traiter des adresses du type article123 html Vous pouvez d cider d utiliser les URLs html en mettant dans ecrire mes_options php3 laligne type_urls html Lefichier inc urls propres php3 permet de traiter des adresses du type Titre de l article Il faut alors ajouter Stype_urls propres Lefichier inc urls propres2 php3 est une variation du pr c dent qui donne des adresses du type Titre de l article html Il faut alors ajouter Stype_urls propres2 Si vous voulez plut t utiliser vos propres adresses ce pour quoi vous devez savoir programmer en PHP il est fortement conseill de partir d un des fichiers existants et de le recopier sous le nom que vous aurez choisi inc urls XXX php3 Il est par exemple tr s ais de modifier la fonction _generer_url_propr
26. avant la fin de l ann e 2000 On peut combiner plusieurs de ces crit res pour effectuer des s lections tr s pr cises Par exemple http www spip net fr_article900 html 4 of 8 2006 04 17 19 13 8 SPIP Les crit res communs toutes les boucles lt BOUCLE _art ARTICLES id secteur 2 affiche les articles du secteur 2 l exclusion de ceux de la rubrique 3 et publi s depuis moins de 30 jours Astuce Le crit re age est tr s pratique pour afficher les articles ou les br ves dont la date est situ e dans le futur avec des valeurs n gatives condition d avoir s lectionn dans la Configuration pr cise du site l option Publier les articles post dat s Par exemple ce crit re permet de mettre en valeur des v nements futurs age lt 0 s lectionne les articles ou les br ves dont la date est situ e dans le futur apr s aujourd hui SPIP 1 3 ge par rapport une date fix e Le crit re age est calcul par rapport la date d aujourd hui ainsi age lt 30 correspond aux articles publi s depuis moins d un mois par rapport aujourd hui Le crit reage_ relatif compare la date d un article ou d une br ve une date courante par exemple l int rieur d une boucle ARTICLES on conna t d j une date pour chaque r sultat de la boucle on peut donc s lectionner par rapport cette date et non plus par rapport aujourd hui Par exemple lt BOUCL
27. cette rubrique lt A gt renverra le visiteur sur la page actuelle une fois que le message a t valid FORMULAIRE SITE SPIP 1 4 Le FORMULAIRE SITE affiche une interface permettant aux visiteurs du site de proposer des r f rencements de sites Ces sites appara tront comme propos s dans l espace priv en attendant une validation par les administrateurs Ce formulaire ne s affiche que si vous avez activ l option G rer un annuaire de sites dans la Configuration sur site dans l espace priv et si vous avez r gl Qui peut proposer des sites r f renc s sur les visiteurs du site public Le logo LOGO_RUBRIQUE le logo dela rubrique ventuellement avec la gestion du survol S il n y a pas de logo pour cette rubrique SPIP va automatiquement chercher s il existe un logo pour la rubrique dont elle d pend et ainsi de suite de mani re r cursive Le logo s installe de la mani re suivante LOGO_RUBRIQUE alignement adresse SPIP 1 4 10G0_RUBRIQUE_NORMAL affiche le logo sans survol LOGO_RUBRIQUE_SURVOL affiche le logo de survol ces deux balises permettent par exemple quand on est dans une rubrique de g rer un logo avec survol pour les liens vers les autres rubriques et de laisser le logo de survol seul dans la http www spip net fr_article904 html 4 of 5 2006 04 17 19 10 52 SPIP La boucle RUBRIQUES rubrique active http www spip net fr_articl
28. dacteurs par rubrique m Afficher des l ments par lignes dans un tableau m Ne pas afficher les articles publi s depuis m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Trucs et astuces Un menu d roulant pour pr senter une liste d articles E fran ais m catal m English m italiano m Espa ol On souhaite r aliser un menu d roulant en utilisant les commandes HTML adapt es la cr ation de formulaire de plus on veut que ce menu serve aller l URL de l article s lectionn Si l URL des articles est du type article php3 id_article 123 le bout de code suivant conviendra lt FORM ACTION article php3 METHOD get gt lt SELECT NAME id_article gt lt BOUCLE menu _ articles ARTICLES id_rubrique par titre gt lt OPTION VALUE ID ARTICLE TITRE lt OPTION gt lt BOUCLE menu articles gt Dai mi mi eu mt Les crit res de la boucle articles ici les articles de la rubrique courante tri s par titre seront modifi s selon vos besoins Ce type de construction marche bien s r aussi pour les br ves rubriques Selon le m me principe il est tout aussi facile de pr senter une liste de rubriques de br ves ou m me l int gralit de la structure du site http www spip net fr_article1494 html 1 of 2 2006 04 17 19 33 55 SPIP Un menu d roulant pour pr senter une liste d articles plus d un an
29. de chaque article Pour chaque type de document SPIP vous demande deux fichiers un fichier php3 et un fichier html1 Lors de l installation de SPIP vous trouverez ainsi les couples article php3 article html rubrique php3 rubrique html etc Vous pouvez naturellement modifier ces couples et en cr er d autres Depuis SPIP 1 8 2 n anmoins il existe un fichier page php3 utilisable pour tous les types de documents que l on pourra cr er Le principe de fonctionnement du cache L appel d une page sp cifique se fait par l interm diaire du fichier php3 Par exemple pour appeler l article n 5 l URL correspondante est k http monsite net article php3 id article s5 http www spip net fr_article877 html 2 of 8 2006 04 17 19 09 48 SPIP Principe g n ral 1 L utilisateur appelle l page D as P article php37id_articlees Sfond article E _ ___ _ _ _ _ _ _ _ _ _ _ LES Sdelais 3600 article php3 2 SPIP v rifie dans la cache s il existe d j Le fichier correspond 3 Si le fichier n existe pas en cache ou 2bis Si ce fichier existe s il est trop ancien SPIP calcul la page et si son ge est inf rieur au d lais fix fichier cache a n er miee lasors dis 4 En fonction de la mise en page HTML d crite par article html article html h SPIP int gre les l ments tir s de la id_articiess FE base de donn es d
30. de cr er du code aussi propre et conforme que possible avant m me le passage par Tidy Cela se fait plusieurs niveaux tout d abord SPIP produit dans ses traitements typographiques du code http www spip net fr_article3070 html 1 of 7 2006 04 17 19 22 38 SPIP Tidy validation XHTML 1 0 graphique m Le calendrier de SPIP 1 8 2 m Images typographiques m Couleurs automatiques m Traitement automatis des images E La structure de la base de donn es propre et chaque version plus conforme compliant notez bien SPIP vise la conformit HTML 4 01 transitional les squelettes du site public doivent eux m mes tre aussi conformes que possible pour rester coh rent on visera la conformit HTML 4 01 tape 2 si Tidy est pr sent sur le serveur et si le webmestre active cette option voir plus loin alors SPTP fait passer les pages produites par Tidy qui va alors tenter de nettoyer les pages et de les transformer en pages conformes au XHTML 1 0 transitional tape 3 si le traitement a bien fonctionn Tidy n a pas rencontr d erreur bloquante alors la page affich e est bien du XHTML 1 0 dont on peut d ailleurs faire valider la conformit par le W3C validator en revanche si Tidy n a pas fonctionn voir plus loin alors c est la page d origine qui est affich e dans ce cas c est un outil important prendre en compte SPIP affiche un bouton d admin
31. e donc SPIP n affichera pas le formulaire correspondant lors de l installation Pensez activer l extension LDAP dans votre installation de PHP si vous voulez utiliser LDAP avec SPIP Si SPIP est d j install et que vous voulez configurer l annuaire LDAP il faudra reprendre l installation en effa ant le fichier ecrire inc_connect php3 http www spip net fr_article1910 html 1 of 3 2006 04 17 19 22 49 SPIP Le support LDAP formules math matiques en LaTEX m SPIP 1 8 l interface graphique m Le calendrier de SPIP 1 8 2 E Images typographiques m Couleurs automatiques E Traitement automatis des images m La structure de la base de donn es Une fois la configuration correctement effectu e tous les utilisateurs de l annuaire LDAP seront identifi s en tapant leur login ou nom dans l annuaire LDAP puis leur mot de passe Notez que cela n emp che pas de cr er directement des auteurs dans SPIP ces auteurs ne seront pas recopi s dans l annuaire mais g r s directement par SPIP D autre part les informations personnelles biographie cl PGP des auteurs authentifi s depuis LDAP ne seront pas non plus recopi es dans l annuaire Ainsi SPIP n a besoin que d un acc s en lecture seule l annuaire LDAP Important cr ez toujours un premier administrateur normal non LDAP lors de l installation de SPIP C est pr f rable pour viter d tre bloqu en cas de panne du serveur LDAP Pour
32. en fran ais la cha ne t l charger ce fichier en anglais la cha ne download this file en espagnol la cha ne descargar este archivo etc Dans le fichier de squelette des articles un seul fichier g rera toutes les langues article htmil il suffit d ins rer le code notez la syntaxe lt telechargement gt Lors de l affichage d un article ce code sera remplac par sa traduction dans la langue de l article Par exemple dans le squelette article html nous ins rons dans la boucle affichant les documents associ s l article le code suivant lt a href URL_DOCUMENT gt lt Si l article en question est en fran ais cela produira lt a href IMG jpg mondocument jpg gt t l charger ce fichier lt a gt si l article est en anglais lt a href IMG jpg mondocument jpg gt download this file lt a gt et ainsi de suite Un unique squelette contenant un unique code affiche un texte traduit dans toutes les langues utilis es sur le site Utiliser des textes d j traduits Pour faciliter le travail des webmestres SPIP fournit un ensemble de cha nes d j traduites par les traducteurs de SPIP En utilisant ces cha nes correspondant des l ments de texte fr quemment utilis s sur des sites Web le webmestre peut rapidement r aliser une interface fonctionnant dans diff rentes langues m mes celles qu il ne parle pas lui m me Vou
33. m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence Les filtres de SPIP m fran ais m catal mDeutsch m English m italiano m Espa ol Nous avons vu dans la syntaxe des balises SPIP qu il tait possible de modifier le comportement et l affichage des balises en leur attribuant des filtres option avant BALISE filtrel filtre2 filtren option apr s Les filtres 1 2 n sont appliqu s successivement la BALISE Les filtres de mise en page Les filtres de mise en page suivants majuscules justifier ne sont plus conseill s Il est recommand de leur pr f rer d sormais l utilisation des styles CSS correspondants majuscules fait passer le texte en majuscules Par rapport la fonction de http www spip net fr_article901 html 1 of 11 2006 04 17 19 14 18 SPIP Les filtres de SPIP DOCUMENTS m La boucle SYNDIC_ ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives E La popularit des articles m La gestion des dates m Exposer un article dans une liste
34. m Pr senter les r sultats d une recherche par secteurs m Afficher le nombre de messages du forum li un article E Un menu d roulant pour pr senter une liste d articles m Remplir les meta tags HTML des pages d article http www spip net fr_article1494 html 2 of 2 2006 04 17 19 33 55 SPIP Remplir les meta tags HTML des pages d article m Afficher automatiquement selon la date ou selon un ordre impos m Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier m Plusieurs logos pour un article m Afficher les derniers articles de vos r dacteurs par rubrique m Afficher des l ments par lignes dans un tableau m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Trucs et astuces Remplir les meta tags HTML des pages d article E fran ais m catal mEnglish mEspa ol mitaliano Le but de cet exemple est d installer dans les m ta tags de notre page la liste des mots cl s associ s l article ainsi que le nom des auteurs Si l on veut optimiser le r f rencement du site par les moteurs de recherche on peut par exemple mentionner le descriptif de l article les mots cl s associ s ainsi que le nom du ou des auteurs lt head gt lt BOUCLE _head ARTICLES id article gt lt title TITRE lt title gt lt meta name Description content DESCRIPTIF gt lt meta name Keywords con
35. s caract res dans des alphabets non occidentaux chappement des apostrophes ainsi http www spip net fr_article2128 html 6 of 9 2006 04 17 19 21 40 SPIP Internationaliser les squelettes que la collaboration de plusieurs personnes au processus de traduction de l interface du site public Pour l instant l outil permettant de g rer la traduction des cha nes de texte n est pas livr directement avec SPIP et son utilisation tr s g n raliste nous l utilisons pour traduire toute l interface de SPIP et pas seulement des fichiers de langue de type 1ocal php3 le rend un peu complexe par rapport cette t che Ce programme trad lang qui nous sert traduire le logiciel SPIP le site spip net etc est lui m me disponible sous licence GNU GPL mais il n est pas int gr en standard SPIP Vous pourrez le t l charger pour l utiliser pour votre site ou pour d autres projets de logiciels Si vous l am liorez ou avez des id es pour le transformer venez en discuter sur la liste des traducteurs de SPIP spip trad 2 Des squelettes s par s pour chaque langue La seconde m thode plus accessible aux webmestres d butants consiste cr er des squelettes diff rents pour chaque langue Un peu sur le m me principe qui consiste cr er des squelettes sp cifiques pour diff rentes rubriques pour obtenir des interfaces graphiques diff rentes Nous voulons r aliser un site en fran ais langue par d
36. s les squelettes dans la langue correspondante par exemple l interface pour poster des messages m Utiliser des URLs de forums Tout cela est d ores et d j traduit par SPIP personnalis es m Le moteur de recherche m Les variables de Ce n est cependant pas suffisant les webmestres ins rent dans leurs squelettes un certain nombre d informations d crivant notamment les principes de personnalisation navigation dans le site Il est n cessaire par exemple d afficher des textes du style a Tidy validation Plan du site R pondre cet article Articles du m me auteur Dans XHTML 1 0 la m me rubrique Pour un site dans une seule langue ces diff rents l ments m Le support LDAP sont faciles ins rer on les ins re tels quels dans le code HTML des squelettes m Le traitement des Le probl me appara t lorsque le site est multilingue sous un article en fran ais images on veut afficher R pondre cet article mais sous un article en anglais on a se ges besoin d afficher un autre texte Comment on this article math matiques en gt pa ces LaTeX SPIP 1 7 2 propose trois m thodes pour g rer ces l ments de texte diff rents SPIP 1 8 selon les langues l interface graphique http www spip net fr_article2128 html 1 of 9 2006 04 17 19 21 40 SPIP Internationaliser les squelettes m Le calendrier de SPIP 1 8 2 m Images typographiques m Couleurs auto
37. valeur et lt valeur comparent http www spip net fr_article901 html 5 of 11 2006 04 17 19 14 18 SPIP Les filtres de SPIP l l ment filtr qui doit tre num rique avec une valeur num rique Par exemple TOTAL_BOUCLE TOTAL_BOUCLE gt Remarque De mani re g n rale tous les op rateurs de comparaison de php peuvent tre utilis s comme filtres dans SPIP 1 8 Filtres de logos fichier SPIP 1 4 Affect un logo ce filtre permet de r cup rer directement le nom de fichier correspondant au logo autres filtres Contrairement aux versions pr c dentes SPIP 1 4 permet de passer des filtres maison sur les logos la logique est un peu tordue car il fallait respecter la compatibilit avec SPIP 1 3 L analyse se d roule comme suit e sile premier filtre n est pas un alignement SPIP consid re qu il s agit d un URL et fait un lien du logo vers cette adresse e si le premier filtre est un alignement SPIP consid re que le deuxi me filtre est un URL e les filtres suivants sont de vrais filtres au sens habituel y compris des filtres maison d clar s dans mes fonctions php3 e pour appliquer un filtre quelconque sans mettre d URIL il faut mettre deux barres Par exemple lt php logo LOGO_ RUBRIQUE texte_script gt permet de r cup rer le logo dans la variable php logo pour traitement ult rieur voir ci dessous pour la significatio
38. voir aussi Les formulaires HPARAMETRES_ FORUM fabrique la liste des variables exploit es par l interface du formulaire permettant de r pondre ce message Par exemple lt a href forum php3 Depuis SPIP 1 8 2 on peut lui passer un param tre sp cifiant l adresse de retour apr s avoir post le message Par exemple lt A HREF forum php3 PARAMETRES_FORUM SELF gt R pondre ce message lt A gt renverra le visiteur sur la page actuelle une fois que le message a t valid http www spip net fr_article908 html 4 of 4 2006 04 17 19 11 26 SPIP La boucle MOTS E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION VEUT la Me ni m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La boucle MOTS E fran ais m catal m Deutsch m italiano H eeeeoo m English Espa ol La boucle MOTS retourne une liste de mots cl s lt BOUCLEn MOTS crit res gt Les crit res de s lection On utilisera l un ou autre des crit res suivants pour indiquer comment on s lectionne les l ments tout les mots sont s lectionn s dans l int gralit du si
39. zoom pour l volution des statistiques Les pages des r partitions de visites devient nettement plus compr hensible Decumer gien er ranc La bi empar dat Leldiient 15 i Pour les webmestres http www spip net fr_article3037 html 7 of 9 2006 04 17 19 24 22 SPIP SPIP 1 8 l interface graphique Les adeptes de HTML pourront se demander comment les grandes icones de navigation de l espace priv changent de couleur selon le choix de l utilisateur Cet effet est r alis en utilisant des icones au format PNG 24 et en profitant de la transparence fine autoris e par ce format couche alpha Or il est habituellement expliqu que Microsoft Explorer est incapable d exploiter la couche alpha du PNG24 L espace priv de SPIP utilise une astuce permettant cependant de faire utiliser cette couche alpha par Microsoft Explorer Les webmestres int ress s pourront avantageusement l exploiter pour la partie publique de leur site lors de la cr ation de leurs propres squelettes Il convient de cr er une classe de style classe que l on attribuera aux images concern es notez bien on peut appliquer sans risque cette classe des images dans d autres formats que le PNG la classe sera alors simplement inutile mais sans d terioration de ces images Cette classe pourra se d finir ainsi format_png behavior url win_png htc qu on applique dans les balises lt img src class
40. 1 8 l interface graphique m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es Les variables de personnalisation E fran ais m catal m English mEspa ol mitaliano moccitan E 0000e Certains comportements des pages de votre site peuvent tre modifi s au moyen de variables PHP Ces variables sont normalement d finies par SPIP mais pour obtenir une personnalisation plus fine du site le webmestre peut les modifier O indiquer ces variables Inutile d entrer dans le code source de SPIP lui m me pour fixer ces variables ouf Pour l ensemble du site Si vous voulez fixer ces variables pour l int gralit du site vous pouvez les indiquer comme globales avec une syntaxe un peu diff rente dans un fichier intitul mes_fonctions php3 plac la racine du site Il faudra ventuellement cr er ce fichier et entourer les d finitions de vos variables par les marqueurs lt php et gt voir les exemples ci dessous Pour chaque type de squelette SPIP 14 Vous pouvez aussi d finir ces variables squelette par squelette Pour cela il faut les installer au d but du fichier PHP appelant le squelette par exemple article php3 rubrique php3 Elles s ins rent naturellement http www spip net fr_article1825 html 1 of 6 2006 04 17 19 22 25 SPIP Les variables de personnalisation m Le calendrier de S
41. 2006 04 17 19 13 8 SPIP Les crit res communs toutes les boucles Sp cialement si on veut utiliser la balise ENV ou tout autre balise prenant des param tres on doit utiliser la notation titre ENV titre etpas titre ENV titre Expressions r guli res Tr s puissant mais nettement plus complexe manipuler le terme de comparaison introduit une comparaison selon une expression r guli re Par exemple lt BOUCLE_ art ARTICLES titre aA gt s lectionne les articles dont le titre commence par a ou A N gation A partir de SPIP 12 On peut utiliser la notation xxx yyy et xxx yyy le correspondant la n gation op rateur logique NOT lt BOUCLE_ art ARTICLES id_secteur 2 gt s lectionne les articles qui n appartiennent pas au secteur num ro 2 lt BOUCLE art ARTICLES titrel aA gt s lectionne les articles dont le titre ne commence pas par a ou A Affichage en fonction de la date Pour faciliter l utilisation des comparaisons sur les dates on a ajout des crit res age etage_redac correspondent respectivement l anciennet de la publication et de la premi re publication d un article en jours age lt 30 s lectionne les l m nts publi s depuis un mois les crit res mois mois_redac annee annee _redac permettent de comparer avec des valeurs fixes annee lt 2000 pour les l ments publi s
42. 22 56 SPIP S curit SPIP et IIS m S curit SPIPetiis E Qu est ce que les fichiers dist Em FAQ webmestre m Rapidit du site public m Contribuer au d veloppement de SPIP m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur S curit SPIP et IIS m fran ais mcatal mEspa ol mitaliano S curit par d faut de SPIP Il existe deux dossiers sensibles dans SPIP ce sont CACHE etecrire data Le premier comporte tous les fichiers qu utilise votre cache pour acc l rer l affichage des pages il est donc moyennement sensible mais le deuxi me stocke les journaux d activit de spip les spip 10g et vous permet notamment de cr er dump xm1 le fichier de sauvegarde de la base de donn es Or le fichier dump xm1 contient des donn es tr s sensibles en particulier on peut y voir tous les articles m me s ils ne sont pas rendus publics sur le site sans compter qu il liste galement les identifiants et les mots de passe 1 des r dacteurs et administrateurs du site La s curit de tous ces fichiers est assur e traditionnellement par des fichiers de configuration d acc s nomm s htaccess SPIP g n re automatiquement ces fichiers pour emp cher l acc s aux donn es sensibles stock es sur le serveur vous pouvez v rifier que CACHE etecrire data contiennent chacun un fichier htaccess H las ces fichiers fonctionn
43. Ce filtre est utilis par exemple dans le squelette backend html qui g n re le fil rss du site couper coupe un texte apr s un certain nombre de caract res Il essaie de ne pas couper les mots et enl ve le formatage du texte Si le texte est trop long alors gt est ajout la fin La longueur par d faut est de 50 caract res Mais on peut sp cifier une autre longueur en passant un param tre au filtre par exemple TEXTE couper 80 Filtres de test SPIP 1 6 introduit le filtre sinon qui indique ce qu il faut afficher si l l ment filtr est vide ainsi TEXTE sinon pas de texte affiche le texte si celui ci est vide affiche pas de texte SPIP 1 8 introduit le filtre sioui sinon qui est une version volu e de sinon Il prend un ou deux param tre e sioui est la valeur afficher la place de l l ment filtr si celui ci est non vide e sinon est optionnel C est la valeur afficher si l l ment filtr est vide TEXTE TEXTE pas de texte est quivalent l exemple donn pour le filtre sinon SPIP 1 8 introduit un jeu de filtres pour faire des comparaisons avec des valeurs e valeur et valeur permettent de v rifier respectivement l galit ou l in galit entre l l ment filtr et valeur Par exemple lt 1i TITRE dito id edito gt TITRE lt 1i gt e gt valeur gt valeur lt
44. Mon premier squelette a Un squelette plusieurs articles m Une rubrique m Boucles en boucles m G rer le cache m Des filtres m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m SPIP pas pas Un squelette plusieurs articles m catal OO m Deutsch mitaliano m polski E fran ais m English m Portugu s m Espa ol La le on pr c dente nous a permis d extraire des donn es de l article n 1 dela base et d en faire une page Web G n ralisons Notre squelette est bien inutile s il ne sert qu afficher l article n 1 Apprenons lui afficher n importe quel article Pour cela nous allons appeler notre page Web avec un param tre du type id_article 2 dirigez votre navigateur sur l URL http votresite net tutoriel php3 id articlez 2 S affiche toujours l article 1 et pas 2 Modifions dans le squelette tutoriel htm1 la ligne qui d finit la boucle article lt BOUCLE article ARTICLES id article gt Comme vous le voyez on remplace simplement id_article 1 par id article tout court Voil http votresite net tutoriel php3 7id_ article 2 vous donne maintenant l article 2 1 http www spip net fr_article880 html 1 of 2 2006 04 17 19 18 10 SPIP Un squelette plusieurs articles La BOUCLE_article s ex cute dans un contexte o id_article est gal 2 c est la valeur qui
45. SPIP Guide du webmestre et du bidouilleur fran ais tout le site Modifications r centes m Le calendrier de SPIP 1 8 2 E Internationaliser les m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur Guide du webmestre et du bidouilleur a S curit SPIP etis Emp cher l acc s aux donn es confidentielles de SPIP sous Microsoft IIS Cet article vous concerne si la machine qui vous h berge n utilise pas Apache le serveur Web le plus r pandu mais le logiciel Microsoft IIS a Vous avez dist Qu est ce que les fichiers dist Que sont les fichiers se trouvant dans le r pertoire dist ou ayant dist htm1 dans leur nom en fait ce sont les fichiers de la distribution de SPIP FAQ webmestre http www spip net fr_rubrique135 html 1 of 6 2006 04 17 2 22 56 SPIP Guide du webmestre et du bidouilleur squelettes Rapidit du site public A Principa general a Contribuer au d veloppement de SPIP m lt INCLURE gt d autres i squelettes Quelques r gles m Les balises propres au site m La boucle ARTICLES m SPIP 1 8 3 SPIP Contrib des outils pour les webmestres e L espace des contributions externes qui recense m Traitement automatis des immanes l ensemble des scripts filtres squelettes m Images typographiques documentations imprimer etc fournis la communaut par les utilisateurs de SPIP m Fichier CSV vers SP
46. SPIP 1 8 2 on peut lui passer un param tre sp cifiant l adresse de retour apr s avoir post le message Par exemple lt A HREF forum php3 PARAMETRES_FORUM SELF gt R pondre cette br ve lt A gt renverra le visiteur sur la page actuelle une fois que le message a t valid Le logo LOGO_BREVE le logo de la br ve ventuellement avec la gestion du survol Le logo s installe de la mani re suivante LOGO BREVE alignement adresse HLOGO_ BREVE_ RUBRIQUE affiche si il existe le logo de la br ve si ce logo n a pas t attribu SPIP affiche le logo de la rubrique SPIP 1 4 http www spip net fr_article906 html 3 of 4 2006 04 17 19 11 2 SPIP La boucle AUTEURS E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle A Er hi m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La boucle AUTEURS E fran ais me cccee catal mDeutsch mEnglish m Espa ol mitaliano La boucle AUTEURS comme son nom l indique retourne une liste d auteurs Si l on ne pr cise pas de crit re de s lection la boucle retournera tous les auteurs ayant un article p
47. SPIP am liore beaucoup la situation vous n avez plus http www spip net fr_article2330 html 1 of 3 2006 04 17 19 28 52 SPIP Introduction modifier des centaines de fichiers HTML juste quelques squelettes et votre mise en page est remise jour automatiquement sur l ensemble du site Cependant le probl me n est pas enti rement r solu Par exemple mettons que vous ayez d cid d employer un certain bleu pastel sur beaucoup d lements du site afin de donner une identit graphique votre site les liens les encarts certains l ments de navigation sont affich s en bleu pastel Le jour o vous voudrez remplacer ce bleu pastel par un vert p le vous devrez modifier tous les endroits du squelette o ce bleu apparaissait pour le remplacer par le vert p le Cela peut tre d courageant il n est pas ais dans ces conditions de changer rapidement le rendu des pages ne serait ce que pour faire des essais La solution r side dans l utilisation des feuilles de style Une feuille de style est un fichier o vous d finissez un ensemble de propri t s graphiques et les endroits o elles s appliquent On note deux avantages capitaux des feuilles de style la feuille de style est un fichier unique et centralis que vous pouvez appliquer autant de fichiers HTML et de squelettes SPIP que vous le d sirez les propri t s graphiques sont d finies une seule fois dans la feuille de style quel que soit
48. Vos squelettes ne sont eux m mes pas conformes dans ce cas il faut les corriger C est le cas le plus fr quent Vous pouvez ici commencer par d sactiver Tidy passer la variable xhtm1 false et passer vos pages au Validator en visant le conformit HTML 4 01 transitional SPIP visant dans ses traitements typographiques cette conformit autant rester coh rent Le W3C Validator est un outil tr s pratique pour nettoyer son code Une fois vos squelettes aussi proches que possible du HTML 4 Tidy n aura pas de difficult produire du XHTML tr s compliant Si ces pages sont compl tement conformes c est encore mieux Et pas impossible les squelettes livr s avec SPIP sont d j conformes Certaines articles contiennent des codes erron s SPIP laissant les r dacteurs travailler en code source ceux ci peuvent ins rer du code non conforme l int rieur de leurs articles Par exemple dans la documentation de www spip net on trouve certains endroits l utilisation de balises HTML lt tt gt lt tt gt que Tidy consid re comme inacceptables Aussi une fois les squelettes nettoy s on pourra chercher corriger les textes de certains articles cela concerne donc les insertions de HTML directement dans les articles encore une fois le code produit par SPIP est essentiellement conforme et ne provoque pas de blocage de Tidy Erreurtidyh Modifier cet article 2256 Recalculer cette pag
49. a r sultat avant la fin de la boucle Par exemple n 20 10 affichera au 10 r sultats en partant du 20 r sultat avant la fin de la boucle a b o a et b sont des chiffres Ce crit re permet d afficher une partie a proportionnellement des r sultats en fonction d un nombre de tranches b Par exemple 1 3 affiche le premier tiers des r sultats Ce crit re est surtout utile pour pr senter des listes sur plusieurs colonnes Pour obtenir un affichage sur deux colonnes il suffit de cr er une premi re boucle affich e dans une case de tableau avec le crit re 1 2 la premi re moiti des r sultats puis une seconde boucle dans une seconde case avec le crit re 2 2 la seconde moiti des r sultats http www spip net fr_article900 html 7 of 8 2006 04 17 19 13 8 SPIP Les crit res communs toutes les boucles Attention L utilisation du crit re doublons avec ce crit re est p rilleuse Par exemple lt BOUCLE_prem ARTICLES id_ rubrique 1 2 X doublons gt lt li gt TITRE lt BOUCLE_ prem gt lt BOUCLE_deux ARTICLES id_ rubrique 2 2 Udoublons gt n affichera pas tous les articles de la rubrique Imaginons par exemple qu il y ait au total 20 articles dans notre rubrique La BOUCLE prem va afficher la premi re moiti des articles c est dire les 10 premiers et interdire cause de doublons de les r utiliser La BOUCLE deux elle va r cup rer la deuxi me
50. appeler cr ez la racine de votre site un fichier tutoriel php3 contenant les lignes suivantes lt php fond tutoriel delais 0 include inc public php3 gt Puis testez dans votre navigateur http votresite net tutoriel php3 Pas tr s glorieux n est ce pas Le message d erreur vous informe qu il manque un fichier C est le fameux squelette que nous allons maintenant cr er A la racine du site d posez un fichier tutoriel html qui contient ce qui suit lt BOUCLE_article ARTICLES id_article 1 gt TITRE lt BOUCLE article gt Puis rechargez la page http votresite net tutoriel php3 C est mieux n est ce pas SPIP est all chercher le titre de l article n 1 de votre base et l a inscrit la place de TITRE Si a ne fonctionne pas v rifiez que votre article n 1 est bien publi et pas en attente ou en cours de r daction Puis ajoutez du HTML et d autres appels de champs SPTP et vous obtenez rapidement votre article n 1 lt BOUCLE_article ARTICLES id_article 1 gt lt h1 gt TITRE lt h1 gt lt b gt CHAPO lt b gt lt div align justify TEXTE lt div gt lt BOUCLE_article gt Ajoutez ensuite les champs manquants pour parfaire l affichage de l article SURTITRE LESAUTEURS SOUSTITRE NOTES etc Bien http www spip net fr_article879 html 2 of 3 2006 04 17 19 17 58 SPIP Un squelette plusieurs articles m
51. apres ARTICLES agenda date periode HDATE annee DATE mois DATE jour par date gt lt li gt TITRE lt li gt IBOIICI E liste les articles qui ont t publi s apr s l article actuel Pour mettre en page les l ments s lectionn s par une boucle en particulier une boucle avec un crit re agenda sous forme de calendrier SPIP fournit trois filtres Ces filtres fournissent un affichage similaire au calendrier de l espace priv avec le m me syst me de navigation Lefiltre agenda_memo s applique sur une balise de date par exemple DATE ou DATE_MODIF et prend quatre param tres 1 un descriptif 2 un titre 3 une URL repr sentant l l ment ayant ce titre et ce descriptif par exemple URL_ARTICLE 4 un nom de classe CSS Si la balise sur laquelle a3enda_memo s applique n est pas nulle il se contente de m moriser la date et les trois premiers arguments dans un tableau index par le dernier argument le nom de classe CSS et ne retourne rien aucun affichage L utilisation du dernier argument comme index pour l l ment m moriser permet d avoir plusieurs calendriers par page De plus la classe sp cifi e ici sera attribu e cet l ment dans l affichage en calendrier fourni par agenda_ affiche Ainsi on peut donner des styles diff rents aux l ments La feuille calendrier css fournit 28 styles diff rents qui donnent un exemple de diff rents styles de
52. articles c est dire le crit re de boucle par titre Tout autre classement ne fonctionnera pas Remarque cela s applique galement aux rubriques br ves sites r f renc s etc http www spip net fr_article2034 html 1 of 2 2006 04 17 19 32 4 SPIP Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier tableau m Ne pas afficher les articles publi s depuis plus d un an m Pr senter les r sultats d une recherche par secteurs m Afficher le nombre de messages du forum li un article m Un menu d roulant pour pr senter une liste d articles m Remplir les meta tags HTML des pages d article http www spip net fr_article2034 html 2 of 2 2006 04 17 19 32 4 SPIP Plusieurs logos pour un article m Afficher automatiquement selon la date ou selon un ordre impos m Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier m Plusieurs logos pour un article m Afficher les derniers articles de vos r dacteurs par rubrique m Afficher des l ments par lignes dans un tableau m Ne pas afficher les articles publi s depuis plus d un an m Pr senter les m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Trucs et astuces Plusieurs logos pour un article mfran ais mec catal mEspa ol mitaliano Il est fr quent pour rythmer la navigation sur son sit
53. bidouilleur m SPIP pas pas Mon premier squelette mfran ais m e c eee catal mDeutsch wm English mEspa ol mitaliano m 00 m occitan W polski m Portugu s m T rk e Si le syst me de squelettes peut de prime abord para tre intimidant c est que ce qu on lui demande est suffisamment riche pour l obliger tre complexe Mais Complexe ne veut pas dire compliqu Voici un exemple minimal de squelette Mat riel requis pour ce tutoriel Un SPIP install quelque part On supposera pour commencer que votre base SPIP contient au minimum une rubrique et deux articles publi s Si ce n est pas le cas vous pouvez tr s vite y rem dier en copiant collant les premiers textes qui vous passent sous la main v rifiez quand m me qu il ne s agit pas de votre d claration enflamm e au petit ami de votre voisin de bureau Un diteur de texte pour cr er et modifier les fichiers utilis s par SPIP Note certaines personnes auront le r flexe de vouloir utiliser DreamWeaver ou autre logiciel graphique pour modifier les fichiers htm1 Cependant pour des exemples simples DreamWeaver compliquera la t che et risque m me de modifier vos fichiers dans votre dos Il est donc vraiment pr f rable d utiliser un diteur de texte http www spip net fr_article879 html 1 of 3 2006 04 17 19 17 58 SPIP Mon premier squelette classique par exemple le bloc notes sous Windows Avant d utiliser un squelette il faut pouvoir l
54. calendrier Lefiltre agenda_affiche s applique sur une balise retournant le nombre http www spip net fr_article3182 html 3 of 5 2006 04 17 19 24 40 SPIP Le calendrier de SPIP 1 8 2 d l ments afficher en g n ral TOTAL_ BOUCLE et prend trois param tres L un texte qui sera affich si la balise filtr e ne retourne rien 0 l ment afficher 2 un type de calendrier jour semaine mois OUperiode 3 des noms de classes CSS utilis es dans l appel du filtre pr c dent qui permettent de filtrer les l ments afficher Si la balise filtr e est nulle ce filtre retourne son premier argument Sinon il retourne les l ments m moris s par le filtre agenda _ memo mis en page dans un calendrier du type demand Seul les l ments index s par agenda _ memo avec une des classes CSS indiqu es dans le dernier argument seront affich s ou alors tous les l ments si ce param tre est omis Ainsi on peut filtrer les l ments pour les r partir dans plusieurs calendriers sur la m me page Le type periode restreindra l affichage la p riode comprise entre le plus vieil l ment et le plus r cent effectivement trouv s ce qui permet de donner dans le crit re une p riode tr s large sans r cup rer un affichage trop long Exemple lt BOUCLE_memorise ARTICLES agenda date semaine par date gt DATE agenda_memo DESCRIPTIF TITRE URL_ARTICLE 1 lt BOUCLE memorise gt affi
55. chaque page et ainsi d viter de http www spip net fr_article877 html 1 of 8 2006 04 17 19 09 48 SPIP Principe g n ral m La boucle DOCUMENTS m La boucle SYNDIC_ ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives E La popularit des articles m La gestion des dates m Exposer un article dans une liste provoquer des appels la base de donn es chaque visite Non seulement la charge sur le serveur est r duite la vitesse tr s largement acc l r e de plus un site sous SPIP reste consultable m me lorsque la base mySQL est plant e Pour chaque type de document un couple de fichiers L int r t et la limite d un syst me de publication automatis c est que l on ne va pas red finir une interface diff rente en HTML pour chaque page isol e Par exemple toutes les articles b n ficieront de la m me interface simplement le syst me placera des informations diff rentes dans ce graphisme on verra plus loin que SPIP autorise cependant une certaine souplesse L avantage de cette mani re de proc der est vident on d finit un format type squelette pour par exemple tous les articles et le syst me fabriquera chaque page individuelle en pla ant automatiquement le titre le texte les liens de navigation
56. d finit les cases de texte des formulaires utile pour d finir la largeur de ces cases et la couleur du fond spip_encadrer lorsqu un formulaire propose diff rentes parties la s paration entre ces diff rentes parties peut tre param tr es avec ce style par exemple encadrer chaque partie cr er un espace avant ou apr s spip_ bouton modifie l aspect du bouton de validation du formulaire formrecherche modifie l aspect de la case Rechercher du moteur de recherche Les images et les documents Depuis SPIP 1 8 le style des images et des documents ins r s automatiquement avec les raccourcis lt docXX left gt et lt imgXX right gt peut tre control avec les classes spip_ documents pour la bo te qui contient la vignette et les informations du document spip_ doc titre qui contr le l affichage du titre du document spip doc _ descriptif pour le descriptif du document Conclusion Vous remarquerez que par d faut certaines feuille de style ne sont pas d finies Elles peuvent tre consid r es comme tr s accessoires r serv es aux webmestres voulant obtenir des effets graphiques tr s sp cifiques En r gle g n rale les styles qui provoquent des modifications graphiques spectaculaires sur un site par ailleurs simples param trer sont celles qui concernent les liens de l ensemble de la page a et a hover le comportement des intertitres h
57. d exemple voici comment on peut afficher tous les articles d un site tri s par mois de publication lt BOUCLE_articlem ARTICLES par date inverse gt lt BOUCLE_ premierdumois ARTICLES id_article doublons gt lt BR gt lt UL gt lt b gt HDATE nom_ mois majuscules DATE annee lt b gt lt li gt lt a href URL_ARTICLE gt TITRE couper 50 lt a gt DATE jour DATE mois lt li gt 2IDOLIDLE _ mrnmiaradiimanins 1 le format MySQL http www spip net fr_article1971 html 4 of 4 2006 04 17 19 16 3 SPIP Exposer un article dans une liste m Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence Exposer un article dans une liste m catal mDeutsch mEnglish m Espa ol occitan m T rk e m fran ais m italiano m SPIP 1 8 2 introduit la balise EXPOSE Elle permet de mettre en vidence dans un menu ou dans une liste l objet principal de la page o l on se trouve Utilis e simplement elle permet de changer le mode d affichage du titre de l article principal par exemple dans le squelett
58. de miroir selon un axe vertical image_flip_horizontal selon un axe horizontal Tr s simple d utilisation il n y a pas de param tre FICHIER image flip_vertical FICHIER image flip_horizontal image flip_vertical image flip horizontal image masque image_masque est le filtre le plus puissant de cette s rie De fait sa logique est nettement plus complexe que les autres filtres Il permet partir d un fichier PNG 24 en niveaux de gris et avec couche de transparence alpha de modifier le cadrage de l image la transparence d une image la luminosit d une image Dimensions de l image Si l image d origine est plus grande que le fichier masque alors l image d origine est r duite et d coup e au format du masque puis on applique les informations de transparence et de luminosit du masque Utile pour cr er les vignettes de navigation Si l image d origine est plus petite que le masque alors on ne recadre pas on applique simplement les informations de luminosit et de transparence du masque lui m me non redimensionn Voici notre image d origine http www spip net fr_article3327 html 9 of 13 2006 04 17 19 26 49 SPIP Traitement automatis des images a i Masque de transparence Les informations de transparence du masque sont directement appliqu es l image d origine Un pixel transparent du masque rend le pixel correspondant de limage d
59. de r f rence Les boucles r cursives E fran ais m e ee mcatal mDeutsch wm English mEspa ol mitaliano Les boucles r cursives sont une fonction tr s puissante pour g rer la mise en forme de l interface Leur programmation est particuli rement simple mais leur utilisation demande une bonne ma trise logique de l encha nement des boucles L appel d une boucle r cursive est tr s simple il suffit d indiquer dans le TYPE de la boucle le nom d une autre boucle lt BOUCLEn bouclex gt lt BOUCLEn gt Il n y a ici aucun crit re en r alit la boucle n correspond une copie pure et simple de la boucle x L ensemble de la boucle fonctionne comme si l on avait recopi l int gralit de la boucle x toutes les balises et le code HTML ainsi que les textes conditionnels avant apr s et alternatif l endroit o l on ins re la boucle n Il faut bien entendu que la boucle x pr c de la boucle n L utilisation la plus simple consiste dupliquer une boucle sans avoir la recopier Ainsi toute modification de la boucle d origine x sera automatiquement dupliqu e dans la boucle n http www spip net fr_article914 html 1 of 2 2006 04 17 19 15 26 SPIP Les boucles r cursives HUCUMENTS Tout l int r t en r alit consiste placer la boucle n l int rieur de la boucle x m La boucle on obtient ainsi un comportement r cursif la boucle x contient une boucle n qui SYNDIC_ARTICLES A i
60. disposera donc de sa propre http www spip net fr_article1828 html 2 of 3 2006 04 17 19 21 14 SPIP lt INCLURE gt d autres squelettes valeur de delais 1 Cela peut s av rer pratique pour s parer des l ments lourds du site que l on recalculera peu souvent et quelques l ments dynamiques n cessitant une mise jour fr quente par exemple syndication Dans un contexte multilingue Si le multiling isme de SPIP est activ depuis SPP 1 7 1il est possible de d finir la langue de l environnement d un squelette inclus en utilisant le param tre lang S il n y a pas de param tre de langue utilis c est dire sous la forme lt INCLURE pied php3 gt le squelette inclus est appel en utilisant la langue par d faut du site lt INCLURE pied php3 lang es gt appelle le squelette en espagnol Bien s r vous pouvez remplacer es par le code ISO de la langue souhait e en pour l anglais fr pour le fran ais vi pour le vietnamien etc voir Internationaliser les squelettes et lt INCLURE pied php3 lang gt appelle le squelette dans la langue courante du contexte d inclusion Il convient de noter que cela rend possible d utiliser des codes de fichiers de langue dans les squelettes inclus voir Internationaliser les squelettes Les squelettes inclus supportent les m mes mechanismes de s lection par langue que les squelettes de premier niveau En d autres termes l
61. documents joints cet article id_article celui dont le titre est spip_ logo titre spip_logo l int rieur de la boucle on demande l affichage de ce document joint EMBED_DOCUMENT L usage de EMBED DOCUMENT encore peu r pandu parmi les sites utilisant SPIP dans les squelettes permet d ins rer via le syst me de boucles directement le document l int rieur de la page SPIP se charge de cr er le code correspondant des images ou des fichiers multim dia Inconv nient si l article n a pas de document joint intitul spip logo le code pr c dent n affiche que le titre On va donc effectuer une nouvelle modification qui permet d afficher le logo normal de l article s il n existe pas de document joint pour cet usage Notez bien une fois cette m thode comprise il n y aura plus d autres subtilit s pour r aliser tous les effets suivants http www spip net fr_article2001 html 5 of 10 2006 04 17 19 32 21 SPIP Plusieurs logos pour un article lt BOUCLE article vedette ARTICLES doublons par date inverse 0 1 gt lt BOUCLE logo _ article vedette DOCUMENTS id_article titre spip_logo gt HEMBED DOCUMENT lt BOUCLE_ logo_ article vedette gt LOGO ARTICLE lt B_logo_ article vedette gt Nous avons tout simplement ajout l appel au logo normal LOGO_ARTICLE en texte alternatif ce qui se trouve avant lt B
62. elle contient La difficult ici c est que justement cette boucle ne doit rien afficher Elle n affiche pas le titre des messages on vitera m me de lui faire afficher des espaces ou des retours la ligne sinon votre page HTML contiendra des dizaines de lignes vides in l gantes l int rieur de la boucle n affiche donc rigoureusement rien doit afficher apr s la boucle le nombre de r sultats mais on Une subtilit bien comprendre le texte conditionnel alternatif s affiche si la boucle n affiche rien il est donc affich m me si la boucle s lectionne des l ments ici des messages de forum mais qu elle ne contient aucun affichage Nous devons donc placer TOTAL BOUCLE dans le texte conditionnel alternatif S il n y aucun message de forum attach l article TOTAL BOUCLE sera vide il ne faut donc pas afficher le texte englobant il y a N contributions au forum dans ce cas lt BOUCLE_nb_forums FORUMS id_article plat gt lt BOUCLE_ nb _forums gt Il y a HTOTAL BOUCLE contribution s au http www spip net fr_article1495 html 2 of 2 2006 04 17 19 33 43 ar FA 12 Cai SPIP Un menu d roulant pour pr senter une liste d articles m Afficher automatiquement selon la date ou selon un ordre impos m Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier m Plusieurs logos pour un article m Afficher les derniers articles de vos r
63. est vivement conseill de travailler avec la m thode des fichiers de langue 3 Les blocs multilingues Les blocs multi d finis dans l article R aliser un site multilingue fonctionnent aussi bien dans le texte des auteurs ou mots cl s que dans les squelettes Attention ces blocs ne g rent que du texte et pas des boucles SPTP Pour g rer rapidement un site multilingue c est sans doute dans un premier temps la meilleure m thode la fois accessible et efficace ensuite une fois votre site stabilis si vous avez besoin d affiner vos squelettes par exemple pour les ouvrir plus de langues ou pour les distribuer sous forme de contrib ou encore pour les professionnaliser il faudra transformer vos blocs multi en fichiers de langue http www spip net fr_article2128 html 9 of 9 2006 04 17 19 21 41 SPIP Utiliser des URLs personnalis es m Spip et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue E Internationaliser les squelettes m Utiliser des URLS personnalis es m Le moteur de recherche m Les variables de personnalisation m Tidy validation XHTML 1 0 m Le support LDAP m Le traitement des images m Ins rer des formules math matiques en LaTEX m SPIP 1 8 l interface graphique m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es
64. et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue Internationaliser les squelettes m Utiliser des URLS personnalis es m Le moteur de recherche Les variables de personnalisation m Tidy validation XHTML 1 0 m Le support LDAP Le traitement des images m Ins rer des formules math matiques en LaTEX m SPIP 1 8 l interface m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es Traitement automatis des images m fran ais mitaliano SPIP 1 9 et GD2 SPIP permet faire subir aux images des effets automatis s Ces effets ont deux vocations tout simplement assurer la coh rence graphique du site en fabriquant automatiquement des l ments de navigation qui seront toujours r alis s selon les d sirs du graphiste cr er des effets relativement spectaculaires sans pour autant demander aux auteurs des articles de traiter les images eux m mes et sans non plus interdire les volutions graphiques du site par la suite Par exemple on veut pour interface graphique que les logos de navigation des articles aient deux aspects dans tous les cas ils sont pos s sur le sol avec un reflet sous eux au repos ils sont en noir et blanc assez fonc s survol s ils sont en couleur Sans les automatismes qui suivent les webmestres ont pris l
65. et ses sous rubriques article es htmli le squelette pour les articles en espagnol article html le squelette pour les articles article dist html le squelette pour les articles livr avec SPIP Note sauf pour quelques exceptions il faut utiliser ici les codes de langues deux lettres normalis s par l ISO comme es On en trouvera notamment la liste sur le site de la Biblioth que du Congr s des Etats Unis eh oui Pour s assurer d un maximum de compatibilit il faut utiliser en priorit les codes ISO deux lettres iso 639 1 quand ils existent et pour une d signation plus sp cialis e d une langue dans sa famille linguistique les codes ISO trois lettres iso 639 2 T Par exemple l allemand sera d sign comme de Mais l ISO ne prend en compte que 182 langues sur les 5 000 7 000 langues parl es dans le monde pour les langues non encore r pertori es on peut s inspirer du r pertoire propos par le site ethnologue com pour en savoir plus rendez vous sur la liste spip trad Se simplifier la vie Une des m thodes de structuration tr s simple qu autorise SPIP pour g rer un site multilingue consiste associer directement les langues aux rubriques et non article par article Ainsi dans le cas o les articles d une m me langue sont regroup s dans une m me rubrique voire par secteurs on peut se contenter de cr er les squelettes sp cifiques par rubr
66. fond du bloc en fonction d une couleur de texte Appliquons en couleur de fond la couleur extraite de l image lt div style background color On obtient donc selon le logo de l article soit un fond fonc soit un fond clair Appliquons pour la couleur du texte la couleur extraite rendue extr me HLOGO _ARTICLE couleur_ extraire http www spip net fr_article3326 html 5 of 6 2006 04 17 19 26 14 SPIP Couleurs automatiques Si la couleur est fonc e la couleur extr me est noire nous crivons en noir sur fond fonc Si la couleur est claire la couleur extr me est blanche nous crivons en blanc sur fond clair Dans les deux cas c est peu lisible On pourra utiliser cette couleur pour un autre effet par exemple une bordure autour du div Il nous reste inverser cette couleur pour l appliquer au texte lt div style color HLOGO ARTICLE couleur _extraire couleur extreme couleur_inverser backaround color Si la couleur extraite est fonc e la couleur extr me est noire et l inverse est alors blanche On crit en blanc sur fond fonc Si la couleur extraite est claire la couleur extr me est blanche et l inverse est noire On crit en blanc sur fond clair Dans les deux cas le contraste assure une bonne lisibilit http www spip net fr_article3326 html 6 of 6 2006 04 17 19 26 14 SPIP Traitement automatis des images m Spip
67. fran ais mcatal mEspa ol mitaliano Cela s effectue avec le crit re age qui est l ge de l article calcul depuis sa date de mise en ligne dans l espace public en nombre de jours Ainsi pour conserver tous les articles de moins d un an dans la rubrique courante Le crit re de s lection qui nous int resse ici est age lt B_ articles recents gt lt ul gt lt BOUCLE _ articles _ recents ARTICLES id_rubrique age lt 365 par titre gt lt li gt TITRE lt li gt lt BOUCLE_ articles recents gt luls Pour prendre en compte l ge vis vis de la date de premi re publication au lieu de la date de mise en ligne il faut utiliser le crit re age redac au lieu de age L ge est indiqu en nombre de jours Notons que cette manipulation est possible avec tous les types de donn es auxquels est associ e une date br ves forums http www spip net fr_article1497 html 1 of 2 2006 04 17 19 33 1 SPIP Ne pas afficher les articles publi s depuis plus d un an d un an m Pr senter les r sultats d une recherche par secteurs m Afficher le nombre de messages du forum li un article m Un menu d roulant pour pr senter une liste d articles m Remplir les meta tags HTML des pages d article http www spip net fr_article1497 html 2 of 2 2006 04 17 19 33 1 SPIP Pr senter les r sultats d une recherche par secteurs m Afficher automatiquement se
68. gt lt BOUCLE_articles ARTICLES id_rubrique gt TITRE la balise TTTRE d signe le titre d un article Ainsi si on voulait afficher le titre de la rubrique l int rieur de la boucle _ articles on ne pourrait pas utiliser TITRE Depuis SPIP 1 8 on peut appeler une balise homonyme de l une des boucles englobantes en explicitant le nom de la boucle laquelle la balise appartient Il faut alors sp cifier le nom de la boucle entre le et le nom de la balise On crira alors la balise BALISE dela boucle_boucle 1 de la fa on suivante _ boucle BALISE Par exemple lt BOUCLE_ rubriques RUBRIQUES id_rubrique gt lt BOUCLE_articles ARTICLES id_rubrique gt _rubriaues TITRE gt TITRE affichera le titre de la rubrique puis le titre de l article la balise TITRE pour la boucle rubriques devient _rubriques TITRE pour ne pas tre confondue avec la balise TITRE dela boucle _ articles Filtrer les r sultats Il est fr quent de vouloir modifier un l ment tir de la base de donn es soit pour obtenir un affichage diff rent par exemple afficher le titre enti rement en majuscules ou pour r cup rer une valeur d coulant de cet l ment par exemple afficher le jour de la semaine correspondant une date Dans SPIP on peut directement appliquer des filtres aux l ments r cup r s de la base de donn es en les indiquant dans la syntaxe des balises SPIP qui devient
69. gt d une boucle s affichant si la boucle ne fournit pas de r sultat ici s il n y a pas de document joint l article portant le titre spip logo Nous avons obtenu le r sultat d sir s il existe un document joint associ l article auquel nous avons donn le titre spip logo il est directement affich sinon c est le logo normal qui est affich Exclure ces documents sp cifiques de l affichage normal des documents joints Dans le squelette des articles on affiche les documents joints gr ce la BOUCLE_documents_joints dont les crit res essentiels sont lt BOUCLE documents _joints DOCUMENTS On appelle les DOCUMENTS li s cet article id_article qui sont bien des documents joints et non des images mode document et qu on n a pas d j affich s l int rieur du texte de l article en utilisant le raccourci lt EMBxx gt doublons Modifions ce code pour interdire l affichage dans cette boucle qui est une sorte de portfolio gt des documents dont le nom commence par spip onne veut pas afficher ici le gros logo utilis en page de Une du site lt BOUCLE documents _joints DOCUMENTS Le crit re titre spip _ est une expression r guli re dont la syntaxe est tr s codifi e On s lectionne les documents dont le titre n est pas form ainsi le signifie qui ne correspond pas l expressio
70. haut de page ce document lt BOUCLE doc _haut DOCUMENTS id_article titre spip_haut gt EMBED DOCUMENT Comme dans l exemple pr c dent j affiche le document li l article de cette page et dont le titre est spip haut Fastoche Comme dans le premier exemple je pourrais d cider d afficher le logo de l article si ce document n existe pas lt BOUCLE doc haut DOCUMENTS id_article titre spip_haut gt EMBED_DOCUMENT lt BOUCLE_doc_haut gt LOGO ARTICLE http www spip net fr_article2001 html 7 of 10 2006 04 17 19 32 21 SPIP Plusieurs logos pour un article Mais a n est pas le r sultat d sir J e veux pour des imp ratifs graphiques toujours afficher une grande image aux dimensions pr d termin es Je vais donc toujours un choix arbitraire de ma part cr er des images de substitution utilis es par d faut au cas o un article n aurait pas d image en propre Ces images r pondent mes imp ratifs graphiques par exemple elles ont toutes les m mes dimensions que les documents que j utilise d habitude en spip haut Sur mon site je cr e une rubrique pour accueillir en vrac ces documents de substitution J active les documents associ s aux rubriques J e peux aussi cr er un article qui accueillerait tous ces documents et ainsi ne pas activer les documents joints aux rubriques Le code serait peine diff rent Admettons que cette rubrique porte
71. html 2 of 3 2006 04 17 19 32 34 SPIP Afficher les derniers articles de vos r dacteurs par rubrique Code pour article choisi au hasard lt B_appel_article gt Dernier article crit par lt BOUCLE nom _auteur AUTEURS id_auteur gt NOM lt BOUCLE nom auteur gt lt br gt lt BOUCLE _ appel_article ARTICLES id_auteur gt lt BOUCLE_ appel rubrique article RUBRIQUES id_rubrique par titre doublons gt TITRE majuscules lt ul gt lt BOUCLE_ rappel_article ARTICLES id_rubrique par hasard doublons 0 15 gt lt li gt lt a href URL ARTICLE gt Et enfin Maintenant il faut configurer votre page auteur page o vous num rez vos diff rents auteurs pour que en cliquant sur le lien auteur celui ci dirigera vers la page myauteur o sera inscrit les derniers articles crits par l auteur Le lien devra tre crit de la mani re suivante lt a href myauteur php3 id_ auteur ID_ AUTEUR gt nom du lien lt a gt ati http www spip net fr_article1561 html 3 of 3 2006 04 17 19 32 34 SPIP Afficher des l ments par lignes dans un tableau m Afficher automatiquement selon la date ou selon un ordre impos m Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier m Plusieurs logos pour un article m Afficher les derniers articles de vos r dacteurs par rubrique m Afficher des l ments par lignes dans un tableau
72. html 4 of 4 2006 04 17 19 21 50 SPIP Le moteur de recherche m Spip et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue E Internationaliser les squelettes m Utiliser des URLS personnalis es m Le moteur de recherche Les variables de personnalisation m Tidy validation XHTML 1 0 m Le support LDAP m SPIP syst me de publication pour l internet m Documentation en fran ais Guide du webmestre et du bidouilleur m Guide des fonctions avanc es Le moteur de recherche x fran ais m catal mEspa ol mitaliano SPIP int gre un moteur de recherche d sactiv par d faut Ce moteur lorsqu il est activ par un administrateur dans la page de configuration permet d effectuer des recherches sur diff rents types d informations pr sentes dans la base de donn es les articles les rubriques les br ves les mots cl s et les auteurs Depuis SPIP 1 7 1 les fils de discussion des forums threads et les signatures de p titions sont galement index s Principe Il y a deux grandes fa ons de faire un moteur de recherche La premi re est de chercher tout b tement dans le type de stockage existant fichiers HTML base de donn es selon le type de site Cette m thode est tr s lente car le type de stockage n est pas pr vu cet effet La seconde m thode qui a t choisie pour SPIP et qui est aussi celle de tous les moteurs professionnels est d tabli
73. id_rubrique retourne les documents de la rubrique id rubrique id_breve retourne les documents de la br ve id_ breve il n est pas possible d associer des documents multim dia une br ve seulement des images l utilisation d une boucle DOCUMENTS dans ce cadre sera donc tr s sp cifique Notez bien il n est pas possible d utiliser ici le crit re id_secteur les documents sont con us pour tre intimement li s aux articles et aux rubriques et non tre appel s seuls sans ces l ments on parle dans SPIP de documents joints Les crit res d affichage p mode document OU mode image permet d indiquer si l on veut appeler les documents multim dia ou les images en effet d sormais les images associ es l article et ventuellement ins r es dans l article sont trait s comme des documents en mode image N B Dans les sites SPIP existant avant la version 14 l habitude a t prise de ne pas pouvoir afficher les images qui ne sont pas ins r es l int rieur du texte de l article De fait si vous ajoutez un boucle DOCUMENTS en mode image sur un site d j existant vous risquez de voir r appara tre dans cette boucle des images qui n taient pas destin es tre publi es sur le site public Donc n utilisez une telle boucle que sur un site cr avec la version 14 ou bien proc dez avec beaucoup de pr cautions v rifiez les anciens articles pour viter la publication d imag
74. introduit dans SPIP 1 8 affiche l identifiant du fil de discussion auquel appartient ce message Il s agit de l ia_forum du pied de la discussion HURL_FORUM donne depuis SPIP 1 8 l adresse canonique de la page qui affiche le message de forum par exemple avec les URLs normales de SPIP article php3 id_article 8 forumis5 pour le message 15 associ l article 8 ID_BREVE affiche l identifiant de la br ve laquelle ce message est attach Attention cela n est pas r cursif un message qui r pond un message attach une br ve ne contient pas lui m me le num ro de la br ve ID_ ARTICLE est l identifiant de l article auquel r pond le message ID_RUBRIQUE est l identifiant de la rubrique laquelle le message r pond ID_SYNDIC est l identifiant du site auquel le message r pond DATE est la date de publication TITRE est le titre TEXTE est le texte du message NOM_SITE le nom du site Web indiqu par l auteur URL_SITE l adresse URL de ce site Web http www spip net fr_article908 html 3 of 4 2006 04 17 19 11 26 SPIP La boucle FORUMS NOM est le nom de l auteur du message EMAIL est l adresse email de l auteur IP est l adresse IP de l auteur du message au moment de l envoi de sa contribution Les balises calcul es par SPIP HFORMULAIRE FORUM fabrique l interface permettant de poster un message de r ponse Pour en savoir plus
75. l interface graphique de vos pages http www spip net fr_article877 html 5 of 8 2006 04 17 19 09 48 SPIP Principe g n ral Ces fichiers sont r dig s directement en HTML auquel on ajoute des instructions permettant d indiquer SPIP o il devra placer les l ments tir s de la base de donn es du genre placer le titre ici indiquer cet endroit la liste des articles portant sur le m me th me Les instructions de placement des l ments sont r dig es dans un langage sp cifique qui fait l objet du pr sent manuel d utilisation Ce langage constitue par ailleurs la seule difficult de SPIP Encore un langage H oui il va vous falloir apprendre un nouveau langage Il n est cependant pas tr s compliqu et il permet de cr er des interfaces complexes tr s rapidement Par rapport au couple PHP mySQL vous verrez qu il vous fait gagner un temps fou surtout il est beaucoup plus simple C est un markup language c est dire un langage utilisant des balises similaires celles du HTML Remarque De la m me fa on que l on apprend le HTML en s inspirant du code source des sites que l on visite vous pouvez vous inspirer des squelettes utilis s sur d autres sites fonctionnant sous SPIP Il suffit d aller chercher le fichier html correspondant Par exemple vous pouvez voir le squelette des articles d uZine visualisez le code source pour obtenir le texte du squelette Un
76. le serveur qui h berge votre site Il faut donc que ces syst mes soient pr sents en plus de SPIP dit autrement il ne suffit pas que SPIP soit install pour que les fonctions de traitement d images soient disponibles il faut en fait que ces fonctions soient pr sentes par ailleurs Veuillez s lectionner la meilleure m thode de fabrication des vignettes en chquant sur l image correspondante FRS convert N B S aucune kmage n apparait alors le serveur qui h berge votre site n a pas t configur pour utiliser de tels outis Si vous souhaitez utiliser ces fonctions Contacter le responsable technique et demandez les extensions GO ou Imagick Le choix d un syst me de traitement d images se fait dans la partie Configuration configuration avanc e de l espace priv SPIP permet de choisir parmi 5 m thodes diff rentes de traitement des images Imagemagick Imagemagick en tant qu extension de PHP php imagick est le choix privil gi par SPIP SPIP est capable de d terminer seul sa pr sence Si Imagemagick est pr sent sur votre serveur alors SPIP l utilisera automatiquement Si Imagemagick n est pas pr sent sur votre serveur alors SPIP vous proposera de choisir parmi d autres m thodes Ces m thodes n tant pas d tectables par SPIP et en tout cas pas parfaitement une vignette vous est propos e pour chaque m thode ou ventuellement pas de vignette si la m thode ne fonctionne pas
77. m me site la pr sentation des articles dans diff rentes rubriques doit tre diff renci e dans certaines rubriques les articles sont publi s les uns apr s les autres on veut donc les pr senter selon l ordre chronologique les plus r cents en d but de liste les plus anciens en fin de liste dans d autres rubriques on veut forcer l affichage des articles en les num rotant 1 Le premier article 2 Le deuxi me article sur le site public on veut donc les pr senter selon cet ordre indiqu par la num rotation Voici une m thode pour r aliser cet effet Nous sommes l int rieur d une boucle de rubrique par exemple la page rubrique html lt BOUCLE_rubrique_principale RUBRIQUES id_rubrique gt l int rieur de cette boucle nous allons effectuer le test suivant est ce qu il http www spip net fr_article2035 html 1 of 3 2006 04 17 19 31 51 SPIP Afficher automatiquement selon la date ou selon un ordre impos nombre de existe dans cette rubrique au moins un article dont le titre commence par un messages du forum num ro suivi d un point li un article m Un menu d roulant pour lt BOUCLE_test_numero ARTICLES pr senter une liste id_rubrique titre 1 0 9 0 1 gt d articles Il existe un article num rot dans cette m Remplir les meta tags HTML des pages d article Le crit re int ressant ici est titre 1 0 9
78. m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives m La popularit des articles m La gestion des dates m Exposer un article dans une liste id_breve retourne les messages correspondant cette br ve id syndic retourne les messages correspondant ce site id thread introduit dans SPIP 1 8 retourne les messages appartenant ce fil de discussion Note id_thread n est rien d autre que l identifiant i d_forum du message qui d marre le fil de discussion aussi appel pied de la discussion id parent retourne les messages d pendant d un autre message Indispensable pour g rer des fils de discussion threads dans les forums id_enfant retourne le message dont d pend le message actuel permet de remonter dans la hi rachie des fils de discussion SPIP 13 meme _ parent retourne les autres messages r pondant un m me message SPIP 1 3 plat ou tout affiche tous les messages de forum sans prendre en compte leur hi rarchie avec ce crit re vous pouvez s lectionner tous les messages quelle que soit leur position dans un thread dans la limite des autres crit res bien s r Cela permet par exemple d afficher les messages par ordre strictement chronologique par exemple ou de comp
79. main par exemple Une fois un auteur connect il est authentifi par la voie classique c est dire simplement avec le cookie de session Ainsi on ne se connecte LDAP que lors du login spip _cookie php3 De m me les infos prises en compte dans l affichage et les boucles sont celles de spip auteurs pas celles de l annuaire http www spip net fr_article1910 html 2 of 3 2006 04 17 19 22 49 SPIP Le support LDAP Pour les auteurs SPIP rien ne change On peut les cr er et les modifier comme l habitude http www spip net fr_article1910 html 3 of 3 2006 04 17 19 22 49 SPIP Le traitement des images m Spip et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue Internationaliser les squelettes m Utiliser des URLS personnalis es m Le moteur de recherche Les variables de personnalisation m Tidy validation XHTML 1 0 m Le support LDAP E Le traitement des images E Ins rer des formules math matiques en LaTEX m SPIP 1 8 l interface m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es Le traitement des images E fran ais m catal mEndglish mEspa ol mitaliano W occitan E 00000e SPIP 1 8 permet d utiliser les syst mes de traitement d images install s sur votre site d h bergement Introduites dans la version 1 7 ces fonctions de SPIP sont com
80. me post traitement des fichiers tir s du cache de SPIP La partie xhtml true en revanche fonctionne comme une variable de personnalisation vous pouvez si vous souhaitez faire des essais ou restreindre le fonctionnement une partie du site d finir cette variable au niveau du fichier d appel par exemple article php3 si vous ne voulez passer tidy que sur les articles Nettoyez votre code Encore une fois il faut bien comprendre que Tidy n est capable de rendre conforme que du code qui est d j l origine tr s propre Avec les squelettes livr s avec SPIP eux m mes d j conformes HTML 4 et le code produit par d faut par SPIP cela ne pose aucun probl me le code est tr s proche du HTML 4 conforme compliant aussi Tidy n a aucun mal en faire du XHTML 10 transitional parfaitement conforme Lorsque Tidy a bien fonctionn vous constatez dans le code source de vos pages que le DOCTYPE de votre page est devenu XHTML que le code est joliment indent que l ensemble passe la validation W3C sans difficult Si le DOCTYPE n est pas modifi c est que Tidy a renonc corriger la page dans laquelle il a rencontr des erreurs impossibles pour lui corriger http www spip net fr_article3070 html 4 of 7 2006 04 17 19 22 38 SPIP Tidy validation XHTML 1 0 Les erreurs peuvent avoir deux sources les squelettes et le texte des articles
81. ment identiques et si certains endroits on peut vouloir afficher une s lection de tous les groupes de mots cl s ceux que l ont a rendu accessibles aux visiteurs depuis l espace priv d autres endroits on peut vouloir n utiliser que certains groupes voire aucune groupe pas de s lection de mots cl s du tout La variable afficher_groupe est un tableau array et se construit donc de la fa on suivante afficher_groupel 3 afficher groupel 5 impose l affichage uniquement des groupes 3 et 5 afficher_groupel 0 interdit l utiliser des mots cl s dans ces forums puisqu il n existe pas de groupe de mots cl s num rot 0 http www spip net fr_article1825 html 3 of 6 2006 04 17 19 22 25 SPIP Les variables de personnalisation Si l on n indique rien on ne pr cise pas afficher_ groupe tous les groupes de mots cl s indiqu s dans l espace priv comme propos s aux visiteurs du site public sont utilis s Interdire l affichage des boutons d admin Toutes les pages de squelette se voient ajouter des boutons d amin notamment recalculer cette page lorsqu on est administrateur et qu on a activ le cookie de correspondance Cette fonctionnalit tr s pratique pour g rer le site peut s av rer malpratique dans certains cas par exemple pour des fichiers XML que l on ne veut en aucun cas voir perturb s par de tels ajouts SP P 1 7 La variable f1ag_
82. moiti des articles de cette rubrique qui n ont pas encore t affich s par la BOUCLE prem donc la moiti des 10 articles suivants c est dire les 5 derniers articles de la rubrique Vous avez donc perdu 5 articles dans l op ration Affichage entre les r sultats inter permet d indiquer un code HTML ici inter ins r entre les r sultats de la boucle Par exemple pour s parer une liste d auteurs par une virgule on indiquera lt BOUCLE_auteurs AUTEURS id_article rappel le premier r sultat est num rot 0 donc le 200 r sultat repr sente r ellement la 201 signature http www spip net fr_article900 html 8 of 8 2006 04 17 19 13 8 SPIP Les balises propres au site E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle Pare y mE TERN m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence Les balises propres au site m catal mDeutsch wm English m Espa ol E fran ais m ccccce m italiano Les balises suivantes sont disponibles n importe quel endroit du squelette m me en dehors d une boucle Balises d finies la con
83. nom qui ne commence ni par inc ni par Spip Tester Une fois une modification importante apport e il est bon de la tester soi m me sans attendre que quelqu un d autre le fasse sa place Dans le cadre de SPIP cela veut dire v rifier que le programme marche de mani re correcte sur un certain nombre d h bergeurs par exemple Altern Free et de configurations par exemple diff rentes versions de PHP de MySQL restriction plus ou moins grande des droits d acc s aux r pertoires mais aussi qu un certain nombre de situations parmi les plus courantes dans le cas d une interface graphique notamment sont trait es correctement Partager vos modifications Une fois que vous tes satisfait de votre modification du code il est grand temps http www spip net fr_article825 html 4 of 5 2006 04 17 2 23 56 SPIP Contribuer au d veloppement de SPIP d en parler avec les autres d veloppeurs de SPIP et de voir s il m rite d tre int gr la distribution officielle de SPIP Rendez vous sur la liste de diffusion spip dev A bient t SR g 7 af http www spip net fr_article825 html 5 of 5 2006 04 17 2 23 56 SPIP Mise en page manuel de r f rence ai e aie ii m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence Mise en page manuel de r f rence Comment cr er sa propre mise
84. of 2 2006 04 17 19 12 45 SPIP La boucle HIERARCHIE DOCUMENTS m La boucle SYNDIC_ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives E La popularit des articles m La gestion des dates m Exposer un article dans une liste correspondant l identifiant sp cifi Les crit res id_article ou id_rubrique ne peuvent pas tre utilis s avec une comparaison Par exemple lt BOUCLE_hi HIERARCHIE id_article 12 gt retournera une erreur Attention cette boucle sera obligatoirement plac e l int rieur d une boucle ARTICLES o RUBRIQUES elle ne va pas par elle m me chercher l id_ article ou id rubrique indiqu e dans l URL Le m me principe vaut pour les boucles HIERARCHIE des squelettes inclus par la commande lt INCLURE xxx php3 gt Les crit res d affichage Depuis SPIP 1 8 tous les crit res de La boucle RUBRIQUES peuvent tre utilis s avec cette boucle y compris les crit res de tri il devient possible par exemple de trier une lt BOUCLE_x HIERARCHIE id_article par hasard gt Historique Jusqu la version SP P 1 7 2 Les crit res communs toutes les boucles ne s appliquent pas tous ce type de boucle Seuls les crit res inter et a b taient utilisables Les ba
85. option avant BALISE filtrel filtre2 filtren option apr s La syntaxe est donc de faire suivre le nom de la balise entre les parenth ses par les filtres succesifs s par s par une barre verticale nomm e habituellement pipe http www spip net fr_article899 html 4 of 6 2006 04 17 19 10 24 SPIP La syntaxe des balises SPIP Voici quelques filtres fournis par SPIP majuscules passe le texte en majuscules plus puissant que la fonction de PHP correspondante qui ne fonctionne pas correctement avec les caract res accentu s par exemple TITRE ma juscules justifier affiche le texte en justification totale c est dire lt P align justify gt par exemple TEXTE justifier La pr sente documentation consacre un article aux diff rents filtres livr s avec SPIP Court circuiter le traitement par SPIP SPIP applique un traitement typographique tous les textes tir s de la base de donn es En particulier il place des espaces ins cables avant certains symboles point virgule point d interrogation etc et analyse des raccourcis de mise en page Dans certains cas vous pouvez avoir besoin de court circuiter ce traitement afin de r cup rer directement le texte brut tel qu il est plac dans la base de donn es Pour cela il suffit d ajouter une ast risque la suite de la balise SPIP Ce qui donne option avant BALISE filtrel filtre2 filtren option apr
86. par FICHIER image floulimage flou Au pire le calcul se fera en deux recalcul de squelette le premier floutage http www spip net fr_article3327 html 7 of 13 2006 04 17 19 26 49 SPIP Traitement automatis des images tant sauvegard en cache Attention 2 ce filtre agrandit l image en ajoutant tout autour de l image une marge quivalente la valeur de floutage Ainsi avec le param tre 3 par d faut on ajoute 3 pixels de chaque c t de l image et le r sultat aura donc 6 pixels de large et de haut de plus que l image d origine image _ rotation Le filtre image_rotation fait tourner l image d un angle gal au param tre pass Les valeurs positives sont dans le sens des aiguilles d une montre Iimage_rotation 90 image _rotation 20 FICHIER image rotation 20 FICHIER image rotation 90 Sauf pour les rotations angle droit la rotation provoque un effet d escalier Nous avons tent de le limiter mais il reste toujours pr sent Une solution pour r duire cet effet consiste r duire l image apr s avoir appliqu la rotation Attention ce filtre est relativement lourd Attention 2 ce filtre modifie les dimensions de l image image _flip_ vertical et image _flip_horizontal http www spip net fr_article3327 html 8 of 13 2006 04 17 19 26 49 SPIP Traitement automatis des images Le filtre image_flip_vertical applique un effet
87. par la suite encore voluer radicalement l interface graphique de votre site Sans avoir supprimer un par un tous les documents intitul s spip haut spip titre il vous suffit de cr er de nouveaux squelettes qui http www spip net fr_article2001 html 9 of 10 2006 04 17 19 32 21 SPIP Plusieurs logos pour un article ne les appellent tout simplement pas Par exemple si les documents spip_ haut taient pr c demment tous con us pour une largeur de 450 pixels et que la nouvelle interface graphique requiert des images d une largeur de 600 pixels vous n aurez pas besoin de modifier un par un tous vos fichiers spip _ haut Il vous suffit dans les squelettes de ne plus faire appel aux documents intitul s spip _haut mais d utiliser un nouveau nom par exemple spip large et d installer au fur et mesure vos nouvelles versions de documents en les titrant spip large Pendant la transition il n y aura pas d incoh rences graphiques Les plus jet s d entre vous peuvent m me imaginer toutes sortes de tests sur le type de document extension ousurleurtaile 1argeur hauteur aucun PHP n cessaire pour r aliser des interfaces selon ces tests par exemple une certaine interface graphique si spip haut fait 450 pixels de largeur et une autre s il fait 600 pixels de largeur http www spip net fr_article2001 html 10 of 10 2006 04 17 19 32 21 SPIP Affic
88. quelques recettes savoir plus Des couleurs et du relief Une nouvelle qui ravira les d butants en CSS on peut changer la couleur des champs et des boutons des formulaires 2 http www spip net fr_article2336 html 1 of 3 2006 04 17 19 29 40 SPIP Ils sont beaux mes formulaires Par exemple pour que les boutons aient un fond bleu clair ajoutez la r gle suivante votre fichier CSS qui si vous avez suivi cette initiation la lettre s appellemes_styles css Spip_bouton background color bOdOFF color black Les boutons apparaissent d sormais avec un fond bleu clair propri t background color et un texte noir Notez que spip_bouton est le style utilis par les boutons et champs des formulaires SPIP Modifions maintenant l aspect du bord des boutons Le relief traditionnel des boutons HTML est un peu vieillot On peut d cider d aplatir les bords et de les paissir en contrepartie pour qu ils restent bien visibles Par exemple Sspip_bouton background color bOdOFF color black border 2px solid 000060 La propri t border ainsi d finie trace un bord pais de 2 pixels l aspect plat solid en langage CSS et de couleur bleu fonc autour des boutons On pourra galement modifier la police de caract res du bouton avec les propri t s font size et font family comme vu aux tapes pr c dentes de cette initiation Et pour les champs Il suffit d appliquer vos
89. ralenti http www spip net fr_article1496 html 1 of 2 2006 04 17 19 33 17 SPIP Pr senter les r sultats d une recherche par secteurs plus d un an m Pr senter les r sultats d une recherche par secteurs m Afficher le nombre de messages du forum li un article m Un menu d roulant pour pr senter une liste d articles m Remplir les meta tags HTML des pages d article http www spip net fr_article1496 html 2 of 2 2006 04 17 19 33 17 SPIP Afficher le nombre de messages du forum li un article m Afficher automatiquement selon la date ou selon un ordre impos m Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier m Plusieurs logos pour un article m Afficher les derniers articles de vos r dacteurs par rubrique m Afficher des l ments par lignes dans un tableau m Ne pas afficher les articles publi s depuis m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Trucs et astuces Afficher le nombre de messages du forum li un article E fran ais m catal mEspa ol mitaliano C est un poil acrobatique premi re vue il est tr s simple de conna tre le nombre d l ments d une boucle il suffit d utiliser le code SPIP TOTAL BOUCLE Ce code peut s utiliser non seulement l int rieur de la boucle mais aussi c est le seul dans ce cas dans le texte conditio
90. s Les param tres des balises Depuis SPIP 1 8 certaines balises 2 acceptent des param tres On passera alors une liste de param tres entre accolade gt et avec des virgules pour s parer chaque param tre Par exemple ENV lang fr Un param tre peut tre une constante ou une autre balise Seulement les balises de forme simple peuvent tre pass es en param tres i e pas de code optionnel ou de filtres On peut mettre les param tres entre guillemets simples si l on ne veut pas qu ils soient interpr t s par SPIP http www spip net fr_article899 html 5 of 6 2006 04 17 19 10 24 SPIP La syntaxe des balises SPIP 1 Pr cision n oubliez pas le cas ch ant l underscore boucle si celui ci ne commence pas par un num ro 2 ENV et EX POSER http www spip net fr_article899 html 6 of 6 2006 04 17 19 10 24 tt n initial dans le nom dela SPIP La boucle ARTICLES E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle Pars m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La boucle ARTICLES m catal mDeutsch
91. s un groupe de mots cl s principe identique au type_mot pr c dent mais puisque l on travaille avec un identifiant num ro du groupe la syntaxe sera plus propre Nota Ce crit re n est pas en l tat actuel du d veloppement de SPIP cumulable avec le pr c dent type _mot yyyy SP P 1 7 1 Lang s lectionne les articles de la langue demand e dans l adresse de la page SPIP 1 7 2 Les crit res date ou date ou date permettent de s lectionner un article en fonction de la date pass e dans l URL recherche retourne les articles correspondant aux mots indiqu s dans http www spip net fr_article902 html 2 of 6 2006 04 17 19 10 42 SPIP La boucle ARTICLES l interface de recherche moteur de recherche incorpor SPIP Voir la page consacr e au moteur de recherche Le statut de l article Comme toutes les boucles de SPIP une boucle ARTICLES ne retourne que des articles publi s dans le cas o le site est r gl de mani re ne pas publier les article post dat s un autre test est fait sur la date de l article Jusqu SPIP 1 8 2 il n existait aucun moyen de d brayer ce syst me et d afficher les articles en cours de r daction propos s la publication ou refus s C est d sormais possible gr ce au crit re statut statut prop prepa publie refuse poubelle SPIP 18 2 s lectionne les articles en fonction de leur statut de pu
92. si les balises sont en majuscules les crit res de classement sont en minuscules Cas particulier par hasard permet d obtenir une liste pr sent e dans un ordre al atoire Inverser le classement De plus inverse provoque l affichage du classement invers Par exemple par date commence par les articles les plus anciens http www spip net fr_article900 html 1 of 8 2006 04 17 19 13 8 SPIP Les crit res communs toutes les boucles DOCUMENTS m La boucle SYNDIC_ ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives m La popularit des articles m La gestion des dates m Exposer un article dans une liste avec par date inverse on commence la liste avec les articles les plus r cents Classer par num ro SPIP 1 3 Lorsqu on r alise le classement selon un l ment de texte par exemple le titre le classement est r alis par ordre alphab tique Cependant pour forcer un ordre d affichage on peut indiquer un num ro devant le titre par exemple 1 Mon premier article 2 Deuxi me article 3 Troisi me etc avec un classement alphab tique le classement de ces l ments donnerait la s rie 1 10 11 2 3 Pour r tablir le classement selon les num ros on peut utiliser le crit re
93. text nom bio nom site url site pgp sont bio text respectivement le nom de l auteur sa courte biographie son adresse e mail le nom et l URL de son site Web sa cl PGP Informations modifiables librement par l auteur email login sont son e mail d inscription et son login Ils ne sont modifiables que par un administrateur email tinytext nom_site tinytext url site text login tinytext pass est le hash MD5 du mot de passe pass tinyblob htpass est la valeur crypt e i e g n r e par crypt statut tinytext du mot de passe pour le htpasswd maj timestamp 14 Statut est le statut de l auteur Ominirezo pgp bigi administrateur 1comite r dacteur 5poubelle la poubelle 6 forum abonn aux forums lorque ceux ci sont r gl s en mode par abonnement maj a la m me signification que dans les autres tables htpass tinyblob Les br ves spip_ breves id breve bigint 21 Chaque br ve est identifi e par son id_ breve date_ heure datetime id_ rubrique est la rubrique en fait le secteur dans titre text laquelle est class e la br ve titre texte lien titre lien_ url sont le titre le texte longblob gt 7 R A a ai texte le nom et l adresse du lien associ la br ve ns date _ heure est la date de la br ve lien_url text statut est le statut de la br ve prop propos e la statut varchar publication publie publi e refuse refus e id_rubrique bigi
94. un article dans une liste id_ rubrique retourne la rubrique dont l identifiant est id_rubrique Comme l identifiant de chaque rubrique est unique ce crit re retourne une ou z ro r ponse id_ secteur retourne les rubriques de ce secteur On peut galement par extension utiliser le crit re branche d crit dans La boucle ARTICLES id_ parent retourne la liste des rubriques contenues dans une rubrique racine retourne la liste des secteurs rigoureusement identique id_parent 0 id_enfant retourne la rubrique qui contient la rubrique une seule r ponse ou z ro r ponse si la pr sente rubrique est situ e la racine du site meme_parent retourne la liste des rubriques d pendant de la m me rubrique que la rubrique en cours Permet d afficher les rubriques s urs qui se trouvent au m me niveau dans la hi rarchie recherche retourne les rubriques correspondant aux mots indiqu s dans l interface de recherche moteur de recherche incorpor SPIP Voir la page consacr e au moteur de recherche partir de la version SPIP 1 4 les rubriques peuvent tre li es des mots cl s Les crit res de mots cl s peuvent donc tre d sormais utilis s dans les boucles RUBRIQUES e id_mot titre_mot xXx r cup rent les rubriques li es au mot dont le num ro est id mot ou dont le titre est titre mot e id_groupe type _mot yyyy r cup rent les rubriques li es d
95. 04 17 19 27 12 SPIP La structure de la base de donn es dans l espace public prive crit en r action un article dans l espace priv privrac crit dans le forum interne dans l espace priv o f supprim ou valider selon la mod ration des forums a priori ou a posteriori ip est l adresse IP de l auteur dans les forums publics maj a la m me signification que dans les autres tables Les p titions spip_ petitions id_article bigint 21 id_article identifie l article auquel est associ e la email_unigque char 3 p tition une seule p tition par article site obli char 3 email unique site _obli site unique message d finissent la configuration de la p tition l adresse e mail des signataires doit elle tre unique dans les signatures l adresse Web est elle obligatoire est elle unique un message attenant aux signatures maj timestamp 14 est il autoris oui ou non texte est le texte de la p tition maj pareil que dans les autres tables site unique char 3 message char 3 texte longblob Les signatures de p titions spip_ signatures id_signature bigint 21 Chaque signature est identifi e par son id_article bigint 21 id_signature date time datetime id_article identifie l article donc la p tition sur 7 laquelle est appos e la signature nom email ad_email nom site url_ site sont le nom l adresse e mail ainsi que le site Web d clar s no
96. 15 Clairement avec le m me code de squelette si on appelle l adresse k rubrique php3 id_rubrique 7 l interpr tation de cette boucle deviendra Afficher les articles de la rubrique 7 L environnement fourni par les autres boucles l int rieur d une boucle l environnement est modifi par chaque l ment de la boucle En pla ant des boucles les unes l int rieur des autres on h rite ainsi d environnements imbriqu s les uns dans les autres Ainsi dans la structure suivante lt BOUCLE_articles afficher les articles de cette rubrique gt Afficher le titre de l article lt BOUCLE_ auteurs afficher les auteurs de cet article gt Nom de l auteur lt BOUCLE auteurs gt lt BOUCLE articles gt On doit comprendre que la premi re boucle BOUCLE_articles affiche les articles en fonction de la rubrique selon l environnement fournit par l URL id_rubrique 15 par exemple dans cette boucle on obtient un ou plusieurs articles lt l int rieur de chacun de ces articles on a un environnement diff rent http www spip net fr_article898 html 5 of 7 2006 04 17 19 10 12 SPIP La syntaxe des boucles celui de l article c est dire par exemple id_article 199 la seconde boucle BOUCLE_ auteurs qui est install e l int rieur de la premi re boucle d pend pour chacune de ses ex cutions successives elle est ex cut e pour chaque article de la premi re b
97. 25 html 3 of 6 2006 04 17 19 25 4 SPIP Images typographiques TITRE image_typo police stencil ttf align left TITRElimage typo police stencil ttf HEME AHTME STANDARDS HEME AHIME STANDARDS HTME AHTME STANDARDS hauteur_ligne hauteur_ligne permet de fixer la hauteur entre chaque ligne de texte dans le cas o l image comporte plusieurs lignes TITRE image_typo police stencil ttf padding Certaines polices d passent de leur bo te de rendu et on obtient un effet d sastreux polices coup es La variable padding permet exceptionnellement de forcer un espace suppl mentaire autour du rendu http www spip net fr_article3325 html 4 of 6 2006 04 17 19 25 4 SPIP Images typographiques typographique TITRE image typo police stencil ttf Filtrer l image Le r sultat de image_typo tant une image il est tout fait possible de lui appliquer des filtres d images Par exemple ci apr s on rend l image semi transparente ou on lui applique une texture TITRE image _typo police stencil ttf couleur aa2244 image alpha 60 EME NHEME STANDARDS HTML AHTME STANDARDS 1 GD2 est une extension graphique de PHP qui permet de nombreuses manipulations d images En cas de doute demandez votre h bergeur si GD2 est install 2 Attention si vous ne prot gez pas ce dossier votre fichier de police sera accessible par le Web Si vous u
98. 3 spip les formulaires http www spip net fr_article1177 html 7 of 8 2006 04 17 19 21 0 SPIP lt INCLURE gt d autres squelettes m Spip et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue Internationaliser les squelettes E Utiliser des URLS personnalis es m Le moteur de recherche m Les variables de personnalisation m Tidy validation XHTML 1 0 m Le support LDAP Le traitement des images E Ins rer des formules math matiques en LaTEX m SPIP 1 8 l interface graphique m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es lt INCLURE gt d autres squelettes E fran ais meccc cce catal mEnglish mEspa ol mitaliano SPIP 1 4 Lorsque l on a des l ments de texte et des boucles communs plusieurs fichiers on peut vouloir extraire ces l ments des pages o ils se trouvent les installer dans un fichier s par et les appeler depuis les autres squelettes De cette fa on le code commun est regroup dans un unique fichier ce qui facilite notamment les modifications qui concernent plusieurs squelettes d un seul coup Les habitu s de PHP connaissent la fonction include dont le principe est similaire ce qui est pr sent ici Dans SPIP on peut appeler un squelette depuis un autre squelette gr ce la balise lt INCLURE gt on peut aus
99. BOUCLE doc gt il y a TOTAL BOUCLE document s lt B_doc gt Attention si la partie centrale de la boucle ne retourne rien c est le cas avec la boucle lt BOUCLE_doc gt ci dessus qui ne sert qu compter le nombre de r sultats le TOTAL_ BOUCLE ne pourra tre affich que dans la partie alternative apr s de la boucle lt B_doc gt ACOMPTEUR_ BOUCLE retourne le num ro de l it ration actuelle de la boucle On peut par exemple l utiliser pour num roter des r sultats lt BOUCLE_art ARTICLES par date inverse 0 10 gt COMPTEUR BOUCLE TITRE lt br gt http www spip net fr_article898 html 7 of 7 2006 04 17 19 10 12 SPIP La syntaxe des balises SPIP m Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La syntaxe des balises SPIP m catal mDeutsch mEnglish m Espa ol occitan E fran ais Mmeccccce m italiano E Chaque type de boucle permet de s lectionner des l ments de la base de donn es de SPIP des articles des rubriques des br ves etc Chacun de ces l ments est lui m me constit
100. Contribuer au d veloppement de SPIP E fran ais meccccce catal mEspa ol mitaliano Si vous voulez contribuer la programmation de SPIP l id e la plus importante retenir est la suivante vous arrivez sur un projet qui est d j fonctionnel Ce projet est muni d un ensemble de r gles qui toutes arbitraires qu elles peuvent para tre assurent sa coh rence Ces r gles n ont pas besoin d tre nonc es explicitement pour exister certaines sont clairement visibles apr s un examen plus ou moins d taill du code et les r gles tacites doivent tre respect es au m me titre que les autres Il est formellement conseill de bien suivre ces r gles Ce respect n a pas tre li ou non vos go ts personnels il permet de garder sa coh rence et son unit au projet et de le conserver aussi lisible qu il l tait auparavant N oubliez pas que d autres personnes que vous sont amen es lire comprendre voire modifier votre code Par exemple il est vident que les fonctions SPIP sont crites sous la forme ma fonction Dans le cadre de ce projet il serait donc parfaitement d plac d ajouter des fonctions en les crivant MaFonction m me si dans l absolu cette forme n est pas plus critiquable que l autre http www spip net fr_article825 html 1 of 5 2006 04 17 2 23 56 SPIP Contribuer au d veloppement de SPIP Tout ceci n emp che pas videmment de critiquer une r gle et d en proposer une m
101. E _article_principal ARTICLES id_article gt lt h1 gt TITRE lt h1 gt lt BOUCLE _suivant ARTICLES id_rubrique age relatif lt 0 exclus par date 0 1 gt Avtinls nriinsant HTITDE la BOUCLE suivant affiche un seul article de la m me rubrique class par date dont la date de publication est inf rieure ou gale la date de l article principal c est dire l article de la m me rubrique publi apr s l article principal De plus amples informations sur l utilisation des dates se trouvent dans l article sur La gestion des dates Affichage d une partie des r sultats branche A partir de SPIP 1 8 2 limite les r sultats pour des boucles ayant un D RUBRIQUE la branche actuelle la rubrique actuelle et ses http www spip net fr_article900 html 5 of 8 2006 04 17 19 13 8 SPIP Les crit res communs toutes les boucles sous rubriques Par exemple lt BOUCLE_articles ARTICLES branche gt retournera tous les articles de la rubrique actuelle et de ces sous rubriques lt BOUCLE_articles ARTICLES branche gt retournera tous les articles qui ne sont pas dans la rubrique actuelle ou ses sous rubriques On peut utiliser le crit re branche optionnel pour ne l appliquer que si une rubrique est s lectionn e dans le contexte une boucle englobante ou l url fournie un id rubrique Par exemple lt BOUCLE_articles ARTICLES branche gt r
102. EUR_SURVOL permettent un affichage plus fin de ces deux variantes du logo 1 de la boucle englobante ou de l url ds 01201 GY rea http www spip net fr_article907 html 3 of 3 2006 04 17 19 11 16 SPIP La boucle FORUMS E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La boucle FORUMS E fran ais me cccee catal mDeutsch mEnglish m Espa ol mitaliano La boucle FORUMS retourne une liste de messages de forums lt BOUCLEn FORUMS crit res gt Les crit res de s lection On utilisera l un ou autre des crit res suivants pour indiquer comment on s lectionne les l ments id_forum retourne le message dont l identifiant est id_forum Comme l identifiant de chaque message est unique ce crit re retourne une ou z ro r ponse id_article retourne les messages correspondant cet article id_ rubrique retourne les messages correspondant cette rubrique http www spip net fr_article908 html 1 of 4 2006 04 17 19 11 26 SPIP La boucle FORUMS DOCUMENTS m La boucle SYNDIC_ ARTICLES
103. IP m Etiquetage ICRA automatique m Des fils RSS 1 0 RSS 2 0 et Atom 1 0 pour votre site SPIP m Un graphique de popularit m Galerie SPIP PHP simple et pr te l emploi m Abandonnons RSS 0 91 m cSV2spip gestion des utilisateurs de SPIP partir de fichiers CSV SPIP Contrib mes fonctions SPIP Contrib les squelettes Les articles de documentation de SPIP Contrib http www spip net fr_rubrique135 html 2 of 6 2006 04 17 2 22 56 SPIP Guide du webmestre et du bidouilleur Mise en page manuel de r f rence Comment cr er sa propre mise en page pour un site g r sous SPIP m Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES SPIP pas pas Pas pas comment cr er un SPIP qui d fie les limites m Mon premier squelette http www spip net fr_rubrique135 html 3 of 6 2006 04 17 2 22 56 SPIP Guide du webmestre et du bidouilleur m Un squelette plusieurs articles m Une rubrique m Boucles en boucles m G rer le cache m Des filtres Guide des fonctions avanc es Au del du manuel de r f rence vous trouverez ici une description d taill e des fonctions plus avanc es la disposition du webmestre m Spip et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue m Internationaliser les squelett
104. IP Le moteur de recherche La qualit de l indexation est plus faible que sous des moteurs de recherche professionnels PHP tant un langage plut t lent la phase d extraction des mots a d tre simplifi e au maximum pour que les temps d indexation restent minimes Par cons quent les donn es d indexation comportent quelques d chets c est dire des morceaux de texte qui ne correspondent pas de vrais mots mais ont t index s comme tels il s agit souvent de contenus techniques comme des noms de fichiers ou de passages la ponctuation malmen e L exemple d uZine o l on constate environ 2 de tels d chets nous laisse cependant penser que ces donn es sont quantit n gligeable d autant qu il y a peu de chance qu elles d clenchent un r sultat positif lors d une recherche La recherche n offre pas d op rateurs bool ens l op rateur implicite tant grosso modo un O logique Cependant depuis SPIP 1 7 1 les articles trouv s s affichent dans un ordre qui privil gie les r sultats contenant le plus de mots orthographi s pr cis ment selon la requ te Ainsi une requ te sur la main rouge mettra en vidence les articles contenant main et rouge loin devant les articles ne contenant que maintenance ou rouget ceux ci appara tront mais plus loin dans le classement Espace disque MySQL n tant pas sp cialement con u pour le stockage de donn es d in
105. ITES ou SYNDICATION m La boucle m SPIP syst me de publication pour l internet Pars m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La boucle RUBRIQUES m catal mDeutsch wm English m Espa ol m fran ais m italiano La boucle RUBRIQUES retourne une liste de rubriques tonnant non lt BOUCLEn RUBRIQUES crit res gt Remarque Une boucle RUBRIQUES n affiche que des rubriques actives c est dire contenant des articles publi s des documents joints partir de SPIP 1 4 des sites publi s ou des sous rubriques elles m mes actives De cette fa on on vite de se trouver dans des rubriques culs de sac n offrant aucun l ment de navigation partir de la version SPP 1 7 1 il est possible de forcer l affichage des rubriques vides voir ci dessous Les crit res de s lection On utilisera l un ou autre des crit res suivants pour indiquer comment on s lectionne les l ments http www spip net fr_article904 html 1 of 5 2006 04 17 19 10 52 SPIP La boucle RUBRIQUES DOCUMENTS m La boucle SYNDIC_ ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives m La popularit des articles m La gestion des dates m Exposer
106. Ici le filtre af fdate affiche la date en lettres au format 1er juillet 2001 mais renvoie une cha ne vide si la date est inconnue gale 0000 Les crochets d limitent ce qu il faut afficher autour de la date si le resultat entre parenth ses n est pas une cha ne vide R sultat seuls les articles dat s provoquent l affichage d un tableau contenant la date Un squelette bien construit d finira pr cis ment ce qu il faut afficher ou pas en fonction du contenu Les filtres servent aussi a 1 On peut appeler a un pipeline Notons que certains filtres de pr sentation peuvent tre avantageusement remplac s par des feuilles de style Ainsi majuscules est quivalent l attribut CSS text transform uppercase et justifier text align justify Lire Spip et les feuilles de style pour plus de d tails sur les styles CSS offerts par SPIP http www spip net fr_article889 html 2 of 3 2006 04 17 19 18 55 SPIP Guide des fonctions avanc es fran ais O tout le site Modifications r centes m Le calendrier de SPIP 1 8 2 m Internationaliser les m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es Guide des fonctions avanc es Au del du manuel de r f rence vous trouverez ici une description d taill e des fonctions plus avanc es la disposition du webmestre
107. LE ou TOTAL BOUCLE et affiche l argument correspondant la valeur de cette balise On peut ainsi alterner un affichage dans une boucle Par exemple COMPTEUR_BOUCLE alterner white grey affichera white la premi re it ration de la boucle grey la deuxi me white la troisi me grey la quatri me etc A nsi on peut faire une liste d article qui utilise une couleur diff rente pour les lignes paires et impaires lt B_lesarticles gt lt ul gt lt BOUCLE_lesarticles ARTICLES par titre gt lt li style background COMPTEUR_BOUCLEl alterner white grey gt TITRE lt li gt lt BOUCLE_lesarticles gt lt ul gt lt B_lesarticles gt inserer_attribut attribut valeur SPIP 1 8 2 permet d ajouter un attribut html dans une balise html g n r e par SPIP Par exemple LOGO_DOCUMENT inserer_attribut alt TITRE vaajouter un attribut alt avec le titre du document dans la balise img du logo extraire_attribut attribut SPIP 1 8 2 est l inverse du filtre pr c dent Il permet de r cup rer un attribut d une balise html g n r e par SPIP Par exemple on peut trouver le chemin de la vignette g n r e par le filtre reduire image lt div style background url LOGO_ ARTICLE reduire_image 90 extraire attribut src left J gt TEXTE lt div gt parametre _url parametre valeur SPIP 1 8 2 est un filtre qui permet
108. LEFT et LANG_RIGHT Pour ce qui est de la d finition de la page elle m me il est alors judicieux de commencer par donner la langue de l l ment demand et la direction g n rale de la page lt html lang LANG gt lt body dir LANG_DIR gt lt body gt lt html gt 3 Les liens de traduction SPIP propose un syst me de traduction entre articles on peut sp cifier quelles sont les diff rentes traductions d un article note ces traductions sont elles m mes des articles part enti re Le crit re traduction permet alors dans une boucle ARTICLES de r cup rer toutes les versions d un m me article Par exemple pour afficher toutes les traductions de l article courant lt BOUCLE_traductions ARTICLES traduction exclus gt lt a href URL ARTICLE Notons le crit re exclus qui permet de ne pas afficher la version courante et le filtre traduire _nom_langue qui fournit le nom v ritable de la langue partir de son code informatique cela permet d afficher fran ais au lieu de fr English au lieu de en Un crit re compl mentaire origine traduction pour les plus acharn s permet de s lectionner uniquement la version originale de l article courant Une page du wiki de spip contrib rassemble des exemples de boucles utilisant ces crit res http www spip contrib net spikini 4 l ments suppl mentaires http www spip net
109. LE_rubrique d pend de la variable pass e dans l URL dela page id_rubrique 15 par exemple Les boucles suivantes BOUCLE_articles e amp t BOUCLE_sous_rubriques sont install es l int rieur de la premi re boucle Ainsi s il n existe pas de rubrique 15 la premi re boucle ne donne aucun r sultat le code alternatif Il n y a pas de http www spip net fr_article898 html 6 of 7 2006 04 17 19 10 12 SPIP La syntaxe des boucles rubrique est affich et donc les deux boucles incluses sont totalement ignor es Mais s il existe une rubrique 15 ces deux sous boucles seront analys es On constate galement que ces deux boucles se pr sentent l une apr s l autre Ainsi elles fonctionnent en fonction de la premi re boucle mais ind pendamment l une de l autre S il n y a pas d articles dans la rubrique 15 BOUCLE_articles on affichera tout de m me la liste des sous rubriques de la rubrique 15 BOUCLE_sous_rubriques et inversement Compteurs Deux balises permettent de compter les r sultats dans les boucles TOTAL_ BOUCLE retourne le nombre total de r sultats affich s par la boucle On peut l utiliser dans la boucle dans ses parties optionnelles avant et apr s ou m me dans la partie alternative apr s la boucle Par exemple pour afficher le nombre de documents associ s un article lt BOUCLE_ art ARTICLES id_article gt lt BOUCLE_ doc DOCUMENTS id_article gt lt
110. Les balises suivantes correspondent aux l ments directement tir s de la base de donn es Vous pouvez les utiliser galement en tant que crit re de classement g n ralement par titre ID_MOT affiche l identifiant unique du mot TITRE est le titre le mot cl lui m me HDESCRIPTIF est le descriptif du mot TEXTE est le texte associ au mot TYPE est la cat gorie dans laquelle est install ce mot cl par exemple le mot cl France pourrait tre associ la cat gorie Pays http www spip net fr_article909 html 2 of 3 2006 04 17 19 11 38 SPIP La boucle MOTS LOGO_ MOT SPIP 1 4 affiche le logo associ au mot cl HURL MOT donne l adresse de ce mot La boucle GROUPES MOTS D une utilisation marginale la boucle GROUPES _ MOTS SPIP 1 5 m rite d tre cit e ici elle permet si vous avez plusieurs groupes de mots cl s de s lectionner ces groupes et d organiser par exemple une page r capitulative de tous les mots cl s class s par groupe puis par ordre alphab tique l int rieur de chaque groupe par exemple via le code suivant lt BOUCLE_ groupes GROUPES MOTS par titre gt lt h1 gt TITRE lt H1 gt lt BOUCLE_mots MOTS id_groupe par titre gt HTITRE Les balises et crit res associ s cette boucle sont ID_GROUPE l identifiant du groupe de mots galement disponible dans la boucle MOTS TITRE le titre du groupe
111. Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives m La popularit des articles m La gestion des dates m Exposer un article dans une liste SPIP 1 2 id_mot retourne toutes les br ves li es au mot cl en cours l int rieur d une boucle de type MOTS SPIP 1 3 titre mot xxxx ou type mot yyyy retourne les br ves li es au mot cl dont le nom est xxxx ou li es des mots cl s du groupe de mots cl s yyyy Attention on ne peut pas utiliser plusieurs crit res titre mot xxxx OU type mot yyyy dans une m me boucle SPIP 14 id_groupe zzzz permet de s lectionner les br ves li es un groupe de mots cl s principe identique au type_mot pr c dent mais puisque l on travaille avec un identifiant num ro du groupe la syntaxe sera plus propre Lang s lectionne les br ves de la langue demand e dans l adresse de la page recherche retourne les br ves correspondant aux mots indiqu s dans l interface de recherche moteur de recherche incorpor SPIP Voir la page consacr e au moteur de recherche Les crit res d affichage Les crit res communs toutes les boucles s appliquent Les balises de cette boucle Les balises tir es de la base de donn es Les balises suivantes correspondent aux l ments directement tir s de la base de donn es Vous pouvez les utiliser galement en tant que crit re
112. PIP 1 8 2 m Images typographiques m Couleurs automatiques Traitement automatis des images m La structure de la base de donn es c t des variables obligatoires fond et delais Voir les exemples Les variables du texte Ces variables sont utilis es lors du calcul de la mise en page correction typographique par SPIP Sdebut_intertitre fixe le code HTML ins r en ouverture des intertitres par le raccourci En standard sa valeur est debut_intertitre n lt h3 class spip gt n Sfin_ intertitre est le code HTML ins r en fermeture des intertitres raccourci Sa valeur normale est fin_intertitre lt h3 gt n Souvre_ ref est le code d ouverture des appels des notes de bas de page par d faut c est une espace ins cable et un crochet ouvrant ferme_ref est le code de fermeture des appels des notes de bas de page par d faut c est un crochet fermant ouvre_note est le code d ouverture de la note de bas de page telle qu elle appara t dans NOTES par d faut un crochet ouvrant ferme_note est le code de fermeture des notes de bas de page un crochet fermant Des choix alternatifs pourront tre par exemple d utiliser des parenth ses ou plus joliment d ouvrir avec le tag HTML lt sup gt et de fermer avec lt sup gt Lefichier puce gif et la variable puce Lorsque vous commencez une nouvelle ligne par un tiret SPIP le remplace par une p
113. RE lt BR gt lt BOUCLE article gt L on supprime carr ment la condition id_article Attention cette BOUCLE peut g n rer une page norme si votre base contient d j pas mal d articles mieux vaut prendre nos pr cautions et ajouter tout de suite 0 10 pour limiter aux 10 premiers articles lt BOUCLE srticle ARTICLES 0 10 gt R sultat en appelant simplement http votresite net tutoriel php3 plus besoin d id_article d sormais puisque cette condition a t supprim e les titres des 10 premiers articles publi s s affichent s par s chacun par un saut de http www spip net fr_article882 html 1 of 2 2006 04 17 19 18 23 SPIP Une rubrique ligne A partir de l on voit comment on peut produire le sommaire d une rubrique affichons les 10 articles les plus r cents appartenant cette rubrique lt BOUCLE_article ARTICLES id_ rubrique par date inverse 0 10 gt lt a href URL ARTICLE gt TITRE lt a gt lt br gt Prenons dans l ordre id rubrique ne prend que les articles appartenant la rubrique id_rubrique cf ci dessous pour que cette variable soit d finie dans le contexte denotreBOUCLE_article par date inverse trie par date dans l ordre d croissant 0 10 et prend les 10 premiers r sultats Enfin lt a href URL ARTICLE gt TITRE lt a gt Va afficher non seulement le titre de l article mais en plus cr er un lien vers cet article R
114. RUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m SPIP syst me de publication pour l in m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence ternet Principe g n ral mfran ais m e ee mcatal mDeutsch mEnglish mEspa ol mitaliano Tout le contenu d un site g r sous SPIP est install dans une base de donn es mySQL Pour pr senter ces informations aux visiteurs du site il faut donc r aliser l op ration qui consiste lire les informations les organiser et les mettre en page afin d afficher une page HTML dans le navigateur Web Cette op ration est traditionnellement assez p nible il faut conna tre la programmation PHP et MySQL et crire des routines relativement complexes l int gration de telles routines dans une mise en page HTML labor e est assez p nible il faut prendre en compte des probl mes de performances le recours syst matique du code mySQL et PHP est gourmand en ressources ralentit la visite et dans des cas extr mes provoque des plantages du serveur Web SPIP propose une solution compl te pour contourner ces difficult s la mise en page du site est effectu e au moyen de pages HTML nomm es squelettes contenant des instructions simplifi es permettant d indiquer o et comment se placent les informations tir es de la base de donn es dans la page un syst me de cache permet de stocker
115. SYNDICATION m La boucle m SPIP syst me de publication pour l in Pare on ternet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence Les formulaires m catal mDeutsch mEngliish mfran ais meccccce m Espa ol mitaliano SPIP permet une grande interaction du site avec les visiteurs pour cela il propose de nombreux formulaires sur le site public permettant tant t de g rer les acc s l espace priv tant t d autoriser l ajout de messages et signatures Les formulaires s ins rent dans les squelettes par une simple balise SPIP se charge ensuite de g rer le comportement souvent complexe de ces formulaires en fonction de l environnement et des configurations effectu es dans l espace priv Fonctions interactives H FORMULAIRE RECHERCHE Il s agit du formulaire du moteur de recherche int gr SPIP Il est pr sent dans l article sur les boucles de recherche FORMULAIRE FORUM http www spip net fr_article1827 html 1 of 5 2006 04 17 19 13 40 SPIP Les formulaires DOCUMENTS m La boucle SYNDIC_ ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives m La popularit des articles m La gestion des dates m Exposer un article d
116. Titre de l article 2 lt li gt Titre du dernier article Rien de bien compliqu on se contente d indiquer l int rieur du code HTML le nom de l l ment d sir et celui ci est remplac par le contenu tir de la base de donn es Codes optionnels Dans la pratique un l ment de contenu est souvent accompagn de code HTML qui ne doit s afficher que si cet l ment existe faute de quoi la mise en page devient impr cise Par exemple il existe une balise SPIP pour indiquer le surtitre d un article Or de nombreux articles n ont pas de surtitre Compl tons l exemple pr c dent lt BOUCLE_articles ARTICLES id_rubrique gt lt li gt SURTITRE lt br gt TITRE lt BOUCLE articles gt qui classiquement nous donne une liste d articles avec d sormais l indication du titre et du surtitre de chaque article Mais que se passe t il si l article n a pas de surtitre On obtient le code lt LI gt lt BR gt c est dire une petite puce suivie d une ligne blanche Ce que nous devons faire n afficher le code lt BR gt que si un surtitre existe pour l article La syntaxe de la balise SPIP devient alors http www spip net fr_article899 html 2 of 6 2006 04 17 19 10 24 SPIP La syntaxe des balises SPIP texte optionnel avant BALISE texte optionnel apr s La balise qui d termine l option est plac e entre parenth ses et l ensemble du texte conditionnel entre cr
117. UMENT est l URL du fichier multim dia Pour afficher une vignette cliquable pointant vers le document multim dia on utilisera donc le code suivant HLOGO_DOCUMENTI URL_ DOCUMENT TITRE affiche le titre du document DESCRIPTIF affiche le descriptif du document FICHIER SPIP 1 8 2 affiche le nom de fichier du document Une utilisation int ressante de cette balise est combin e avec le filtre reduire image dans le cadre d un portfolio pour afficher une r duction de l image plut t que de son logo par exemple en utilisant lt a href URL_DOCUMENT gt FICHIER TYPE_DOCUMENT affiche le type fichier Quicktime fichier Real du document multim dia TAILLE affiche la taille du fichier multim dia Ce chiffre est fourni en octets http www spip net fr_article1823 html 3 of 4 2006 04 17 19 12 3 SPIP La boucle DOCUMENTS Pour de gros fichiers cette valeur devient rapidement inutilisable on pourra donc lui appliquer le filtretaille_en_octets qui affichera successivement en octets en kilooctets ou m me en m gaoctets TAILLE taille_en_octets LARGEUR t HAUTEUR fournissent les dimensions en pixels TD_ DOCUMENT affiche le num ro du document EMBED_ DOCUMENT est une balise l utilisation tr s sp cifique elle permet d inclure directement les fichiers de formats autoris s vid o sons directement dans la page Web il faut viter d utiliser syst matiquemen
118. Un menu d roulant pour pr senter une liste d articles m Remplir les meta tags HTML des pages d article lt table gt lt B_ligne gt lt tr gt lt BOUCLE ligne ARTICLES id _rubrique doublons par titre 0 3 gt lt td width 33 gt lt a href URL_ ARTICLE TITRE lt a gt lt td gt lt BOUCLE _ligne gt lt tr gt lt BOUCLE ligne suite BOUCLE ligne gt lt BOUCLE ligne _suite gt Le m me type de boucle en rempla ant l appel du titre par le logo avec la balise LOGO ARTICLE permet d afficher une galerie o chaque logo d article donne un aper u dont la taille sera de pr f rence fix e afin d avoir une belle mise en page et le texte de l article contient la ou les oeuvres expos es http www spip net fr_article1498 html 2 of 2 2006 04 17 19 32 49 SPIP Ne pas afficher les articles publi s depuis plus d un an m Afficher automatiquement selon la date ou selon un ordre impos m Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier m Plusieurs logos pour un article m Afficher les derniers articles de vos r dacteurs par rubrique m Afficher des l ments par lignes dans un tableau m Ne pas afficher les articles publi s depuis plus m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Trucs et astuces Ne pas afficher les articles publi s depuis plus d un an E
119. Utiliser des URLS personnalis es m Le moteur de recherche m Les variables de personnalisation m Tidy validation XHTML 1 0 E Le support LDAP m Le traitement des images m Ins rer des m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es Le support LDAP E fran ais meccccce catal mEspa ol mitaliano Attention cet article est vraiment destin des utilisateurs avanc s qui ma trisent l usage de LDAP et souhaitent appuyer SPIP sur un annuaire LDAP existant LDAP Lightweight Directory Access Protocol est un protocole permettant d interroger un annuaire contenant des informations d utilisateurs nom login authentification Depuis la version SPIP 1 5 il est possible de v rifier si un r dacteur est dans la base LDAP avant de lui donner acc s l espace priv A l installation SPIP d tecte si PHP a t compil avec le support LDAP Si oui la cinqui me tape cr er un acc s un bouton permet d ajouter un annuaire LDAP la configuration SPIP La configuration qui suit est relativement simple elle essaie de deviner les param tres au maximum Notamment elle permet de choisir le statut par d faut des auteurs venant de l annuaire ceux ci peuvent tre r dacteurs conseill administrateurs ou simples visiteurs Note par d faut l extension LDAP de PHP n est g n ralement pas activ
120. Utiliser des URLs personnalis es E fran ais m catal mitaliano moccocoe m Espa ol Apr s l installation les pages g n r es par SPIP utilisent des adresses relatives ressemblant article php3 id_article 123 donnant des URLs du type http www spip net article php3 7id_article 123 Ce type de syntaxe courant chez les sites dynamiques n est cependant pas tr s joli ni tr s vocateur Il y a possibilit d avoir des adresses plus votre go t par exemple article123 htmloOuTitre de l article html et SPIP vous aide en partie dans cette t che Cette fonctionnalit fait appel la distinction entre deux types d URLS l URL apparente d une page c est dire telle qu elle est tap e et ou affich e dans la barre d adresse du navigateur Par exemple http www spip net fr_article765 html1 Ce sont ces URLs qu on cherche rendre plus jolies ou plus signifiantes l URL r elle de la page c est dire l URL qui est vue par SPIP lorsque la page est calcul e sur le serveur Par exemple http www spip net article php3 id_article 765 en g n ral cette URL peut aussi tre tap e directement dans le navigateur vous pouvez v rifier Choisir le type d URLSs apparentes http www spip net fr_article765 html 1 of 4 2006 04 17 19 21 50 SPIP Utiliser des URLs personnalis es Le calendrier de SPIP 1 8 2 E Images typographiques m Couleurs automatiques m Traitement
121. _article877 html 3 of 8 2006 04 17 19 09 48 SPIP Principe g n ral Lors d une visite suivante si le d lai entre les deux visites est suffisamment court c est donc ce nouveau fichier stock dans CACHE qui est retourn sans avoir faire un nouveau calcul partir de la base de donn es En cas de plantage de la base de donn es c est forc ment le fichier en cache qui est retourn m me s il est trop g Remarque On voit ici que chaque page du site est mise en cache individuellement et chaque recalcul est provoqu par les visites du site Il n y a pas en particulier un recalcul de toutes les pages du site d un seul coup ch ance r guli re ce genre de grosse manoeuvre ayant le bon go t de surcharger le serveur et de le faire parfois planter Le fichier PHP3 Le fichier php3 est tr s simple Par exemple article php3 contient uniquement lt php fond article delais 24 3600 include inc public php3 gt Son seul but est donc de fixer deux variables fond et delais et d appeler le fichier qui d clenche le fonctionnement de SPIP inc public php3 La variable fond est le nom du fichier qui contient la description de la mise en page le squelette Ici puisque fond article le fichier de description sera contenu dans article html 1 Notez bien que dans la variable fond on n indique pas la terminaison html Remarque L int r t d
122. a on la page de Une du site peut afficher une grande image pour mettre en valeur l article en vedette Afficher spip_ logo en Une du site Commen ons par ins rer une boucle toute simple pour afficher le dernier article publi sur le site et son logo normal Dans tous les exemples qui suivent le code HTML est r duit son strict minimum vous d enrober cela avec la mise http www spip net fr_article2001 html 4 of 10 2006 04 17 19 32 21 SPIP Plusieurs logos pour un article en pages graphique qui vous convient lt BOUCLE article vedette ARTICLES doublons par date inverse 0 1 gt LOGO ARTICLE lt h1 gt TITRE lt h1 gt Cette boucle tr s simple affiche le premier article 0 1 parmi tous les ARTICLES s lectionn s par date de publication par date du plus r cent au plus ancien inverse On affiche donc bien le dernier article publi sur le site l int rieur de la boucle on affiche le logo de l article suivi du titre de l article Nous avons dit que nous voulions afficher la place du logo normal le document joint cet article dont le titre est spip logo Le code devient lt BOUCLE article vedette ARTICLES doublons par date inverse 0 1 gt lt BOUCLE logo _ article vedette DOCUMENTS id_article titre spip_ logo gt HEMBED DOCUMENT lt BOUCLE_ logo_ article vedette gt La BOUCLE_logo_article vedette s lectionne parmi les
123. a boucle ou le num ro de la boucle Cet l ment est choisi par le webmestre pour chaque boucle qu il utilise On verra plus loin qu il est possible c est m me tout l int r t de la manoeuvre d utiliser plusieurs boucles dans un m me squelette leur donner un nom est donc indispensable pour les identifier Si vous d cidez de num roter vos boucles la syntaxe devient par exemple pour la boucle 5 lt BOUCLES gt lt BOUCLES5 gt Si vous d cidez de donner un nom vos boucles c est g n ralement plus pratique votre code est plus lisible il faut imp rativement faire pr c der ce nom par le symbole _ que l on appelle habituellement underscore Par exemple lt BOUCLE_sousrubriques gt lt BOUCLE_sousrubriques gt L l ment TYPE Cet l ment est primordial il indique quel type d l ments on veut r cup rer La syntaxe est importante le TYPE est indiqu entre parenth ses sans espaces en majuscules et ce TYPE doit correspondre obligatoirement l un des types pr vus dans SPIP qu on trouvera dans la pr sente documentation ARTICLES RUBRIQUES AUTEURS BREVES etc Pour l exemple pr c dent on aurait donc lt BOUCLE_sousrubriques RUBRIQUES gt lt BOUCLE_sousrubriques gt Les crit res crit rel crit re2 Ils indiquent la fois selon quels crit res on veut s lectionner les l ments de la base de donn es afficher les sous rubriques incluses d
124. ans cette rubrique afficher les autres rubriques install es au m me niveau hi rarchique que la pr sente rubrique et la fa on dont on va classer ou s lectionner les l ments classer les articles selon leur date selon leur titre afficher uniquement les 3 premiers articles afficher la moiti des articles Comme on peut combiner les crit res on peut tr s ais ment fabriquer des requ tes tr s puissantes du genre afficher la liste des 5 articles les plus r cents crits par cet auteur http www spip net fr_article898 html 2 of 7 2006 04 17 19 10 12 SPIP La syntaxe des boucles lt BOUCLE_meme_auteur ARTICLES id_auteur par date inverse 0 5 gt lt BOUCLE_meme_auteur gt Les diff rents crit res et leur syntaxe seront explicit s dans la suite pour chaque type de boucle certains crit res fonctionnent pour tous les types de boucles certains sont sp cifiques certaines boucles Syntaxe compl te Le syntaxe indiqu e pr c demment peut tre compl t e par des l ments conditionnels En effet la boucle pr c dente affiche successivement les l ments contenus l int rieur de la boucle SPIP permet de plus d indiquer ce qu on affiche avant et apr s la boucle au cas o elle contient un ou plusieurs r sultats et ce qu on affiche s il n y a aucun l ment Cela donne lt Bn gt Code HTML optionnel avant lt BOUCLEn TYPE crit rel crit re2 crit rex gt Co
125. ans une liste Le FORMULAIRE_FORUM g re l interface permettant de poster des messages dans les forums publics Il concerne donc en premier chef la boucle FORUMS mais peut tre utilis dans toutes les boucles acceptant un forum e La boucle ARTICLES e La boucle RUBRIQUES e La boucle BREVES e La boucle SITES ou SYNDICATION Le formulaire d pend videmment du choix des forums mod r s a posteriori a priori ou sur abonnement SPIP 1 8 2 Par d faut une fois le message post le visiteur est renvoy vers la page de l l ment 1 auquel il a r pondu On peut d cider de renvoyer le visiteur vers une autre page en passant une url en param tre cette balise Par exemple e FORMULAIRE_FORUM merci php3 renverra vers la page merci php3 e FORMULAIRE_FORUM SELF renverra vers la page o le formulaire de forum est plac voir la balise SELF Dans le cas tr s sp cifique o l on a autoris la pr sence de mots cl s dans les forums publics on peut affiner le comportement de ce formulaire avec des variables de personnalisation FORMULAIRE_SIGNATURE Le FORMULAIRE_SIGNATURE autorise la signature des p titions associ es aux articles ce formulaire se place donc dans une boucle ARTICLES N B La signature des p titions r clame obligatoirement une validation des signataires par email Ce formulaire n a donc d int r t que si votre h bergeur autorise l envoi de mails par PHP
126. ant ce langage est tr s simple et il suffit de quelques exemples pour se mettre le pied l trier 1 Cascading Style Sheets litt ralement feuilles de style en cascade ieg af http www spip net fr_article2330 html 3 of 3 2006 04 17 19 28 52 SPIP Des styles qui ont de la class E Introduction m Des styles qui ont de la class m Une typographie personnalis e mis sont beaux mes formulaires m Pour en savoir plus m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m initiation utiliser les feuilles de style avec SPIP Des styles qui ont de la class E fran ais m catal mDeutsch English m Espa ol w italiano Dans l article pr c dent nous avons expos de mani re g n rale les avantages des feuilles de style Ici nous expliquons les apports suppl mentaires des feuilles de style lorsqu elles sont utilis es en conjonction avec SPIP Les styles d finis par SPIP Comme vous le savez d sormais les feuilles de style permettent de centraliser et de g rer de mani re beaucoup plus ais e les indications graphiques que l on ins rait traditionnellement dans le HTML Cela rend leur utilisation appr ciable sans tre forc ment indispensable vous pouvez continuer ins rer par endroits des indications graphiques directement dans le HTML tout en utilisant aussi une feuille de style Dans SPIP les feu
127. ant de l objet index par exemple l id article http www spip net fr_article713 html 6 of 7 2006 04 17 19 27 12 SPIP La structure de la base de donn es pour un article et le nombre de points associ l indexation du mot dans l objet Ce nombre de points est calcul en fonction du nombre d occurences du mot pond r par le champ o ont lieu les occurences une occurence dans le titre d un article g n re plus de points qu une occurence dans le corps de l article Le m canisme d indexation est expliqu plus en d tail ici SAR P http www spip net fr_article713 html 7 of 7 2006 04 17 19 27 12 SPIP Initiation utiliser les feuilles de style avec SPIP m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur a initiation utiliser les feuilles de style avec SPIP Initiation utiliser les feuilles de style avec SPIP Pour tirer parti de toute la souplesse de SPIP il est recommand d utiliser les feuilles de style Pas de panique cette petite initiation permettra aux d butants de raccrocher les wagons a Introduction a Des styles qui ont de la class Une typographie personnalis e a lis sont beaux mes formulaires fran ais a Pour en savoir plus O tout le site Modifications r centes http www spip net fr_rubrique269 html 1 of 2 2006 04 17 19 28 38 SPIP Introduction E Introduction m Des styles qui o
128. antiques permettant de proposer des recherches plus fines etc L avantage du moteur interne cependant c est qu il permet de g rer l affichage des r sultats travers les m mes m thodes squelettes que le reste des pages de SPIP et l int rieur du m me environnement visuel L indexation L indexation est r alis e lors des visites du site public Afin d viter que le cumul d une indexation et d un calcul de page ne m ne un timeout sur les serveurs particuli rement lents SPIP attend qu une page soit affich e en utilisant le cache 1 L indexation traite une une les diff rentes donn es textuelles d un contenu donn par exemple pour un article le chapo le descriptif le titre le texte Pour chaque donn e textuelle le score de chaque mot est calcul en comptant simplement le nombre d occurrences A cet effet les mots de trois caract res ou moins sont ignor s ils sont pour la plupart non significatifs et alourdiraient la base de donn es d autre part les caract res accentu s sont translitt r s convertis en leurs quivalents non accentu s pour viter les probl mes de jeux de caract res et aussi pour permettre d effectuer des recherches en version non accentu e Ensuite les scores de chaque mot sont cumul s de fa on pond r e entre les diff rentes donn es textuelles du contenu index La pond ration permet par exemple de donner plus de poids aux mots pr sents dans le tit
129. appara t sur les butineurs ne comprenant pas Javascript http www spip net fr_article3037 html 5 of 9 2006 04 17 19 24 22 SPIP SPIP 1 8 l interface graphique 609 Terminal lynx 85x43 SPIP Modifier C est quoi SPIP pi of 5 S5 suivre dition Forum Auteurs Visiter RACINE O SITE Documentation en fran ais 1 Pr sentation et premiers pas Retour Modifier l article C est quoi SPIP Titre Obligatoire ra ON Te Mi a d c RSR SR RS n titre Un syst me de publication pour l intern l int rieur de la rubrique EL Pr sentation ct promiers POs l i N oubliez pas de s lectionner correctement ce chomp Chop Texte introductif de l article Arrow keys Up and Do to move Right to follow a link Left to go back Help Options Print Go Mjain screen Qhuit seorch delete history List E Il est possible de revenir l interface habituelle en suivant le lien propos en bas de page Retour l interface graphique compl te Notez qu alors vous revenez en interface dite simplifi e L quipe des d veloppeurs liste de discussion spip dev est tr s int ress e par des retours d exp rience de la part d utilisateurs concern s par cette interface Nous manquons cruellement de t moignages pour am liorer le syst me en fonction de tels utilisateurs On notera que cette interface est galement particuli rement adapt e aux connexio
130. arrive fr quemment qu il n y ait pas d l ments satisfaisants tel ou tel endroit SPIP doit alors pouvoir g rer l ventualit de l absence de ces l ments par exemple le squelette de l affichage des rubriques demande l affichage de toutes les sous rubriques contenues dans une rubrique que faire alors s il n y a pas sous rubriques dans cette rubrique sp cifique Ces trois situations sont trait es par la notion unique de boucle qui permet la fois de g rer l affichage d un seul l ment de plusieurs l ments successifs ou l absence d l ments Le syst me de boucle permet dans un code unique d indiquer quel endroit du code HTML on a besoin de quel type d l ment tel endroit on veut r cup rer la liste des articles tel endroit on veut inclure la liste des sous rubriques de pr voir l affichage d un l ment unique d indiquer comment est affich e une liste de plusieurs l ments de d terminer ce qu on affiche lorsqu il n y a aucun l ment correspondant Analogie avec la programmation en PHP mySQL Ceux qui ont d j programm des requ tes mySQL en PHP savent que le traitement se d roule en deux temps la construction de la syntaxe de la requ te qui consiste dire je veux r cup rer la liste des articles contenus dans telle rubrique l analyse et l affichage des r sultats au travers d une boucle Ce sont ces deux v nements qui sont
131. ation pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es La structure de la base de donn es E fran ais meccccce catal mEspa ol mitaliano La structure de la base de donn es est assez simple Certaines conventions ont t utilis es que vous rep rerez assez facilement au cours de ce document Par exemple la plupart des objets sont index s par un entier autoincr ment dont le nom est du type id_ob jet et qui est d clar comme cl primaire dans la table appropri e NB cet article commence dater et personne n a encore pris la peine d en faire la mise jour Il faut le lire comme un l ment permettant de comprendre le fonctionnement de SPIP mais plus comme un outil de r f rence Si vous souhaitez contribuer la documentation en refondant cet article surtout n h sitez pas Contenu r dactionnel Les rubriques spip_ rubriques http www spip net fr_article713 html 1 of 7 2006 04 17 19 27 12 SPIP La structure de la base de donn es graphique m Le calendrier de SPIP 1 8 2 E Images typographiques m Couleurs automatiques m Traitement automatis des images E La structure de la base de donn es id_rubrique bigint 21 id parent bigint 21 Chaque rubrique est identifi e par son id_ rubrique titre text id_ parent est l id rubrique de la rubrique qui descriptif text contient cette rubrique z ro si la rubrique se tr
132. aturel L indentation sera faite de pr f rence avec le caract re de tabulation Cela permet de choisir librement la profondeur d indentation dans les options de son diteur de texte tout en n imposant pas ce choix aux autres d veloppeurs Tout bloc contenu l int rieur d une paire d accolades sera indent d une et une seule tabulation De m me r cursivement pour les sous blocs ajout d une et une seule tabulation suppl mentaire chaque entr e dans un niveau de profondeur suppl mentaire Cette r gle vaut bien aussi pour la d claration de fonctions Le code qui ne fait pas partie d une fonction ne doit pas tre indent L utilisation des transitions PHP HTML lt php et gt doit tre minimis e http www spip net fr_article825 html 2 of 5 2006 04 17 2 23 56 SPIP Contribuer au d veloppement de SPIP L viter lors qu il s agit d afficher uniquement de petits morceaux de HTML Ne pas oublier qu un petit morceau de code PHP ins r au milieu d un oc an de HTML est invisible sans un examen tr s attentionn Typographie Lors de l utilisation de parenth ses ou de crochets il ne faut pas laisser d espace apr s la parenth se ouvrante ni avant la parenth se fermante Lors de l utilisation d op rateurs binaires AND il faut laisser un espace de part et d autre de l op rateur Exception manifeste dans cette phrase o les op rateurs sont mentionn s et non
133. bas dans cette FAQ Cr er ses squelettes L Peut on utiliser un diteur textuel pour cr er et modifier ses squelettes Oui comme on le ferait pour du HTML classique 2 Peut on utiliser un diteur graphique WYSIWYG pour cr er et modifier ses squelettes Oui comme on le ferait pour du HTML classique Voir cependant la question suivante 3 J essaie d utiliser un diteur graphique pour cr er mes pages mais http www spip net fr_article1054 html 2 of 3 2006 04 17 2 23 28 SPIP FAQ webmestre il modifie les tags SPIP Peut on r soudre ce probl me Certains diteurs graphiques corrigent automatiquement les tags qu ils ne comprennent pas La plupart ont toutefois une option permettant de d sactiver cette fonctionnalit Nous avons consacr un article sp cifique DreamWeaver mais la d marche est quivalente pour les autres diteurs GoLive Partager vos cr ations L J ai crit des squelettes pour mon site Comment fais je pour qu ils soient disponibles tous N h sitez pas vous inscrire sur le site SPIP Contrib mentionn plus haut afin de proposer vos squelettes au t l chargement et que d autres puissent leur tour s en inspirer pour cr er leur propre site http www spip net fr_article1054 html 3 of 3 2006 04 17 2 23 28 SPIP Rapidit du site public m S curit SPIP et IIS E Qu est ce que les fichiers dist m FAQ webmestre x Rapidit du site pub
134. blication e statut prepa sont les articles en cours de r daction dans l espace priv e statut prop sont les articles propos s la publication e statut publie sont les articles publi s sur le site y compris les articles post dat s e statut refuse sont les articles qui ont t refus s la publication e statut poubelle sont les articles qui ont t mis la poubelle Les crit res d affichage Une fois fix l un des crit res ci dessus on pourra ajouter les crit res suivants pour restreindre le nombre d l ments affich s Les crit res communs toutes les boucles s appliquent videmment exclus permet d exclure du r sultat l article dans lequel on se trouve d j par exemple lorsque l on affiche les articles contenus dans la m me rubrique on ne veut pas afficher un lien vers l article dans lequel on se trouver d j Les balises de cette boucle Les balises tir es de la base de donn es Les balises suivantes correspondent aux l ments directement tir s de la base de http www spip net fr_article902 html 3 of 6 2006 04 17 19 10 42 SPIP La boucle ARTICLES donn es Vous pouvez les utiliser galement en tant que crit re de classement par exemple par date ou par titre ID_ARTICLE affiche l identifiant unique de l article Utile pour fabriquer des liens hypertextes non pr vus par exemple vers une page Afficher au format impression
135. certainement plusieurs visions de ce qu on appelle multilinguisme d autre part nous manquons toujours de recul pour pouvoir d finir la meilleure m thode Vous trouverez donc ci dessous une revue des diff rents outils que SPIP propose pour g rer des sites multilingues vous de les utiliser et discutons en dans les espaces pr vus cet effet wiki listes de discussion etc Mais avant delire oubliez un peu votre projet du jour et pensez aux situations suivantes un site de po sies class es par th mes rubriques un site de documentation pour par exemple un logiciel comme SPIP un site institutionnel en 25 langues un site corporate bilingue le site d une association bulgare avec quelques pages en anglais http www spip net fr_article2124 html 1 of 8 2006 04 17 19 21 27 SPIP R aliser un site multilingue math matiques en LaTEX m SPIP 1 8 l interface graphique Le calendrier de SPIP 1 8 2 m Images typographiques m Couleurs automatiques m Traitement automatis des images m La structure de la base de donn es Le site de po sie choisira plut t ses langues article par article la documentation de SPIP pour sa part les ventile par secteurs rubriques de premier niveau et affiche les traductions disponibles pour chaque article quand ces traductions sont disponibles Le site institutionnel en 25 langues ne pourra sans doute pas fournir les 25 tradu
136. cette liste de travail est destin e discuter de la programmation de SPIP et non pas la programmation avec SPIP Le fait que votre probl me soit compliqu et implique l utilisation de PHP et MySQL n est pas une raison pour poster sur spip dev toutes les questions li es l utilisation de SPIP y compris les plus techniques doivent tre post es sur la liste des utilisateurs mentionn e plus haut Merci d avance de votre compr hension Merci de consulter attentivement les archives de spip dev avant de poster sur la liste ceux qui y participent ont fourni de gros efforts pour d velopper le syst me il est normal que vous fassiez votre tour un petit effort de documentation pour que l change d information soit aussi efficace http www spip net fr_rubrique205 html 2 of 3 2006 04 17 19 35 16 SPIP Le d veloppement de SPIP et ses outils que possible http www spip net fr_rubrique205 html 3 of 3 2006 04 17 19 35 16
137. chaque image vous risquez d obtenir des erreurs de timeout temps maximum d ex cution des scripts d pass Cela dit m me interrompu le script aura certainement calcul quelques images http www spip net fr_article3327 html 2 of 13 2006 04 17 19 26 48 SPIP Traitement automatis des images avant de s arr ter et ces images seront sauvegard es en cache Ainsi quand les pages seront recalcul es les images seront directement r utilis es depuis le cache et on n aura plus d erreurs Cet avertissement concerne en priorit les h bergeurs mutualis s Transparences Dans SPIP 1 9 si l on utilise GD2 outre les fonctions expos es dans cet article vous constaterez que les r ductions d image reduire_image respectent la transparence des fichiers GIF et PNG 24 transparence par couche alpha Dans la configuration du site pensez s lectionner GD2 comme m thode de r duction d image L image d origine Toute image g r e par SPIP peut se voir appliquer les filtres suivants Sont donc concern s les logos d articles de rubriques mais aussi les images de portfolio images en tant que fichiers joints aux articles sans oublier les nouvelles images typographiques Voici pour nos exemples une image traiter http www spip net fr_article3327 html 3 of 13 2006 04 17 19 26 48 SPIP Traitement automatis des images Image d origine image nb Le filtre image_nb passe une image en niveaux de
138. che les articles publi s dans la semaine actuelle sous forme de calendrier Enfin le filtre agenda_connu teste si son argument est l un des quatre types de calendriers connus jour semaine mois OUperiode Ce crit re et ces filtres sont utilis s par les nouveaux squelettes agenda_jJour html agenda semaine html agenda_ mois html e tagenda_periode html appel s partir du squelette agenda htm1 qui indique dans son en t te les feuilles de style et fonctions javascript n cessaires mais rempla ables volont Ces squelettes fournissent donc un exemple repr sentatif d utilisation http www spip net fr_article3182 html 4 of 5 2006 04 17 19 24 40 SPIP Images typographiques m Spip et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue Internationaliser les squelettes m Utiliser des URLS personnalis es m Le moteur de recherche Les variables de personnalisation m Tidy validation XHTML 1 0 m Le support LDAP Le traitement des images m Ins rer des formules math matiques en LaTEX m SPIP 1 8 l interface m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es Images typographiques E fran ais mocatal mitaliano SPIP 19 et GD2 Si GD2 est install sur votre site 1 SPIP peut fabriquer de lui m me des images partir de titres ou tout l m
139. chniques Ces filtres ont t introduits par SPIP 1 4 entites_ html transforme un texte en entit s HTML que l on peut donc implanter dans un formulaire exemple lt textarea gt DESCRIPTIF entites_ html lt textarea gt texte _ script transforme n importe quel champ en une cha ne utilisable en PHP ou J avascript en toute securit exemple lt php x TEXTE texte_script gt Attention utilisez bien le caract re et non en effet dans le second cas si votre texte contient le symbole le r sultat peut tre catastrophique affichage partiel affichage d autre chose plantage php etc http www spip net fr_article901 html 9 of 11 2006 04 17 19 14 18 SPIP Les filtres de SPIP attribut _ html rend une cha ne utilisable sans dommage comme attribut HTML par exemple si l on veut ajouter un texte de survol au lien normal vers un article on utilisera lt a href URL ARTICLE title DESCRIPTIF supprimer_tags attribut_ html J gt TITRE lt a gt liens _absolus SPIP 1 8 2 s applique sur une balise de texte et transforme tous les liens que celui ci contient en liens absolus avec l url compl te du site Ce filtre est particuli rement utile dans des squelettes de fil rss par exemple url absolue SPIP 18 2 marche de la m me fa on que le filtre pr c dent mais s applique une balise qui retourne une url par exemple URL ARTICLE abs url SPIP 1 8 2 combi
140. choix au style formul au lieu de spip_bouton Un peu d espace Les feuilles de style permettent non seulement de changer les couleurs et les polices de caract res mais aussi de g rer le positionnement relatif des objets dans la page Sans aller tr s loin montrons comment a rer un peu les formulaires formulaire background color e8f4ff font family Verdana Arial sans serif http www spip net fr_article2336 html 2 of 3 2006 04 17 19 29 40 SPIP Ils sont beaux mes formulaires font size 90 font weight normal border 1px solid black padding 10px Nous modifions ici l affichage du style formulaire qui est le style principal de tous les formulaires g n r s par SPIP L int r t de modifier ce style est que l on peut g rer l affichage de tous les formulaires Ici l on applique une couleur de fond tr s claire et une police de caract res Mais surtout on modifie l espacement int rieur de chaque formulaire pris individuellement C est la propri t padding qui permet cet effet d a ration Notez bien que cette a ration se produit pr cis ment l int rieur du bord d fini par la propri t border le formulaire est ici consid r comme un bloc rectangulaire autonome Remarque les feuilles de style permettent m me de d finir pr cis ment la disposition de ces blocs rectangulaires entre eux sans utiliser de tableaux pour la mise en page C est cependant un sujet trop vaste po
141. crit res gt Les crit res de s lection http www spip net fr_article910 html 1 of 3 2006 04 17 19 11 51 SPIP La boucle SITES ou SYNDICATION m La boucle SYNDIC_ ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives E La popularit des articles m La gestion des dates m Exposer un article dans une liste On utilisera l un ou autre des crit res suivants pour indiquer comment on s lectionne les l ments tout tous les sites r f renc s id syndic retourne le site r f renc dont l identifiant est id_syndic id_ rubrique retourne les sites r f renc s dans cette rubrique id_ secteur retourne les sites r f renc s dans ce secteur SPIP 1 3 id_mot retourne toutes les sites li s au mot cl en cours l int rieur d une boucle de type MOTS SPIP 1 3 titre mot xxxx ou type mot yyyy retourne les sites li s au mot cl dont le nom est xxxx ou li s des mots cl s du groupe de mots cl s yyyy Attention on ne peut pas utiliser plusieurs crit res titre mot xxxx OU type mot yyyy dans une m me boucle SPIP 14 id_groupe zzzz permet de s lectionner les sites li s un groupe de mots cl s principe identique au type_mot pr c dent mais pui
142. ction consistant r cup rer une couleur dans une image est compl t e par toute une s rie de fonctions permettant de manipuler cette couleur principalement claircir et foncer la couleur La liste de fonctions est longue de fa on permettre un nombre tr s important d effets couleur extraire partir d une image logo d article logo de rubrique mais aussi images de portfolio on demande SPIP de tirer une couleur HLOGO RUBRIQUE couleur_extraire http www spip net fr_article3326 html 1 of 6 2006 04 17 19 26 14 SPIP Couleurs automatiques graphique m Le calendrier de SPIP 1 8 2 E Images typographiques m Couleurs automatiques E Traitement automatis des images m La structure de la base de donn es Attention il ne s agit pas pour SPIP de d terminer la couleur dominante de l image mais d extraire une couleur de l image Pour que cette couleur soit r ellement repr sentative l image est r duite une taille de 20 pixels maximum ainsi les diff rentes couleurs de l image sont relativement moyenn es Cette valeur de 20 pixels est exp rimentale elle est suffisamment basse pour viter d extraire une couleur tr s peu pr sente dans l image elle est suffisamment lev e pour viter que la couleur soit syst matiquement gris tre Utilis e sans param tres la fonction couleur_extraire retourne une couleur situ e l g rement au dessus du centre de l image Il
143. ctions en m me temps mais cherchera tout de m me conserver des arborescences parall les le site corporate bilingue aura obligatoirement une traduction en face de chacun des articles et une arborescence de rubriques en deux parties la partie anglaise tant clon e sur la partie en auvergnat l association bulgare affectera l anglais un secteur particulier de son site le reste des secteurs tant tous en bulgare par d faut Principe Pour pouvoir autoriser ces situations diff rentes et d autres encore le mod le mis en place dans SPIP consiste d terminer une langue pour chaque article chaque rubrique et chaque br ve Dans l espace public comme dans l espace priv cette langue d termine le mode de correction typographique qui est appliqu aux textes dans l espace public cela d termine galement la langue des lements ins r s par SPTP autour de ces objets dates et formulaires principalement Pour cr er un site multilingue avec SPIP il faut d abord configurer le site en cons quence dans la configuration du site la section langues bien entendu L vous pourrez activer la gestion du multilingue et choisir les langues que vous utiliserez sur votre site Configurer l espace priv Pour g rer plus facilement le site on peut choisir dans la configuration du site avec quelle pr cision s effectuera le r glage des langues ce qui permet de masquer l interface l o elle n
144. d connection Par exemple URL_LOGOUT sommaire php3 renverra vers la page de sommaire Voici un exemple simple mais complet d utilisation de ces deux balises Il faut passer par un peu de php pour tester la variable Sauteur_session qui indique qu un auteur est identifi ou non Si c est le cas on peut r cup rer voire tester son statut son login etc via auteur_sessionl statut Notez bien que le contenu n est s curis que sur ce squelette Si votre squelette imprimer cet article par exemple ne v rifie par auteur_session tout le monde y compris les moteurs de recherche pourra avoir acc s ce fameux contenu que vous souhaitez prot ger http www spip net fr_article1827 html 4 of 5 2006 04 17 19 13 40 SPIP Les formulaires lt php if fauteur_ session gt Vous tes authentifi lt a href URL_ LOGOUT gt cliquez ici pour vous d connecter lt a gt ici le contenu en acc s restreint lt php else gt lt h2 gt Cette partie est en acc s restreint lt h2 gt Feuilles de style On peut notablement modifier l interface graphique des formulaires par l int rm diaire des feuilles de style notamment les classes forml spip_encadrer etspip_ bouton 1 article rubrique br ve site ou forum http www spip net fr_article1827 html 5 of 5 2006 04 17 19 13 40 SPIP Les boucles de recherche E Principe g n ral m Des boucles et des balis
145. d ajouter des param tres dans une url g n r e par une balise SPIP Si valeur vaut le filtre supprime un param tre actuellement dans l url Si valeur n est pas sp cifi le filtre retourne la valeur actuelle du param tre Par exemple la balise SELF retourne l url de la page actuelle donc e SELF parametre_url id_article r cup reral id article pr sent dans l url e SELF parametre_url id_article 12 placera une variable id_ article gale 12 dans l url http www spip net fr_article901 html 8 of 11 2006 04 17 19 14 18 SPIP Les filtres de SPIP e SELF parametre_url id_article effacral id article actuellement dans l url On peut par exemple l utiliser pour faire des boutons pour naviguer parmi les documents sur une page lt BOUCLE actuel DOCUMENTS id document gt LOGO_DOCUMENT lt ul gt lt BOUCLE_precede DOCUMENTS par date age _ relatif lt 0 0 1 fexclus gt lt li gt lt a href SELF parametre url id document ID_DOCUMENT title pr c dent gt LOGO_DOCUMENT reduire_image 70 lt a gt lt li gt lt BOUCLE_precede gt lt BOUCLE_suivant DOCUMENTS par date age_relatif gt 0 0 1 gt lt li gt lt a href SELF parametre_url id_document ID_DOCUMENT title suivant gt LOGO_DOCUMENT reduire_image 70 lt a gt lt li gt lt BOUCLE_suivant gt lt ul gt lt BOUCLE_actuel gt Filtres te
146. d origine on obtient donc une sorte de vignette de l image Si le masque est plus grand que l image d origine on l applique l image non redimensionn e Cela est pratique pour texturer une image On peut ainsi r aliser l effet suivant 5 E PS en appliquant un masque en niveau de gris masque que nous avons cr plus grand que l image d origine Attention l impact sur la luminosit est plus important sur l image finale que http www spip net fr_article3327 html 12 of 13 2006 04 17 19 26 49 SPIP Traitement automatis des images dans le fichier masque Attention 2 en r alit le masque de luminosit est un masque de coloration Si l image masque est color e alors on modifiera non seulement la luminosit mais aussi les couleurs de l image Mais cet effet est particuli rement difficile ma triser notamment en partant d images en couleur http www spip net fr_article3327 html 13 of 13 2006 04 17 19 26 49 SPIP La structure de la base de donn es m Spip et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue Internationaliser les squelettes m Utiliser des URLS personnalis es m Le moteur de recherche Les variables de personnalisation m Tidy validation XHTML 1 0 m Le support LDAP Le traitement des images m Ins rer des formules math matiques en LaTEX m SPIP 1 8 l interface m SPIP syst me de public
147. dans ces sous rubriques utiliseront galement le nouveau squelette article 60 html Remarque Dans notre exemple on aura certainement galement int r t cr er un rubrique 60 html Voireunbreve 60 html etc pour accompagner le changement de mise en page de cette rubrique Une interface pour une seule rubrique SPIP 1 3 On peut cr er une interface qui s applique une rubrique mais pas ses sous rubriques Pour cela il faut cr er un fichier article 60 html qui s appliquera uniquement aux articles de la rubrique 60 mais pas ses sous rubriques Que peut on mettre dans un fichier HTML Les fichiers htm1 sont essentiellement des fichiers texte compl t s d instructions de placement des l ments de la base de donn es SPIP analyse uniquement les instructions de placement des l ments de la base de donn es cod es selon le langage sp cifique de SPIP il se contrefiche de ce qui est plac dans ce fichier et qui ne correspond pas ces instructions Leur contenu essentiel est donc du HTML Vous d terminez la mise en page la version du HTML d sir etc Vous pouvez videmment y inclure des feuilles de style CSS mais galement du JavaScript du Flash en gros tout ce qu on place habituellement dans une page Web Mais vous pouvez galement tout cela n est jamais que du texte cr er du XML par exemple backend php3 html g n re du XML Plus original toutes les pages retour
148. de HTML balises SPIP lt BOUCLEn gt Code HTML optionnel apr s lt Bn gt Code HTML alternatif lt Bn gt Le code optionnel avant pr c d de lt Bn gt n est affich que si la boucle contient au moins une r ponse Il est affich avant les r sultats de la boucle Le code optionnel apr s termin par lt Bn gt n est affich que si la boucle contient au moins une r ponse Il est affich apr s les r sultats de la boucle Le code alternatif termin par lt Bn gt est affich la place de la boucle et donc galement la place des codes optionnels avant et apr s si la boucle n a trouv aucune r ponse Par exemple le code lt B1 gt Cette rubrique contient les l ments suivants http www spip net fr_article898 html 3 of 7 2006 04 17 19 10 12 SPIP La syntaxe des boucles lt ul gt lt BOUCLE1 ARTICLES id_rubrique gt lt li gt TITRE lt l1i gt lt BOUCLE1 gt lt ul gt lt B1 gt Cette rubrique ne contient pas d article lt B1 gt donne les r sultats suivants s il y a un seul article Cette rubrique contient les l ments suivants lt ul gt lt li gt Titre de l article lt li gt lt ul gt s il y a plusieurs articles Cette rubrique contient les l ments suivants lt ul gt lt li Titre de l article 1 lt li gt lt li gt Titre de l article 2 lt li gt lt li gt Titre du derni
149. de classement g n ralement par titre ID_BREVE affiche l identifiant unique de la br ve TITRE retourne le titre de la br ve DATE retourne la date de publication de la br ve TEXTE retourne le texte de la br ve HNOM_ SITE le nom du site indiqu en r f rences http www spip net fr_article906 html 2 of 4 2006 04 17 19 11 2 SPIP La boucle BREVES HURL_ SITE l adresse URL du site indiqu en r f rences ID_RUBRIQUE l identifiant de la rubrique dont d pend cette br ve LANG donne la langue de cette br ve Par d faut la langue d une br ve est la langue du secteur dans lequel elle se trouve Les balises calcul es par SPIP Les l ments suivants sont calcul s par SPIP Ils ne peuvent pas tre utilis s comme crit re de classement NOTES les notes de bas de page calcul es partir de l analyse du texte HINTRODUCTION les 600 premiers caract res du texte les enrichissements typographiques gras italique sont supprim s HURL_BREVE est l URL de la page de la br ve HFORMULAIRE FORUM fabrique l interface permettant de poster un message r pondant cette br ve Pour en savoir plus voir aussi Les formulaires HPARAMETRES_ FORUM fabrique la liste des variables exploit es par l interface du formulaire permettant de r pondre cette br ve Par exemple lt A HREF forum php3 PARAMETRES_ FORUM gt R pondre cette br ve lt A gt Depuis
150. de squelette ou dans le r pertoire ecrire lang local_fr php3 pour d finir les cha nes en fran ais local_en php3 en anglais historique Dans les versions ant rieures SPIP 1 8 les fichiers de langue personnels se pla aient seulement dans le r pertoire ecrire lang Par exemple on pourra cr er les cha nes suivantes telechargement pour afficher T l charger la derni re version quoideneuf pour afficher Modifications r centes Selon cette m thode on ins re dans les squelettes les codes lt telechargement gt et lt quoideneuf gt ils seront ensuite affich s avec les traductions correspondantes telles qu elles sont d finies dans les fichiers 1ocal_ php3 Notons que les codes sont arbitraires c est vous qui les choisissez Nous recommandons bien videmment de choisir des codes qui vous permettent de les retenir facilement plut t que des num ros par exemple Comme souvent avec les codes informatiques il est pr f rable de n utiliser que des lettres de l alphabet latin et sans accents 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 Ils contiendront par exemple Version fran aise lt php SGLOBALSI SGLOBALSfl idx_lang array telechargement gt T amp eacute l amp eacute c
151. dexation l utilisation du moteur de recherche a tendance faire beaucoup grossir l espace disque utilis par la base de donn es Pour donner quelque pr cision disons qu un contenu g n re des donn es d indexation de taille comprise entre la taille du contenu et le double de celle ci Donc si l on fait abstraction des donn es ne donnant pas lieu indexation les forums par exemple l indexation fait entre doubler et tripler la place prise par la base de donn es Cela peut tre g nant si la place vous est tr s compt e Si jamais vous d sactivez le moteur de recherche afin d conomiser de l espace disque n oubliez pas ensuite d effacer les donn es d indexation dans la page de sauvegarde restauration de la base de donn es afin de r ellement lib rer l espace disque occup par ces donn es 1 Si donc vous avez mis tous les delais z ro ou si votre site n est pas visit site de test l indexation n aura pas lieu http www spip net fr_article996 html 4 of 4 2006 04 17 19 22 8 SPIP Les variables de personnalisation m Spip et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue E Internationaliser les squelettes E Utiliser des URLS personnalis es m Le moteur de recherche a Les variables de personnalisation m Tidy validation XHTML 1 0 m Le support LDAP m Le traitement des images E Ins rer des formules math matiques en LaTEX m SPIP
152. dicatif comme tout programme il peut tre install quasiment n importe o NetPBM http www spip net fr_article3024 html 4 of 5 2006 04 17 19 23 5 SPIP Le traitement des images Cette m thode consiste en trois programmes d j anciens qui permettent de r aliser le redimensionnement de l image L avantage de cette m thode est que ces programmes peuvent tre install s sans acc s root sur la plupart des h bergements On trouvera sur le site du logiciel gallery une explication claire et des versions pr compil es de NetPBM Dans SPIP on configure le chemin d acc s pnmscale l un seulement des trois programmes install s les deux autres chemins s en d duiront puisque les programmes sont install s dans le m me r pertoire par la variable suivante pnmscale command bin pnmscale encore une fois c est vous de d terminer le chemin d acc s r el de votre installation Pour rappel vous pouvez obtenir nombre d informations utiles sur votre syst me via la page ecrire info php3 notamment le syst me utilis utile pour installer NetPBM pr compil la version de PHP la pr sence ventuelle des extensions GD GD2 et Imagemagick Enfin en cas de difficult la meilleure solution consiste contacter votre h bergeur pour qu il installe les extensions n cessaires si aucune n est pr sente La pr sence d au moins une extension graphique de PHP est d sor
153. du d but de l article chapeau puis texte SPIP 1 3 Dans les versions pr c dentes de SPIP ce sont syst matiquement les premiers caract res de l article chapeau puis texte qui sont pris en compte le descriptif n est pas utilis HLESAUTEURS les auteurs de cet article Cela permet d viter de cr er une boucle AUTEURS pour obtenir le m me r sultat HPETITION le texte de la p tition si elle existe Si elle existe mais que le texte est vide retourne un espace une cha ne non vide sans incidence dans une page html HURL_ ARTICLE est l URL de la page de l article HFORMULAIRE FORUM fabrique l interface permettant de poster un message r pondant cet article Pour en savoir plus voir aussi Les formulaires FORMULAIRE _SIGNATURE fabrique l interface permettant de signer la p tition associ e cet article HPARAMETRES_ FORUM fabrique la liste des variables exploit es par l interface du formulaire permettant de r pondre cet article Par exemple lt A HREF forum php3 PARAMETRES_ FORUM gt R pondre cet article lt A gt Depuis SPIP 1 8 2 on peut lui passer un param tre sp cifiant l adresse de retour apr s avoir post le message Par exemple lt A HREF forum php3 PARAMETRES_FORUM SELF gt R pondre cet article lt A gt renverra le visiteur sur la page actuelle une fois que le message a t valid Les logos LOGO_ARTICLE lelogo de l article ven
154. e Pour cela outre l apparition sur les pages concern es d une bouton d aministration intitul Erreur Tidy SPIP tient jour en permanence un fichier ecrire data w3c go home txt qui contient la liste des pages impossibles valider 1 Une fois vos squelettes rendus propres paragraphe pr c dent le nombre de pages d faillantes devrait tre limit aux articles contenant du code HTML non accept par Tidy Il est assez difficile de d finir pr cis ment ce que Tidy consid re comme une erreur insurmontable Par exemple les balises mal ferm es ne sont pas r ellement consid r es comme impossible http www spip net fr_article3070 html 5 of 7 2006 04 17 19 22 38 SPIP Tidy validation XHTML 1 0 corriger par exemple passer en italique dans un paragraphe et fermer l italique dans un autre paragraphe fabrique du code HTML non conforme que Tidy parvient cependant bien corriger Le plus souvent il s agit de balises ins r es la main totalement inexistantes par exemple taper lt bt gt la place de lt br gt ou de balises HTML consid r es comme obsol tes dans le HTML 4 telles que lt tt gt ou lt blink gt que Tidy refusera purement et simplement de traiter Conclusion Encore une fois l outil Tidy ne doit surtout pas tre consid r comme un produit miracle il ne transforme pas du code sale en code conforme Son int gration dans SPIP suit donc une logique d accompagne
155. e dans inc urls propres php3 pour obtenir des variations tr s int ressantes si vous faites cela merci de partager vos modifications sur le site SPIP Contrib Programmer la traduction des adresses apparentes en adresses r elles Pour que l adresse article123 htm1 appelle bien en r alit le fichier PHP http www spip net fr_article765 html 2 of 4 2006 04 17 19 21 50 SPIP Utiliser des URLs personnalis es article php3 avec comme param tre id_article 123 il va falloir configurer le serveur Web qui h berge votre site soit dans un fichier htaccess a ne marche pas toujours soit dans le fichier de configuration centrale du serveur si vous y avez acc s Cela utilise sous le serveur Apache le plus utilis ce qu on appelle des Rewrite Rules des r gles de r criture d adresses Web Savoir crire ces r gles n est pas simple pour les non programmeurs et nous ne pouvons pas vous donner de solutions infaillibles car cela d pend de votre configuration cette partie est enti rement entre vos mains ou celles de votre h bergeur N anmoins SPIP 1 8 1 fournit un fichier htaccess txt titre d exemple qui fonctionne sur la plupart des h bergeurs avec les types d URLS cit s pr c demment standard html propres et propres Pour l activer il faut le recopier la racine du site sous le nom htaccess Il est fortement conseill de l ouvrir au pr alable pour v rifier quelques as
156. e de vouloir utiliser des logos diff rents notamment de tailles diff rentes pour un m me article en fonction de l endroit o il appara t Par exemple utiliser un gros logo sur la page d accueil du site qui permette de bien mettre en valeur l article principal du moment et un petit logo pour la navigation g n rale du site Jusqu r cemment les utilisateurs avaient cr des m thodes personnelles bas es sur l utilisation diff renci e du logo normal et du logo pour survol Dans notre exemple le logo normal utilis comme petit logo appel par la balise 10G0_ARTICLE_NORMAL et sur le sommaire le logo pour survol appel par la balise LOGO_ARTICLE_ SURVOL pour afficher la grande version du logo Cette m thode complique souvent le code des squelettes et interdit l utilisation habituelle des logos avec survol que SPIP fournit automatiquement Elle est de plus d une souplesse tr s limit e Depuis la version SPIP 1 4 il est possible de joindre des documents aux articles et accessoirement aux rubriques Nous allons expliquer ci dessous comment utiliser ces documents joints pour cr er plusieurs logos pour un m me article Principe g n ral Nous continuerons utiliser les deux logos de l article pour afficher les logos http www spip net fr_article2001 html 1 of 10 2006 04 17 19 32 21 SPIP Plusieurs logos pour un article r sultats d une recherch
157. e article html on modifiera le style du lien de la mani re suivante lt BOUCLE_ principale ARTICLES id_article gt lt BOUCLE _menu ARTICLES id_rubrique gt lt li class lien EXPOSE gt lt a href URL_ ARTICLE TITRE lt a gt lt li gt lt BOUCLE_menu gt avec les styles suivants http www spip net fr_article2319 html 1 of 3 2006 04 17 19 16 17 SPIP Exposer un article dans une liste m La boucle DOCUMENTS m La boucle SYNDIC_ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives E La popularit des articles m La gestion des dates m Exposer un article dans une liste a lien color red a lienon color blue font weight bold l L objet qui est ainsi expos par un affichage diff rent est l article la br ve la rubrique le mot cl ou l auteur qui appartient au contexte courant Dans le cas des rubriques la travers e de la hi rarchie est g r e ce qui permet d exposer l arborescence des rubriques qui contient l article affich Par d faut SPIP remplace la balise EXPOSE par on si l objet correspond au contexte sinon la balise est simplement ignor e Toutefois la balise EXPOSE accepte un ou deux arguments qui permettent de pr ciser ce q
158. e choisir soi m me le nom du fichier de squelette que l on aurait pu d duire automatiquement du nom du fichier php3 est si n cessaire d utiliser un autre nom Cela pour ne pas craser ventuellement des fichiers HTML qui subsisteraient d une ancienne version du site que l on ne souhaite pas supprimer S il existe d une ancienne version du site un fichier article html que l on ne souhaite pas effacer on utilisera par exemple un fichier squelette pour SPIP intitul article nouveau html et on fixera dans article php3 Sfond article nouveau http www spip net fr_article877 html 4 of 8 2006 04 17 19 09 48 SPIP Principe g n ral La variable delais est l ge maximum pour l utilisation du fichier stock en CACHE Ce d lai est fix en secondes Un d lai de 3600 correspond donc une heure un d lai de 24 3600 est donc de 24 heures On jouera sur cette valeur en fonction de la fr quence des ajouts de contenu du site nouveaux articles nouvelles br ves Un site actualis plusieurs fois par jour pourra adopter un d lai d une heure un site publiant quelques articles par semaine pourra adopter un d lai nettement plus long De m me le contenu des pages est important si vous ins rez la syndication du contenu de sites fr quemment mis jour vous souha iterez sans doute adapter votre propre d lais celui des sites r f renc s Remarque Certains webmestre succombent la tentation de fix
159. e de base sous SPTP celui que vous entrez dans un formulaire en tapant au kilom tre g n re des tags HTML particuliers En effet il est d coup en paragraphes chaque paragraphe correspond un tag lt p class spip gt Nous pouvons donc associer ces paragraphes un style bien pr cis qui ne sera pas appliqu au reste du texte de la page Commen ons par choisir une police de caract res Pour cela on utilise la propri t font family qui prend pour valeur un ou plusieurs noms de polices de caract res utiliser Pour un corps de texte comme celui d un article il vaut mieux http www spip net fr_article2332 html 1 of 6 2006 04 17 19 29 18 SPIP Une typographie personnalis e une fonte empattements mettons que vous vous d cidiez pour Bookman Old Style Ajoutez donc votre fichiermes_styles css la r gle suivante p spip font family Bookman Old Style notez qu un nom de fonte en plusieurs mots doit tre entour de guillemets Un probl me peut survenir si la police Bookman Old Style n est pas install e sur l ordinateur de vos visiteurs chaque ordinateur a une configuration diff rente et n oubliez pas que les fontes gratuites de Microsoft sont rarement install es sur Linux et Macintosh Il est pr f rable de pr voir ce cas et sp cifier une ou plusieurs polices de remplacement successives p spip font family Bookman Old Style Times New Roman serif O
160. e interface diff rente dans le m me site Tout d abord notez qu il est possible de cr er des couples de fichiers pour le m me l ment logique articles rubriques Par exemple vous pouvez cr er des fichiers pour visiter un m me article avec des interfaces diff rentes article php3 html pour le format normal imprimer php3 htm1 pour le m me article dans un format adapt l impression article texte php3 htm1 pour l article dans un format texte adapt aux mal voyants par exemple article lourd php html avec une interface lourdingue adapt e au haut d bit etc Une interface diff rente selon les rubriques Vous pouvez pour un m me type de document cr er des squelettes diff rents selon les rubriques du site Il s agit de cr er simplement de nouveaux fichiers htm1 en fonction des rubriques inutile ici de modifier le fichier php3 on se contente de jouer sur les noms des fichiers squelettes Il suffit de compl ter le nom du fichier squelette de num ro un tiret suivi d un num ro de rubrique Par exemple si vous cr ez un fichier article 60 html tous articles contenus dans la rubrique n 60 utiliseront ce squelette et non http www spip net fr_article877 html 6 of 8 2006 04 17 19 09 48 SPIP Principe g n ral plus le squelette par d faut article html Notez bien le num ro indiqu est celui d une rubrique Si cette rubrique 60 contient des sous rubriques les articles contenus
161. e jour JJ est facultatif Par exemple lt B_semaine gt lt ul gt lt BOUCLE_semaine ARTICLES agenda date semaine par date gt lt li gt TITRE lt li gt lt BOUCLE_semaine gt hals affiche une liste des articles publi s dans la semaine actuelle lt BOUCLE_art_principale ARTICLES id_article gt lt B_mememois gt lt ul gt lt BOUCLE_mememois ARTICLES agenda date mois DATE annee DATE mois par date gt lt li gt TITRE lt li gt IBOIICI C mamamaics affiche une liste des articles publi s le m me mois que l article actuel Dans le cas o l argument type le deuxi me argument vaut periode trois autres arguments peuvent tre sp cifi s la fin du crit re Alors YYYY MM JJ correspondront la date de d but de la p riode YYYY2 MM2 JJ 2 correspondront la date de fin de la p riode Si le deuxi me trio sp cifiant la date de fin est omis la date courante sera prise comme date de fin et si le premier trio est galement absent la p riode de s lection couvrira toute la vie du site pour les sites avec beaucoup d articles le http www spip net fr_article3182 html 2 of 5 2006 04 17 19 24 40 SPIP Le calendrier de SPIP 1 8 2 temps d ex cution risque d tre excessif si d autres crit res n en limitent pas le nombre Par exemple lt BOUCLE_art_principale ARTICLES id_article gt lt B_apres gt lt ul gt lt BOUCLE_
162. e on r cup re chaque article de ces sites soit directement l int rieur d une rubrique on r cup re directement tous les articles syndiqu s dans une rubrique en court circuitant le passage par la liste des sites lt BOUCLEn SYNDIC_ARTICLES crit res SPIP 1 3 partir de la version 1 3 de SPIP la boucle SITES ou SYNDICATION n affiche plus uniquement des sites syndiqu s mais plus g n ralement des sites r f renc s la syndication de certains sites r f renc s tant une option On pourra donc pour obtenir une pr sentation graphique plus pr cise utiliser une boucle SYNDIC_ARTICLES uniquement l int rieur d une boucle SITES utilisant le crit re syndication oui Les crit res de s lection http www spip net fr_article911 html 1 of 3 2006 04 17 19 12 19 SPIP La boucle SYNDIC_ARTICLES SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives m La popularit des articles m La gestion des dates m Exposer un article dans une liste On utilisera l un ou autre des crit res suivants pour indiquer comment on s lectionne les l ments tout tous les sites syndiqu s id syndic _ article retourne l article syndiqu dont l identifiant est id_syndic_article Dansla pratique il y tr s peu d int r t fabriquer
163. e par secteurs m Afficher le nombre de messages du forum li un article m Un menu d roulant pour pr senter une liste d articles m Remplir les meta tags HTML des pages d article normaux ceux qui apparaissent dans les liens de navigation les plus fr quents par exemple sur les pages des rubriques ce qui permet de conserver la simplicit de gestion des logos avec SPIP et la gestion automatique du survol on revient l utilisation vidente de la balise LOGO_ARTICLE ou de LOGO_ARTICLE_RUBRIQUE Nous d ciderons de joindre aux articles un document g n ralement une image aux formats GIF J PEG ou PNG auquel nous donnerons syst matiquement le m me nom Il nous suffira d afficher ce document en l appelant par son nom la place du logo normal lorsque nous le d sirerons Cette m thode permet ainsi de cr er autant de logos diff rents que n cessaire pour un m me article pas seulement un grand logo et un petit logo mais pourquoi pas une image pixelis e avec un travail typographique labor pour afficher le titre etc Nous verrons de plus que gr ce aux boucles de SPIP on pourra tr s facilement dans les squelettes d terminer si un tel grand logo document portant le nom choisi par nous est pr sent et agir en cons quence afficher la place le logo normal du texte sp cifique ou carr ment un autre l ment graphique Miracle de la technologie moderne des
164. e qui dans les squelettes est susceptible d tre transform par SPIP en donn es affichables Notez en particulier que les squelettes fournis par d faut d montrent au maximum les possibilit s de SPIP et par cons quent g n rent des pages assez lourdes N oubliez pas non plus de r gler les d lais d expiration des diff rents types de pages Ainsi si votre site contient un grand nombre d articles en archives vous avez peut tre int r t augmenter la dur e d expiration des articles sinon les articles consult s peu souvent ne b n ficieraient pas du syst me de cache L influence du cache La pr sence du cache change quelque peu la donne en mati re de rapidit Ce n est pas tant le nombre de visites de votre site qui sera le point critique que la capacit de votre serveur recalculer les pages dans le temps imparti au script PHP en effet sur la plupart des serveurs une limite de dur e d ex cution par appel de script est fix e afin d viter les abus et les erreurs de programmation Par contre si la page demand e est dans le cache et n a pas expir la r ponse du serveur devrait tre quasi instantan e dans le cas contraire votre serveur est vraiment tr s charg La qualit des performances devient ainsi objectivement mesurable si lors du recalcul d une page du site on obtient un timeout c est dire que le serveur a d pass le temps maximal d ex cution d un script PHP Alors il faut
165. e score en question valuation de la fr quentation quotidienne de l article l autre la popularit relative un pourcentage relatif l article du site ayant la plus forte popularit popularit max enfin la somme de toutes ces valeurs absolues sur le site donne la popularit site qui permet de comparer la fr quentation de deux sites sous spip Boucles et balises Des balises permettent de r cup rer et d afficher ces valeurs dans vos squelettes La boucle ci dessous r sume l ensemble de ces balises lt BOUCLE_pop ARTICLES id_article popularite gt 0 gt lt h5 gt Popularit lt h5 gt Cet article a une popularit absolue gale POPULARITE_ABSOLUE soit HPOPUI ARITF de POPUI ARITF MAX La balise la plus utile est POPULARITE puisqu elle donne un pourcentage repr sentant la popularit de l article relativement l article le plus populaire du site Cela permet ainsi de r aliser facilement des classements compr hensibles par tous avec des valeurs allant de 0 100 Les autres balises donnent des valeurs absolues plus difficiles interpr ter par les visiteurs du site Note bien que les donn es soient repr sent es dans la base de spip sous forme de nombres r els le rendu de toutes ces balises est toujours donn sous la forme d un nombre entier ce qui donnera sur des sites tr s peu fr quent s sites de tests notamment des choses amusantes du genre http
166. e904 html 5 of 5 2006 04 17 19 10 52 SPIP La boucle BREVES E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle gi NOT TERT m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La boucle BREVES m fran ais m catal mDeutsch m English m italiano m Espa ol La boucle BREVES comme son nom l indique retourne une liste de br ves lt BOUCLEn BREVES crit res gt Les crit res de s lection On utilisera l un ou autre des crit res suivants pour indiquer comment on s lectionne les l ments tout les br ves sont s lectionn es dans l int gralit du site id_ breve retourne la br ve dont l identifiant est id_breve Comme l identifiant de chaque br ve est unique ce crit re retourne une ou z ro r ponse id_ rubrique retourne toutes les br ves contenues dans la rubrique en COUTS http www spip net fr_article906 html 1 of 4 2006 04 17 19 11 2 SPIP La boucle BREVES DOCUMENTS m La boucle SYNDIC_ ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m
167. eilleure le cas ch ant N h sitez pas le faire mais il doit y avoir de v ritables raisons cela Enfin tout r gle souffre des exceptions Mais celles ci doivent avoir une v ritable justification non uniquement la paresse du programmeur elles doivent tre le plus rares possible Notamment garder l esprit que le provisoire a souvent tendance devenir d finitif quand personne n a envie de le corriger or il est logique et juste que tout programmeur soit responsable de la finition de son propre code mais non de celui des autres R gles de pr sentation et d criture Les r gles qui suivent sont communes un nombre plus ou moins grand de langages de programmation au minimum tous les langages pr sentant une syntaxe similaire PHP c est dire outre PHP lui m me C C J ava Ces r gles sont commun ment accept es de fa on aussi naturelle que les r gles de pr sentation et de typographie d un texte en langage naturel d ailleurs elles sont fr quemment similaires Pr sentation Le code doit tre espac et indent de mani re mettre en valeur sa structure et la s paration entre les diff rents blocs logiques fonctions notamment L espacement et l indentation doivent tre suffisants pour rendre la structure compr hensible d s le premier regard ils ne doivent pas tre excessifs On doit y apporter le m me soin qu la division en paragraphes d un texte en langage n
168. emi re ligne des paragraphes en utilisant la propri t text indent Par d faut cette propri t prend pour valeur z ro c est dire qu il n y a pas d indentation On peut la modifier pour obtenir sur chaque premi re ligne un d calage de soixante pixels droite p spip text indent 60px Les liens hypertexte Ceux qui ont d j r alis leurs premi res armes en CSS savent qu on peut modifier l habillage des liens de fa on globale a color green text decoration none Cette r gle de style sp cifie que tous les liens hypertexte c est dire tous les tags lt a gt quils aient ou non un attribut class seront affich s en vert sans soulignement SPIP permet d aller plus loin Les liens hypertexte lorsqu ils sont g n r s par les raccourcis typographiques utilisent en effet plusieurs styles diff rents lorsque le lien est interne il renvoie vers une autre page de votre site le tag est lt a class spip_in gt lorsque le lien est externe il renvoie vers un autre site Web le tag est lt a class spip_out gt 1 enfin lorsque l URL est entr e sans titre letagest lt a class spip_url gt Il devient donc tr s simple de manifester par une apparence graphique diff rente ces trois types de liens Ainsi a color green text decoration none http www spip net fr_article2332 html 3 of 6 2006 04 17 19 29 18 SPIP Une typographie personnalis e a spip_
169. en page pour un site g r sous SPIP http www spip net fr_rubrique143 html 1 of 2 2006 04 17 19 09 23 SPIP Mise en page manuel de r f rence fran ais O tout le site Modifications r centes Le calendrier de SPIP 1 8 2 m Internationaliser les squelettes m Principe g n ral m lt INCLURE gt d autres squelettes Les balises propres au site m La boucle ARTICLES m SPIP 1 8 3 Les filtres de SPIP a Traitement automatis des images m Images typographiques Principe g n ral a Des boucles et des balises La syntaxe des boucles a La syntaxe des balises SPIP a La boucle ARTICLES a La boucle RUBRI QUES a La boucle BREVES a La boucle AUTEURS a La boucle FORUMS a La boucle MOTS a La boucle SITES ou SYNDI CATI ON a La boucle DOCUMENTS La boucle SYNDIC_ ARTICLES a La boucle SIGNATURES a La boucle HIERARCHIE Les crit res communs toutes les boucles Les balises propres au site Les formulaires a Les boucles de recherche Les filtres de SPIP Les boucles r cursives a La popularit des articles La gestion des dates a Exposer un article dans une liste http www spip net fr_rubrique143 html 2 of 2 2006 04 17 19 09 23 SPIP Principe g n ral m Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FO
170. en savoir plus Les infos de connexion au serveur LDAP sont crites dans inc_connect php3 Corollaire il faut supprimer ce fichier et relancer l installation pour activer LDAP sur un site SPIP existant Dans la table spip _ auteurs est ajout un champ source qui indique d o viennent les infos sur l auteur Par d faut c est spip mais a peut aussi prendre la valeur ldap Ca permet de savoir notamment quels champs ne doivent pas tre chang s en particulier on ne doit pas autoriser la modification du login car sinon il y a une perte de synchronisation entre SPIP et LDAP A l authentification les deux m thodes sont test es la suite SPIP puis LDAP En fait un auteur LDAP ne pourra pas tre authentifi par la m thode SPIP m thode standard avec challenge md5 car le pass est laiss vide dans la table spip auteurs Un auteur SPIP quant lui sera authentifi directement depuis la table spip _ auteurs D autre part si le login entr ne vient pas de SPIP le mot de passe est transmis en clair Quand un auteur LDAP se connecte pour la premi re fois son entr e est ajout e dans la table spip auteurs Les champs remplis sont nom login et email qui viennent de LDAP champs cn uid et mail respectivement et le statut dont la valeur par d faut a t d finie l installation r dacteur admin ou visiteur Important on peut modifier le statut par la suite afin de choisir ses admins la
171. ent qui reste lui fig d une langue l autre Cette t che n cessite de mettre un peu les mains dans le cambouis et fait l objet d un article s par D tails annexes Les raccourcis typographiques lt code gt et lt cadre gt produisent toujours un texte crit de gauche droite m me si la langue de l article s crit normalement de droite gauche En effet ces deux raccourcis sont destin s afficher du code ou des donn es informatiques qui sont peu pr s toujours crits de gauche droite et la plupart du temps en caract res occidentaux Toujours en ce qui concerne le sens d criture notons que les attributs left et right du HTML sont aussi souvent pr sents dans les feuilles de style Cela veut dire que vous devrez peut tre inclure la partie correspondante de la feuille de style dans vos squelettes pour utiliser les balises LANG_LEFT et LANG_RIGHT plut t que de la placer dans un fichier s par Voici un r capitulatif du comportement des balises SPTP li es au sens de l criture Langue LANG_ LEFT LANG RIGHT LANG DIR langues crites de gauche ee left right ltr arabe farsi h breu right left rtl 1 On pr cise ici que dans la configuration livr e d origine SPIP reste monolingue afin de ne pas compliquer du tout l interface 2 Si l on veut au contraire un affichage vide il faut cr er explicitement une premi re partie vide avec un nom de langue quelcon
172. ent de la base de donn e en utilisant une police de caract res de votre choix La fonction qui r alise cet effet est image_typo La pr sente page va vous pr senter les diff rentes variables que l on peut utiliser avec cette fonction TITRE image _typo HTML XHTML standards Si vous ne pr cisez aucune variable image_typo va utiliser la police par d faut fournie avec SPTP Dustismo une police GPL de Dustin Norlander police Vous pouvez pr ciser le nom d une autre police que vous aurez pris soin d installer sur votre site http www spip net fr_article3325 html 1 of 6 2006 04 17 19 25 4 SPIP Images typographiques graphique m Le calendrier de SPIP 1 8 2 E Images typographiques m Couleurs automatiques m Traitement automatis des images m La structure de la base de donn es TITRE image typo police dustismo_ bold HTML xHTML standards Dustismo bold est galement livr avec SPIP En th orie vous pouvez utiliser de nombreux formats de police TrueType PostScript Type 1 OpenType Selon la configuration de votre site il est possible que certains formats ne soient pas accept s Les polices doivent tre install es dans un sous dossier polices du dossier ecrire ou du dossier contenant vos squelettes Si nous installons par exemple un fichier TrueType ainsi ecrire polices stencil ttf il est possible d utiliser cette nouvelle police 2 TITRE image typo p
173. ent sous Apache le serveur Web libre http www spip net fr_article2628 html 1 of 3 2006 04 17 2 23 9 SPIP S curit SPIP et IIS faisant tourner la majorit des sites Web de l Internet mais pas sous IIS Internet Information Services le serveur Web de Microsoft Prot ger ses donn es sous lIS une tape de plus Si votre site SPIP est install sur un IIS n importe qui peut donc voir les dossiers cens ment s curis s via htaccess il faut donc les prot ger Pour prot ger un dossier sur votre site allez dans le panneau d administration de votre serveur Web faites un clic droit sur le dossier concern cliquez sur propri t s et dans l onglet R pertoire d cochez la case Lire Le panneau de propri t s du dossier ecrire data D cocher la case Lire suffit prot ger le dossier exactement comme le fait Apache avec les fichiers htaccess http www spip net fr_article2628 html 2 of 3 2006 04 17 2 23 9 SPIP S curit SPIP et IIS Faites cette op ration pour chacun des deux dossiers CACHE etecrire data Si la manipulation est bonne vous ne devriez plus pouvoir acc der aux fichiers de ces dossiers travers le serveur web Testez votre configuration en essayant d afficher http www votresite com ecrire data spip log avec votre navigateur Vous devriez obtenir un message du type Acc s refus 1 Les mots de passe sont chiffr s par SPIP mais gardez bien l esprit
174. er des d lais d risoires quelques secondes pour que le site corresponde tr s exactement chaque instant aux derni res modifications de la base de donn es Dans ce cas vous perdez tous les avantages du syst me de cache les visites sont nettement ralenties et l extr me sur des sites tr s fr quent s vous pouvez provoquer des plantages de la base de donn es ou vous faire virer par votre h bergeur parce que vous monopolisez la puissance de sa machine Remarque Une autre raison qui semble pousser les webmestres fixer des d lais tr s courts est la pr sence des forums sur leur site En effet pour que les contributions s affichent d s qu elles sont post es ils pensent n cessaire de r duire le d lais de recalcul C est inutile SPIP g re cet aspect automatiquement lorsqu une contribution un forum est post e la page correspondante est effac e du cache et recalcul e imm diatement quel que soit le d lai fix pour cette page Depuis SPIP 1 8 2 on peut utiliser un m me fichier php3 pour tous les squelettes Il s agit du fichier page php3 qui est la racine du site Il est un peu plus complexe que celui d crit ci dessus mais il joue le m me r le Lorsqu on l utilise les variables fond et fond peuvent tre pass es en param tres par exemple http monsite org page php3 Le fichier HTML Dans SPIP nous appelons les fichiers html les squelettes Ce sont eux qui d crivent
175. er article lt li gt lt ul gt s il n y a aucun article Cette rubrique ne contient pas d article Historique J usqu SP P 1 7 2 La mani re dont SPIP interpr tait les boucles interdisait de mettre une boucle entre lt Bn gt et lt BOUCLEn gt Par contre il restait possible de mettre des boucles suppl mentaires dans les parties optionnelles situ es apr s la d finition lt BOUCLEn gt Si vous deviez vraiment installer une boucle dans la partie optionnelle avant il fallait passer par une commande lt INCLURE gt Des crit res d environnement en cascade http www spip net fr_article898 html 4 of 7 2006 04 17 19 10 12 SPIP La syntaxe des boucles Chaque boucle effectue la s lection des l ments tir s de la base de donn es en fonction de crit res Ces crit res correspondent l environnement dans lequel se trouve la boucle Par exemple si on pr voit une boucle du genre Afficher les articles inclus dans cette rubrique il faut savoir de quelle rubrique il s agit C est ce que l on nomme l environnement t L environnement fourni par l URL Lorsque l on visite une page d un site SPIP son adresse contient g n ralement une variable Par exemple rubrique php3 id rubrique 15 Cette variable d finit donc un premier environnement la boucle Afficher les articles inclus dans cette rubrique doit alors tre compris comme Afficher les articles de la rubrique
176. es traduction d un mot cl ou traduction d un auteur car c est bien le m me auteur qui signe les deux articles ou le m me mot cl m me concept qu on leur attache Ces objets n ont donc pas de langue au sens de SPIP mais il est tout de m me possible l aide des blocs multi de les faire s afficher dans la langue du contexte dans lequel ils sont invoqu s pour le dire plus simplement faire que le mot cl Irak s affiche Iraq quand il est affect un article en anglais Le bloc multi est un nouveau raccourci de SPIP dont la structure est relativement intuitive lt multi cha ne 1 xx cha ne 2 yy cha ne 3 Pour reprendre l exemple du mot cl son titre serait entr sous la forme lt multi fr lrak en lraqg lt multi gt Si un bloc multi est appel s afficher dans une langue qui n est pas pr vue c est toujours la premi re partie du bloc qui s affiche cha ne 1 dans le premier exemple Irak dans le second Cela afin de ne jamais avoir d affichage vide 2 NB les blocs multi peuvent aussi tre utilis s selon la m me structure dans les squelettes cf Internationaliser les squelettes Boucles et balises comment faire Une fois l espace priv r gl aux petits oignons passons maintenant au site public H oui m me si chaque article dispose maintenant de sa propre langue judicieusement choisie selon le m canisme expli
177. es m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle gi NOT TERT m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence Les boucles de recherche m catal mDeutsch wm English m Espa ol w italiano E fran ais SPIP dispose d un moteur de recherche int gr Il faut donc pr voir une page permettant d afficher les r sultats des recherches L interface de recherche Pour afficher le formulaire de l interface de recherche il suffit d ins rer la balise FORMULAIRE RECHERCHE Par d faut le formulaire enverra les requ tes vers une page recherche php3 vous devez donc r aliser un squelette recherche htm1l permettant d afficher les r sultats Vous pouvez d cider d utiliser une autre page d affichage des r sultats Pour cela il faut utiliser la balise de la mani re suivante FORMULAIRE RECHERCHE adresse php3 http www spip net fr_article903 html 1 of 2 2006 04 17 19 13 56 SPIP Les boucles de recherche DOCUMENTS m La boucle o adresse php3 est la page vers laquelle vous d sirez envoyer l utilisateur SYNDIC_ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les b
178. es m Utiliser des URLS personnalis es m Le moteur de recherche m Les variables de personnalisation Initiation utiliser les feuilles de style avec http www spip net fr_rubrique135 html 4 of 6 2006 04 17 2 22 56 SPIP Guide du webmestre et du bidouilleur SPIP Pour tirer parti de toute la souplesse de SPIP il est recommand d utiliser les feuilles de style Pas de panique cette petite initiation permettra aux d butants de raccrocher les wagons m Introduction m Des styles qui ont de la class m Une typographie personnalis e m lls sont beaux mes formulaires m Pour en savoir plus Trucs et astuces m Afficher automatiquement selon la date ou selon un ordre impos a Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier m Plusieurs logos pour un article a Afficher les derniers articles de vos r dacteurs par rubrique m Afficher des l ments par lignes dans un tableau m Ne pas afficher les articles publi s depuis plus d un an m Pr senter les r sultats d une recherche par secteurs se http www spip net fr_rubrique135 html 5 of 6 2006 04 17 2 22 56 SPIP Guide du webmestre et du bidouilleur Le d veloppement de SPIP et ses outils Les diff rents outils de communication utilis s pour d velopper SPIP Tutorial utilisation avanc e des boucles et des mots cl s http www spip net fr_rubrique135 html 6 of 6 2006 04 17 2
179. es mots du groupe id groupe ou du groupe dont le titre est type mot SP P 1 7 1 tout affiche les rubriques vides en plus des rubriques contenant des l ments publi s On r servera ce choix des besoins tr s sp cifiques en effet par d faut SPIP n affiche pas sur le site public les rubriques qui ne contiennent aucun l ment actif afin de garantir que le site ne propose pas de culs de sac navigation vers des pages ne proposant aucun contenu SPP 1 7 1 Lang s lectionne les rubriques de la langue demand e dans l adresse de la page http www spip net fr_article904 html 2 of 5 2006 04 17 19 10 52 SPIP La boucle RUBRIQUES Les crit res d affichage Une fois fix l un des crit res ci dessus on pourra ajouter les crit res suivants pour restreindre le nombre d l ments affich s Les crit res communs toutes les boucles s appliquent videmment exclus permet d exclure du r sultat la rubrique dans lequel on se trouve d j utile avecmeme_parent Les balises de cette boucle Les balises tir es de la base de donn es Les balises suivantes correspondent aux l ments directement tir s de la base de donn es Vous pouvez les utiliser galement en tant que crit re de classement g n ralement par titre ID_ RUBRIQUE affiche l identifiant unique de la rubrique TITRE retourne le titre de la rubrique HDESCRIPTIF retourne le descriptif TEXTE retourne le
180. es parasites extension permet de s lectionner les documents selon leur terminaison terminaison du fichier multim dia par exemple mov ra avi Cela peut tre utilis par exemple pour r aliser un portfolio c est dire une boucle n affichant que les documents de type image une seconde boucle ensuite avec une pr sentation graphique diff rente les autres types de documents http www spip net fr_article1823 html 2 of 4 2006 04 17 19 12 3 SPIP La boucle DOCUMENTS lt BOUCLE_ portfolio DOCUMENTS Cette BOUCLE portfolio r cup re les documents joints un article non d j affich s dans le texte de l article et donc les extensions des fichiers peuvent tre jpg png ou gif doublons prend ici une importance particuli re elle permet non seulement de ne pas r afficher des documents d j affich s par une autre boucle mais galement de ne pas r afficher les documents d j int gr s l int rieur d un article Si l on oublie ce crit re on affichera tous les documents associ s un article y compris ceux qui auraient d j t affich s l int rieur du texte 1 Les balises LOGO_ DOCUMENT affiche le logo vignette de pr visualisation associ cet article si une vignette personnalis e n a pas t install e manuellement par l auteur de l article SPIP utilise une vignette standard selon le type du fichier URL_DOC
181. es rubriques par un syst me de menus d roulants un rappel des articles en cours de r daction et propos s la publication ainsi qu un des boutons cr er un article une br ve l interface de recherche les raccourcis li s au calendrier interne et la messagerie B D f i j TA E sell suivre dition Forum Auteurs Statistiques Confiqurati diff rents endroits de l interface notamment sur la page suivre on pourra rep rer des petits boutons Plus Destin s aux utilisateurs confirm s l absence de descriptif explicite de ces boutons faisant qu on en d couvre l usage au fur et mesure ils envoient des pages sp cifiques Par exemple c t d une liste d articles ce bouton m ne la page Tous vos articles c t d une liste http www spip net fr_article3037 html 2 of 9 2006 04 17 19 24 22 SPIP SPIP 1 8 l interface graphique de br ves le bouton m ne la page de gestion des br ves etc P en cours de r daction 146 en attente de validation 23 publi s en ligne 958 Messages publics 8036 Auteurs Administrateurs 44 R dacteurs 1113 Visiteurs 1 Changements de statut dans les listes Une interface de changement de statut l int rieur m me des listes d articles notamment permet aux administrateurs de modifier le statut d une s rie d l ments sans changer de page Cette man
182. es sont tr s utiles citons majuscules la fonctionnalit vidente justifier Ou aligner _ droite qui d finissent l alignement du texte par rapport aux bords verticaux ou encore l sot rique saison qui affiche t si la variable est une date comprise entre le 21 juin et le 20 septembre Pour utiliser un filtre il faut entourer la variable de parenth ses et de crochets on http www spip net fr_article889 html 1 of 3 2006 04 17 19 18 55 SPIP Des filtres verra plus tard les implications olah blah VARIABLE filtre bloh bloh On peut encha ner les filtres les uns la suite des autres 1 ainsi DATE saison majuscules affichera t il HIVER Exercice portant sur l ensemble des le ons pr c dentes Afficher en majuscules les titres des 10 articles les plus r cents de la rubrique pass e en contexte et mettre en t te de page la saison courante c est dire la saison laquelle a t publi l article le plus r cent de toute la base Pourquoi ces crochets Supposons que votre base contient des articles dat s et d autres non dat s La variable DATE vaut 2001 07 01 10 53 01 date au format mySQL dans le premier cas et 0000 00 00 00 00 00 dans le second Pour afficher la date dans un joli cadre on va utiliser dans le squelette les lignes suivantes lt table border 1 lt tr gt lt td gt DATE affdate lt td gt lt tr lt table gt
183. es squelettes inclus icipied html1 peuvent tre d termin s par rapport une certaine langue pied es html par exemple de la m me mani re que tout autre squelette Encore une fois voir Internationaliser les squelettes pour plus de details 1 Rappelons que la variable delais d finit la p riodicit de mise jour du cache Voir la section Le fichier php3 dans Principe g n ral http www spip net fr_article1828 html 3 of 3 2006 04 17 19 21 14 SPIP R aliser un site multilingue m Spip et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue Internationaliser les squelettes E Utiliser des URLS personnalis es m Le moteur de recherche m Les variables de personnalisation m Tidy validation XHTML 1 0 m Le support LDAP m Le traitement des images m Ins rer des formules m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es R aliser un site multilingue m fran ais m catal mEnglish mEspa ol mitaliano La modification la plus importante qu apporte SP P 1 7 est sa gestion naturelle des sites multilingues La totalit de cet article de documentation concerne SP P 1 7 Pr alable qu est ce qu un site multilingue Il n est pas question dans cet article de r diger un tutoriel complet sur les sites multilingues d une part il y a
184. est pass e dans l URL Si on lui pr cise id_article 1 elle va chercher l article n 1 mais si on lui demande juste id_article elle va chercher l article dont le num ro est indiqu par le contexte ici l URL Cliquez maintenant sur http votresite net tutoriel php3 id_article 1 http votresite net tutoriel php3 id_article 2 et k http votresite net tutoriel php3 Voyez vous la diff rence Les deux premi res pages vous donnent les articles n 1 et 2 la troisi me n a pas d id_article dans son contexte et g n re une erreur Bravo Votre squelette est maintenant contextuel 1 Non Il devrait http www spip net fr_article880 html 2 of 2 2006 04 17 19 18 10 SPIP Une rubrique m Mon premier squelette m Un squelette plusieurs articles x Une rubrique m Boucles en boucles m G rer le cache m Des filtres m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m SPIP pas pas Une rubrique m catal OU m Deutsch mitaliano m polski E fran ais m English m Portugu s m Espa ol m T rk e m La le on pr c dente nous a appris afficher des l ments en fonction du contexte Nous allons ici voir comment ce contexte varie au fur et mesure des BOUCLES rencontr es Modifions notre squelette tutoriel htm1 dela mani re suivante lt BOUCLE_article ARTICLES gt TIT
185. est possible d indiquer un point pr f r pour le sondage en passant deux valeurs x et y comprises entre 0 et 20 conseil entre 1 et 19 pour viter les effets de marges Par exemple HLOGO RUBRIQUE couleur_ extraire retourne une couleur situ e en haut droite du centre de l image Pour bien comprendre le principe appliquons ce filtre sur un logo de couleur uniforme Le r sultat est ff9200 Notez bien les valeurs retourn es sont syst matiquement en codage RVB hexad cimal en omettant le qui pr c de habituellement ces codes On pensera donc ins rer ce di se quand on utilise ces valeurs http www spip net fr_article3326 html 2 of 6 2006 04 17 19 26 14 SPIP Couleurs automatiques On peut par exemple appliquer cette couleur au fond d un pav lt div style background color Appliquons ce filtre une photographie En bas gauche la couleur extraire sans param tres c est dire pr sente un peu au dessus du centre de l image marron clair de la pierre du b timent En bas droite on force une couleur situ e en haut droite de l image bleu clair du ciel HLOGO RUBRIQUE couleur_extraire HLOGO RUBRIQUE couleur extraire L utilisation de ce filtre est techniquement tr s simple En revanche cr ativit et inventivit seront n cessaires pour l exploiter Voici quelques utilisations couleur de texte couleur de fond d un pa
186. este invoquer le squelette en lui passant le contexte id_rubrique 1 http votresite net tutoriel php3 7id_ rubrique l La magie de SPIP tient dans la combinaison de ce type de fonctionnalit s Si vous tes arriv jusqu ici c est gagn flat http www spip net fr_article882 html 2 of 2 2006 04 17 19 18 23 SPIP Boucles en boucles m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m SPIP pas pas Boucles en boucles E fran ais mec catal mDeutsch wm English m Espa ol mitaliano polski m Portugu s wm T rk e m Mon Nous savons g n rer une liste de titres dans une rubrique Maintenant nous premier allons afficher sur la m me page les l ments de la rubrique elle m me son A iii titre son texte de pr sentation etc squelette plusieurs Essayez articles m Une Et voici une solution rubrique m Boucles en lt BOUCLE _rubrique RUBRIQUES boucles id rubrique gt mG rer le lt h1 gt TITRE lt h1 gt cache m Des lt BOUCLE _article ARTICLES id_rubrique filtres par date inverse 0 10 gt lt a href URL_ ARTICLE TITRE lt a gt lt br gt lt BOUCLE_article gt On appelle la page avec http votresite net tutoriel php3 id_rubrique 1 Ques est il pass ici http www spip net fr_article883 html 1 of 2 2006 04 17 19 18 34 SPIP Boucles en boucles Notre boucle ARTICLES est int gr e dans une b
187. etite puce graphique Cette puce est constitu e par le fichier puce gi f install la racine du site vous pouvez modifier ce fichier selon vos besoins Mais vous pouvez aussi d cider de fixer vous m me le choix de la puce au travers de la variable puce Par exemple pour indiquer un autre fichier graphique puce lt img src mapuce gif alt http www spip net fr_article1825 html 2 of 6 2006 04 17 19 22 25 SPIP Les variables de personnalisation ou par un l ment HTML non graphique puce lt li gt Les variables pour les forums publics Il existe des variables permettant de fixer le comportement des forums publics avec des mots cl s N B Ces variables ne sont utilis es que lorsque vous cr ez des forums publics dans lesquels les visiteurs peuvent s lectionner des mots cl s leur utilisation est donc extr mement sp cifique et pas vidente Safficher_ texte oui non gt Par d faut les forums publics sont con us pour permettre aux visiteurs d entrer le texte de leur message mais lorsque l on propose le choix de mots cl s dans ces forums on peut d cider qu aucun message n est utile seul la s lection des mots cl s importe Dans ce cas on pourra indiquer a fficher_texte non Safficher_ groupe permet d indiquer les diff rents groupes de mots cl s que l on souhaite proposer dans tel forum En effet tous les forums sur un site ne sont pas forc
188. etournera tous les articles de la rubrique actuelle et de ces sous rubriques si il y a un id rubrique dans le contexte sinon tous les articles du site doublons OU unique ces deux crit res sont rigoureusement identiques permettent d interdire l affichage des r sultats d j affich s dans d autres boucles utilisant ce crit re historique A partir de SPIP 1 2 et jusqu SP P 1 7 2 seules les boucles ARTICLES RUBRIQUES DOCUMENTS et SITES acceptaient ce crit re doublons xxxx partir de SPIP 1 8 on peut avoir plusieurs jeux de crit res doublons ind pendants Les boucles ayant doublons rouge n auront aucune incidence sur les boucles ayant doublons bleu comme crit re t xxxx IN a b c d partir de SPIP 1 8 limite l affichage aux r sultats ayant le crit re xxxx gal a b c ou d Les r sultats sont tri s dans l ordre indiqu sauf demande explicite d un autre crit re de tri Il est aussi possible de s lectionner des cha nes de caract res par exemple avec titre IN Chine Japon a b o a et b sont des chiffres Ce crit re permet de limiter le nombre de r sultats a indique le r sultat partir duquel on commence l affichage attention le premier r sultat est num rot 0 z ro b indique le nombre de r sultats affich s Par exemple 0 10 affiche les dix premiers r sultats 4 2 affiche les deux r sultats partir du cinqui me inclus debut_
189. eurs automatiques E Traitement automatis des images m La structure de la base de donn es O se trouve la d finition de ces feuilles de style Lors de l installation de SPIP avec les squelettes fournis en standard la d finition des feuilles de style se trouve dans le fichier spip style css Vous pouvez modifier ces styles c est m me conseill mais il est pr f rable de le faire dans votre propre fichier CSS afin de pas voir vos ajouts cras s lorsque vous installerez une nouvelle version de SPTP Vous pouvez aussi bien s r int grer directement des d finitions de styles dans vos squelettes Notez bien la notion de feuille de style ou cascading style sheets n est pas une norme propre SPIP il s agit d un standard du Web De tr s nombreuses documentations existent sur ce sujet par ailleurs consulter par exemple la page du W3C ce sujet Afin de suivre la suite de la pr sente explication il est vivement conseill d ouvrir le fichier spip_style css dans un diteur de texte Les liens hypertextes Les deux premi res d finitions permettent de modifier le comportement de a et a hover tr s classiques elles concernent tous les liens affich s sur votre page Web afficher les liens sans soulignement et r gler le survol des liens hypertextes Viennent ensuite trois d finitions propres aux raccourcis typographiques de SPIP a spip_in a spip_ out Ka spi
190. f 4 2006 04 17 19 23 30 SPIP Ins rer des formules math matiques en LaTEX m SPIP 1 8 l interface graphique m Le calendrier de SPIP 1 8 2 Em Images typographiques m Couleurs automatiques m Traitement automatis des images m La structure de la base de donn es Le principe technique de cette m thode consiste transformer chacune des formules en image image qui est ensuite affich e dans le texte C est actuellement la m thode la plus simple et efficace pour afficher des formules math matiques complexes sur une page Web Pour l heure l affichage de formules math matiques sur des pages Web gr ce au standard MathML n est absolument pas viable l impl mentation de MathML dans les navigateurs tant totalement erratique La solution retenue par SPIP l int gration d images repr sentant les formules est actuellement la seule qui garanti que tous les visiteurs d un site verront correctement les formules math matiques Il est important de comprendre que dans SPIP seules les formules sont transform es Il n est pas question en particulier d utiliser les macro fonctions de TEX pour r aliser la mise en forme du document Il s agit ici d un outil destin int grer des formules math matiques l int rieur d un document cod selon les habitudes de SPIP Syntaxe dans SPIP La syntaxe dans SPIP consiste placer la partie de texte concern e par le traitement entre les pseudo tags suivants
191. faut en anglais et en espagnol Nous r alisons trois fichiers de squelette diff rents article html pour le fran ais en r alit pour toutes les langues qui n ont pas de fichier de langue sp cifique ci apr s article en html pour l anglais article es html pour l espagnol Note si on publie un article en allemand alors qu il n existe pas de squelette article de htmli sur notre site c est le squelette article html qui sera utilis Important pour que les squelettes par langue d finis par l ajout d un lang la fin du nom soient pris en compte il faut obligatoirement qu il existe la version par d faut sur le site Ici si article html n existe pas on aurait pr f r nommer directement un article fr html les fichiers anglais et espagnol ne seront pas pris en compte On peut combiner cela avec le nommage par rubriques et l ordre suivant sera pris en compte http www spip net fr_article2128 html 7 of 9 2006 04 17 19 21 40 SPIP Internationaliser les squelettes 4 AET icle 8 es html le squelette pour les articles en espagnol de la rubrique 8 mais pas ses sous rubriques 4 article 8 html le squelette pour les articles de la rubrique 8 mais pas ses sous rubriques article 2 es html le squelette pour les articles en espagnol de la rubrique 2 et ses sous rubriques article 2 html le squelette pour les articles de la rubrique 2
192. figuration Le contenu de ces balises est d fini lors de la configuration de votre site HURL_ SITE _ SPIP est l adresse du site Elle ne comprend pas le final ainsi vous pouvez cr er un lien du type URL_SITE_SPIP sommaire php3 HNOM SITE_ SPIP est le nom du site EMAIL_ WEBMASTER SPIP 1 5 est l adresse du webmestre Par d faut SPIP prend l adresse de celui qui a install le site le premier administrateur Si vous pr f rez un formulaire crire au webmestre cf Les formulaires HLOGO_ SITE SPIP partir de SPIP 1 8 est le logo du site C est en fait le logo http www spip net fr_article1902 html 1 of 4 2006 04 17 19 13 23 SPIP Les balises propres au site DOCUMENTS m La boucle SYNDIC_ ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives E La popularit des articles m La gestion des dates m Exposer un article dans une liste de la racine c est dire la rubrique 0 HCHARSET SPIP 1 5 est le jeu de caract res utilis par le site Sa valeur par d faut est iso 8859 1 jeu de caract res dit iso latin Cf www uzine net article1785 html pour une introduction aux charsets en attendant une documentation plus compl te de cette fonctionnalit de SPIP LANG SP P 1 7 utili
193. format_png gt On constate que cette classe utilise une caract ristique de Microsoft Explorer l appel d un behavior Celui ci est un fichier Javascript pr sent dans l espace priv ecrire win_png htc que l on recopie la racine du site pour l exploiter en dehors de l espace priv En ouvrant ce fichier de comportement behavior on verra qu il fait appel un fichier img_pack rien gif dans son fonctionnement On doit donc recopier ce fichier la racine du site depuis ecrire img_pack rien gif et remplacer le chemin dans la version de win_png htc install e la racine du site Vous n aimez pas le vert http www spip net fr_article3037 html 8 of 9 2006 04 17 19 24 22 SPIP SPIP 1 8 l interface graphique Les go ts et les couleurs Les couleurs de l interface peuvent tre compl t es d autres couleurs ou remplac es Pour cela il suffit d installer des variables dans un fichier ecrire mes_options php3 global couleurs_spip couleurs_spip 1 array couleur _foncee gt 508A72 couleur claire gt A5DFC7 couleur lien gt 657701 couleur _lien_ off gt A6C113 couleurs_spip array couleur _foncee gt 949064 couleur _claire gt DFDBA5 couleur lien gt 657701 couleur _lien_ off gt A6C113 Ici on a remplac le vert variable 1 les couleurs de l installation normale sont num rot es de 1 6 on peut donc
194. formats propri taires et de l acc s par haut d bit de telles versions sp cifiques des logos tant des documents joints pourront tre d un autre format que des images On pourra ainsi afficher en tant que grands logos des animations Flash ou Shockwave des animations vid o Mise en place des documents et choix des noms Nous d cidons arbitrairement mais faites selon vos besoins que les documents joints utilis s en tant que gros logo seront tous intitul s spip logo ce document spip logo sera affich sur la page du sommaire de notre site la place du logo normal Nous utiliserons d autres noms dans la suite de cet exemple pour cr er des effets plus fins d cidons imm diatement qu ils auront tous des noms commen ant par Spip Cela nous permettra dans l affichage habituel des documents joints un article d exclure tous les documents dont le nom commence par spip De cette fa on l utilisation de documents en tant que logos alternatifs n interf rera pas avec l affichage par exemple d un portfolio Sur un article publi en ligne de fa on pouvoir bidouiller nos squelettes en les testant nous installons simplement http www spip net fr_article2001 html 2 of 10 2006 04 17 19 32 21 SPIP Plusieurs logos pour un article e un logo normalement colonne de gauche nous pouvons si nous le voulons installer une version de l image pour survol
195. forums Pour chaque fichier du cache ayant donn lieu une requ te sur la table spip forum la table spip forum cache stocke les param tres de la requ te article rubrique br ve et ventuel message parent du forum Lorsqu un message est post les param tres du message sont compar s avec ceux pr sents dans spip forum cache et pour chaque correspondance trouv e le fichier cache indiqu dans la table est effac Ainsi les messages n attendent pas le recalcul r gulier de la page dans laquelle ils s ins rent pour appara tre dans l espace public Indexation moteur de recherche Six tables sont utilis es par le moteur de recherche Elles se divisent en deux cat gories Le dictionnaire d indexation spip_ index _ dico Chaque mot rencontr au cours de l indexation est stock dans cette table ainsi que les 64 premiers bits de son hash MD5 C est le mot qui sert de cl primaire permettant ainsi d effectuer tr s rapidement des requ tes sur un d but de mot on r cup re alors le s hash satisfaisant la requ te afin d effectuer la recherche proprement dite dans les tables d indexation Les tables d indexation spip_ index_ Ces tables au nombre de cinq g rent chacune l indexation d un type d objet articles rubriques br ves auteurs mots cl s Une entr e par mot et par objet est stock e Chaque entr e contient le hash du mot en fait les 64 bits de poids fort du hash MD cf ci dessus l identifi
196. fr_article2124 html 5 of 8 2006 04 17 19 21 27 SPIP R aliser un site multilingue SPIP 1 7 2 introduit d autres l ments permettant de fabriquer des sites multilingues le crit re lang_select sert forcer la s lection de la langue pour la boucle AUTEURS qui normalement ne le fait pas l inverse le crit re lang_select non permet de dire aux boucles ARTICLES RUBRIQUES ou BREVES de ne pas s lectionner la langue la variable de personnalisation forcer_1ang indique SPIP qu il doit v rifier si le visiteur dispose d un cookie de langue et si oui le renvoyer vers la page correspondante C est ce que fait la page de connexion l espace priv livr e en standard avec SPIP les balises MENU_LANG et MENU_LANG_ECRIRE affichent un menu de langue qui permet au visiteur de choisir cette page en La premi re balise affiche la liste des langues du site la seconde la liste des langues de l espace priv elle est utilis e sur la page de connexion l espace priv enfin les crit res optionnels cf SPIP 1 7 1 7 2 permettent d utiliser une m me boucle en fait un m me squelette pour afficher soit tous les articles du site dans toutes les langues soit seulement les articles dans la langue pass e dans l URL a peut tre utile dans les backend par exemple ou dans les boucles de recherche lt BOUCLE_ recents ARTICLES lang par lt BOUCLE _reche
197. g r s dans SPIP au travers des boucles Les balises SPIP Gr ce aux boucles on a donc r cup r des l ments uniques ou des listes d l ments par exemple une liste d articles ou une liste de rubriques Cependant chaque l ment de telles listes est compos de plusieurs l ments pr cis par exemple un article se compose d un titre d un surtitre d un sous titre d un texte d introduction chapeau d un texte principal d un post scriptum etc Il existe ainsi des balises sp cifiques SPIP permettant d indiquer pr cis ment quel endroit on affiche des l ments placer le titre ici placer le texte ici http www spip net fr_article894 html 2 of 4 2006 04 17 19 10 0 SPIP Des boucles et des balises Les balises l int rieur des boucles Voici au travers d un cas classique le principe de fonctionnement g n ral d une boucle accompagn e de ses balises attention a n est pas du langage SPIP c est une description logique BOUCLE afficher la liste des articles de cette rubrique e afficher ici le titre de l article e afficher le sous titre Fin de la BOUCLE Cette boucle analys e par SPTP peut donner trois r sultats diff rents Il n y a aucun article dans cette rubrique Dans ce cas bien videmment aucun des l ments afficher ici titre sous titre n est utilis En revanche si on l a pr vu on peut afficher un message du genre
198. ge etc dans ses squelettes Lorsqu un administrateur parcours le site public si cette balise est pr sente elle sera remplac e par les boutons d administration sinon les boutons seront plac s la fin de la page http www spip net fr_article1902 html 2 of 4 2006 04 17 19 13 23 SPIP Les balises propres au site Depuis SPIP 1 8 on peut aussi modifier la feuille de style spip_admin css pour contr ler la position des boutons HDEBUT SURLIGNE FIN_SURLIGNE indique SPIP dans quelle partie de la page colorer les mots clefs recherch s Quand l utilisateur arrive sur une page depuis une page de recherche SPIP les mots clefs cherch s sont color s automatiquement dans la page trouv e SPIP ne distingue pas par exemple entre un menu du code javascript ou le texte de l article il colore les mots partout ce qui peut tre moche ou m me cr er des probl mes dans les scripts On peut utiliser ces deux balises pour limiter la coloration une partie de la page Par exemple lt BOUCLE_article ARTICLES id_article gt lt INCLURE menu php3 id_rubrique gt DEBUT_SURLIGNE lt h1 gt TITRE lt h1 gt CHAPO TEXTE NOTES FIN_SURLIGNE 2IDOLINDI C _artialas Balises techniques Attention ces balises s adressent des utilisateurs avertis de SPIP SELF partir de SPIP 1 8 retourne l URL de la page appel e nettoy e des variables propres l ex cution de SPIP Par exemple pour une
199. gris ce qu on appelle noir et blanc lorsqu on voque des photographies image_nb 330 330 330 Sans param tres image de gauche le filtre calcule les niveaux de gris en pond rant les composantes de l image d origine ainsi http www spip net fr_article3327 html 4 of 13 2006 04 17 19 26 49 SPIP Traitement automatis des images luminosit 0 299 x rouge 0 587 x vert 0 114 x bleu On peut forcer la pond ration des trois composantes RVB en passant les valeurs en pour mille Par exemple image de droite FICHIER image_nb 330 330 330 On a pris chaque composante R V et B niveau gal image sepia Le filtre image_sepia applique un filtre S pia Appliqu une photographie ce genre d effet donne une tonalit de vieille photographie er image _sepia image sepiaiff0033 Sans param tres image de gauche la valeur s pia est par d faut 896f5e en RVB hexad cimal On peut passer la valeur de la couleur de s pia en param tre Par exemple image de droite HFICHIERIimage _sepia ff0033 image_gamma Le filtre image_gamma change la luminosit d une image Il rend une image plus claire ou plus fonc e Son param tre est compris entre 254 et 254 Les valeurs sup rieures z ro rendent l image plus claire 254 rend toute image enti rement blanche les valeurs n gatives rendent l image plus fonc e 254 rend l image compl tement noire
200. habitude de cr er la main deux versions de ces images et d installer deux logos sur le site Deux inconv nients particuli rement g nants la manipulation est longue par ailleurs elle ne peut pas tre confi e un tiers qui serait de toute fa on incapable de la r aliser correctement lorsqu on voudra faire voluer l interface graphique du site on sera bloqu avec ces logos tr s typ s Avec les automatismes qui suivent on travaillerait autrement les auteurs http www spip net fr_article3327 html 1 of 13 2006 04 17 19 26 48 SPIP Traitement automatis des images graphique installeraient un simple logo d article par exemple une photographie sans m Le calendrier de aucun traitement sp cifique et automatiquement les squelettes de SPIP SPIP 1 8 2 en a a ques une vignette la bonne taille T m Couleurs la m me vignette en noir et blanc l g rement fonc e automatiques les reflets de l image sur le sol a Traitement automatis des images m La structure de la base de donn es png G Atdevant Qu mouveau toge Cr ation d une v rilable place offre tn espet l d ratent au secteur Avertissement lenteur Avant de commencer signalons que ces fonctions sont lourdes Voire tr s lourdes si vous utilisez de grosses images Le calcul d une image est relativement long et s il faut calculer dans vos squelettes plusieurs images voire plusieurs effets pour
201. harger la derni amp egrave re version quoideneuf gt Modifications r amp eacute centes http www spip net fr_article2128 html 5 of 9 2006 04 17 19 21 40 SPIP Internationaliser les squelettes Version catalane lt php SGLOBALS GLOBALSf idx_lang array telechargement gt Descarregar la darrera versi amp oacute quoideneuf gt Modificacions recents La construction est la suivante au d but du fichier lt php SGLOBALSI SGLOBALSfidx_lang array la fin du fichier gt la partie qu il faut enrichir soit m me consiste en plusieurs lignes de d finitions sur le mod le code gt La cha ne afficher N B Chaque ligne de d finition se termine par une virgule sauf la derni re ligne N B 2 Le texte de la cha ne traduire doit tre convertie en codes HTML les caract res accentu s par exemple sont convertis en leur quivalent HTML du type seacute 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 soit tre inscrit sur l1l internet Note terme il est pr vu d inclure un outil permettant de g rer et cr er ses propres fichiers de langue sans avoir modifier la main des fichiers PHP Un tel outil facilitera de plus l utilisation de caract res sp ciaux caract res accentu
202. hentification FORMULAIRE INSCRIPTION Sans doute le plus important le FORMULAIRE_INSCRIPTION g re l inscription des nouveaux r dacteurs Il n affiche une interface d inscription que si vous avez autoris l inscription automatique depuis le site public sinon cette balise n affiche rigoureusement rien L inscription n cessite l envoi des informations de connexion login et mot de passe par email donc ce formulaire ne fonctionne que si votre h bergeur autorise l envoi de mails par PHP HLOGIN_ PRIVE SPIP 1 4 Tout aussi important sinon plus le LOGIN_PRIVE affiche le formulaire d acc s l espace priv la partie ecrire du site Important cette balise doit imp rativement tre pr sente dans le squelette appel par la page spip_login php3 c est dire en standard par le squelette nomm login dist html1 En effet lors des acc s directs l adresse ecrire de votre site c est vers spip_login php3 que SPIP va vous rediriger http www spip net fr_article1827 html 3 of 5 2006 04 17 19 13 40 SPIP Les formulaires HLOGIN_ PUBLIC SPIP 1 4 D une utilisation beaucoup plus sp cifique LOGIN_ PUBLIC affiche un formulaire permettant vos utilisateurs de s identifier tout en restant sur le site public sans entrer dans l espace priv Cette balise sert notamment authentifier les visiteurs pour les sites proposant des forums mod r s sur abonnement Elle peut aussi servir de b
203. her les dates DATE est la date de mise en ligne Modifiable apr s la mise en ligne de l article de la br ve etc La date d une rubrique est celle de son l ment le plus r cent HDATE_REDAC est la date de premi re publication Modifiable volont disponible sur les articles seulement HDATE MODIF SPIP 1 5 est la date de derni re dition de l article pr cis ment il s agit de la derni re date laquelle cet article a t ouvert en dition qu il ait t modifi ou pas Pratique dans de nombreux cas mais pas d une rigueur scientifique Non modifiable sauf si on veut la fixer maintenant il suffit alors d ouvrir l article en dition http www spip net fr_article1971 html 1 of 4 2006 04 17 19 16 3 SPIP La gestion des dates DOCUMENTS m La boucle SYNDIC_ ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives m La popularit des articles m La gestion des dates m Exposer un article dans une liste DATE_NOUVEAUTES SPIP 1 6 permet d afficher la date du dernier envoi du mail pr sentant les nouveaut s Les filtres annee mois jour heures minutes secondes mais aussi affdate nom_ mois nom_jour saison etc s appliquent pour permettre tous les aff
204. her les derniers articles de vos r dacteurs par rubrique m Afficher automatiquement selon la date ou selon un ordre impos m Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier m Plusieurs logos pour un article m Afficher les derniers articles de vos r dacteurs par rubrique m Afficher des l ments par lignes dans un m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Trucs et astuces Afficher les derniers articles de vos r dacteurs par rubrique E fran ais m catal mEspa ol mitaliano Par d faut SPIP vous propose une page auteur qui vous permet de montrer la liste des auteurs r dacteurs participant votre site ainsi que leurs derni res contributions Mais un probl me vient se poser quand vous avez plusieurs r dacteurs et que ceux ci participent activement votre site Cela finit par tre une page rallonge Cependant il existe un moyen de montrer les derni res contributions de vos auteurs redacteurs et ce pour chacun d eux Comment proc der Tout d abord on va cr er deux fichiers un fichier myauteur php3 et un fichier myauteur html Cr ation du fichier myauteur php3 Dans le fichier myauteur php3 mettre le code suivant http www spip net fr_article1561 html 1 of 3 2006 04 17 19 32 34 SPIP Afficher les derniers articles de vos r dacteurs par rubrique tableau m Ne pa
205. http www spip net fr_article3327 html 5 of 13 2006 04 17 19 26 49 SPIP Traitement automatis des images image panman 54 T Eea i gainal I FICHIER limaae aamma 254 image alpha Le filtre image_alpha rend l image semi transparente en PNG 24 avec couche alpha Si l image tait d j semi transparente les deux informations sont m lang es 3 a 1 FA 3 ES e E dl BS AJ a yi 4 w 2 a 2 c s a z a a g E J image alpha 50 image _alpha 90 http www spip net fr_article3327 html 6 of 13 2006 04 17 19 26 49 SPIP Traitement automatis des images FICHIERIimage_alpha 50 FICHIERIimage_alpha 90 Le param tre est une valeur entre 0 et 127 0 laisse l image inchang e aucune transparence 127 rend l image compl tement transparente image flou Le filtre image_flou rend l image floue On peut lui passer en param tre un nombre compris entre 1 et 11 d finissant l intensit du floutage de 1 pixel de floutage 11 pixels de floutage FICHIER image _flou FICHIER image flou 6 Sans param tre la valeur de floutage est 3 c image flou image flou 6 Attention ce filtre est particuli rement lourd c est dire n cessite beaucoup de puissance Plut t que de tenter un floutage important on peut pr f rer flouter plusieurs fois avec des valeurs faibles Par exemple remplacer FICHIER image_flou 6
206. ichages habituels sous divers formats Sans ces filtres les balises DATE s affichent en effet au format MySQL 2001 12 OL 03 25 02 Formater les dates Une liste compl te des filtres pouvant tre appliqu s aux dates pour les formater est fournie dans l article Les filtres de SPIP Si les balises DATE sont utilis es sans filtres alors toutes les informations de date sont affich es dans un format num rique 1 2001 12 01 03 25 02 Contexte de date SPIP 1 6 fournit toutes les boucles un contexte de date Si l on se trouve l int rieur d une boucle ARTICLES BREVES OU RUBRIQUES la date en question est la date de publication de l article de la br ve ou la date de derni re modification de la rubrique Si en revanche on se trouve au premier niveau du squelette c est dire en dehors de toute boucle la date consid r e est la date du jour moins qu on ait pass une date dans l URL de la page voir l exemple plus bas Dans ce dernier cas et pour les versions de php sup rieures 3 0 12 la date pass e dans l URL est analys e avec la fonction strtotime ainsi date 2003 date 2003 01 fonctionneront mais aussi date 1year ilya un an date imarch1970 articles publi s le 1er mars 1970 etc Crit re de date d ge et d ge relatif Le crit re age permet de s lectionner les articles en fonction de la dur e qui s pare leur date de publication en ligne avec la da
207. ier d obtenir des traductions en espagnol et en arabe car le travail de traduction a d j t effectu en amont par les traducteurs de SPIP ainsi en mettant au point l interface en fran ais avec les codes fournis par SPIP il sait que ses pages s afficheront imm diatement en espagnol et en arabe Si par la suite on ajoute des articles en polonais ils seront imm diatement affich s avec les l ments de texte traduits en polonais sans que le webmestre ait intervenir nouveau Autre avantage de cette m thode elle facilite la cr ation de squelettes distribuer imm diatement multilingues Des squelettes r alis s selon cette m thode seront imm diatement utilisables dans toutes les langues dans lesquelles sera traduit SPIP D un point de vue technique les l ments de texte fournis en standard avec SPIP sont stock s dans les fichiers de langue public ecrire lang public_fr php3 contient les cha nes en fran ais ecrire lang public_en php3 en anglais etc Cr er ses propres codes Il est de plus possible de cr er ses propres codes correspondant des cha nes que http www spip net fr_article2128 html 4 of 9 2006 04 17 19 21 40 SPIP Internationaliser les squelettes 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 Pour cr er ses propres fichiers on installera dans votre r pertoire
208. illes de style acqui rent une fonction suppl mentaire fondamentale elles servent modifier les propri t s graphiques des l ments qui ne sont pas d finis dans votre HTML celui de votre squelette En effet SPIP g n re de lui m me une multitude de styles d affichage divers et vari s Ainsi les raccourcis typographiques liens hypertexte intertitres gras italique tableaux sont transform s en code HTML afin de les repr senter l cran Cela vaut aussi pour les formulaires automatiques r pondre un forum signer une p tition et d autres encore http www spip net fr_article2331 html 1 of 3 2006 04 17 19 29 5 SPIP Des styles qui ont de la class Afin que vous puissiez tout de m me modifier l apparence graphique de ces styles SPIP leur donne un nom sp cifique immuable ces noms font l objet d une liste exhaustive dans Spip et les feuilles de style Par exemple les intertitres ne g n rent pas un simple tag lt h3 gt mais un tag lt h3 class spip gt Quel est l int r t Ces tags portent un nom sp cifique dans l attribut class ce nom d finit quelle classe ils appartiennent c est dire un ensemble d l ments HTML qui h riteront des m mes propri t s graphiques d finies dans la feuille de style Comment fait on alors pour changer l apparence de tous les intertitres SPIP C est tr s simple il suffit d ouvrir votre fichiermes_styles css ou tout autre
209. in color blue a spip_out color red affiche les liens internes en bleu et les liens externes en rouge Tous les autres liens y compris ceux qui ne sont pas g n r s par SPIP s afficheront en vert De plus tous les liens seront affich es sans surlignement en effet la propri t text decoration sp cifi e dans la premi re r gle n a pas t modifi e dans les suivantes elle s applique donc automatiquement tous les l ments de type lt a gt On note ici une propri t fondamentale des feuilles de style les r gles graphiques s appliquent dans l ordre allant de la plus g n rique la plus sp cifique Cela permet de sp cifier un comportement g n ral pour la plupart des l ments et de modifier ce comportement pour un plus petit sous ensemble d l ments Cette caract ristique fait toute la puissance des feuilles de style Appliquer un traitement diff renci Plut t que de nous tendre sur la panoplie de styles g n r s automatiquement par les raccourcis typographiques de SPTP et que vous pourrez habillez votre guise ils sont num r s dans Spip et les feuilles de style tudions ici le cas o vous voulez appliquer un habillage diff rent un m me style selon sa position dans ce squelette Ce besoin est l gitime on veut par exemple afficher le corps de texte dans une police empattements avec indentation en d but de paragraphe mais le post scriptum dans une
210. invitons bien videmment corriger cette lacune en participant l effort de traduction la date de l article s affichera en toutes lettres certes mais dans une langue par d faut le fran ais probablement 2 Le sens de l criture Si votre site contient des langues s crivant de gauche droite la plupart des langues mais aussi des langues s crivant de droite gauche notamment l arabe l h breu ou le farsi il faudra de petits compl ments au code HTML pour que l affichage se fasse sans accroc 3 SPIP offre cet effet une balise sp cifique LANG_DIR qui d finit le sens d criture de la langue courante Cette balise est utilisable comme valeur de l attribut air dans la plupart des tags HTML cela donne donc 1tr pour les langues s crivant de gauche droite et rt1 pour les autres 4 Une boucle d affichage du sommaire devient donc http www spip net fr_article2124 html 4 of 8 2006 04 17 19 21 27 SPIP R aliser un site multilingue lt BOUCLE_sommaire ARTICLES par date inverse 0 10 gt lt li dir LANG _ DIR gt DATE affdate lt a href URL ARTICLE gt TITRE lt a gt lt li gt Si la mise en page repose sur des l ments align s droite ou gauche ceux ci devront tre invers s pour les langues crites de la droite vers la gauche on peut tout de suite penser remplacer tous 5 les l ments du squelette marqu s 1eft ou right parles balises LANG_
211. ipulation imm diate permet de changer par exemple le statut de tous les articles d une m me rubrique tous les publier tous les d publier sans changer de page Articles propos s 1111121 kas 20 Utilitzaci de l espai privat catal gt mer Captures d cran mor Vous avez dit SPIP mor E ME n z n S PIp lE fongb cha be S pip tn s gt gb n uZine ji che EATA O cou publi en ligne i Douveemammnt 10 Instalaci n de SPIP Ant galego 4h 10 News Interface Deutsch eve WE 5 Suggestions ultre Localisations et multilinguisme AR http www spip net fr_article3037 html 3 of 9 2006 04 17 19 24 22 SPIP SPIP 1 8 l interface graphique Des vignettes et des rotations Si vous disposez de fonctions de traitement d images sur votre serveur SPIP peut en tirer partie pour illustrer graphique l espace priv vignettes des logos dans les listes d articles br ves sous rubriques vignettes des auteurs dans les forums internes Ces fonctions graphiques rendent l interface plus agr able mais aussi plus lisible les l ments des listes tant ainsi mieux diff renci s graphiquement par l affichage d un petit logo gt 1 Pr sentation et premiers pas gt 3 Guide de l utilisateur ay gt 4 Guide du webmestre et e du bidouilleur gt 5 Questions et r ponses p Cr er une sous rubrique Ces fonctions permettent aus
212. ique sans utiliser alors les noms de fichiers par langues De cette fa on si tous les articles en espagnol sont regroup s dans la rubrique 8 et ses sous rubriques on peut se contenter de nommer le fichier adapt l espagnol rubrique 8 htm1 plut t que rubrique es html On devine les probl mes qui peuvent se poser avec cette m thode le fichier article 2 html1 doit exister si on veut quearticle 2 es html puisse tre s lectionn on ne peut pas d cider l inverse que article es html doit tre utilis la place d article 2 htmlsiarticle 2 es html n existe pas la s lection par rubriques a toujours la priorit sur la s lection par langues http www spip net fr_article2128 html 8 of 9 2006 04 17 19 21 40 SPIP Internationaliser les squelettes une correction de mise en page dans un squelette implique de faire la m me correction dans les autres versions on doit pouvoir ins rer soi m me des l ments de texte dans les fichiers des squelettes alors qu on ne comprend pas forc ment la langue imaginez vous cr er ainsi les squelettes en arabe alors que vous parlez un peu le fran ais de l ouest et assez mal l occitan du nord Cette m thode est donc destin e travailler rapidement sur des sites peu complexes peu ou pas de squelettes sp cifiques aux rubriques et ou comportant peu de langues diff rentes D s que votre projet multilingue devient un peu plus ambitieux il
213. ique l interface permettant de poster un message de forum propos de ce site Pour en savoir plus voir aussi Les formulaires HPARAMETRES_ FORUM fabrique la liste des variables exploit es par l interface du formulaire permettant de poster un message de forum propos de ce site Par exemple lt A HREF forum php3 PARAMETRES_ FORUM gt R agir ce site lt A gt Depuis SPIP 1 8 2 on peut lui passer un param tre sp cifiant l adresse de retour apr s avoir post le message Par exemple lt A HREF forum php3 PARAMETRES_FORUM SELF gt R agir ce site lt A gt renverrale visiteur sur la page actuelle une fois que le message a t valid http www spip net fr_article910 html 3 of 3 2006 04 17 19 11 51 SPIP La boucle DOCUMENTS E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La boucle DOCUMENTS m fran ais m catal mDeutsch mEnglish m Espa ol m italiano E e SPIP 1 4 La boucle DOCUMENTS retourne une liste de documents multim dia associ s un article une rubrique ven
214. istration signalant l erreur Tidy et cr un fichier r capitulant les diff rentes pages ayant rencontr des erreurs Encore une fois afin de ne pas pr ter l outil des possibilit s magiques qu il n a pas et ses d veloppeurs des intentions qui ne sont pas les leurs il est important de noter que SPIP ne se contente pas de se reposer sur un outil Tidy dont les limites sont connues mais de l int grer dans une logique plus large de mise en conformit d abord en am liorant le code produit par SPIP en utilisant ensuite Tidy la fois comme outil de nettoyage du code mais aussi en proposant une indication des erreurs pour permettre au webmestre d am liorer son code La mise en conformit du code ne peut reposer sur une solution purement technique mais sur un travail personnel pour lequel avec Tidy SPIP offre un outil de suivi Installer Tidy Tidy extension de PHP Tidy existe en tant qu extension de PHP C est la fa on la plus simple de l utiliser l outil tant alors directement utilisable par le webmestre Pour d terminer sa pr sence on pourra consulter la page ecrire info php3 de son site pour obtenir la configuration de son serveur et la liste des extensions de PHP http www spip net fr_article3070 html 2 of 7 2006 04 17 19 22 38 SPIP Tidy validation XHTML 1 0 disponibles N B l heure actuelle l utilisation de Tidy en tant qu extension de PHP n
215. le nombre d endroits o ces propri t s sont appliqu es dans le HTML Concr tement La feuille de style lorsque vous l appliquez un fichier HTML qui peut tre un squelette SPIP doit tre d clar e dans le tag lt heaa gt du fichier HTML aux c t s du titre et autres champs lt meta gt De la fa on suivante lt head gt lt link rel stylesheet type text css href mes_ styles css gt lt head gt Ici le fichier mes_styles css contient les propri t s graphiques que je veux appliquer la page HTML dans toute la suite du tutorial on supposera que mes_styles css est le nom que vous avez choisi pour ce fichier Ce fichier porte l extension css En effet CSS 1 est le nom du langage utilis pour les feuilles de style de la m me mani re que HTML est le nom du langage utilis http www spip net fr_article2330 html 2 of 3 2006 04 17 19 28 52 SPIP Introduction pour la r alisation de pages Web Note une feuille de style peut s appliquer aussi bien une page HTML classique statique qu un squelette SPIP Cela veut dire que toute astuce CSS valable dans du HTML classique sera aussi utilisable dans un squelette de votre site Si vous avez bien lu les paragraphes pr c dents vous serez peut tre dubitatifs oui il faut apprendre un nouveau langage pour utiliser les feuilles de styles SPIP n y est pour rien Les CSS n utilisent pas en effet la syntaxe du HTML Cepend
216. le num ro 18 c est SPIP qui va fixer automatiquement le num ro de la rubrique lors de sa cr ation J installe tous mes documents de substitution l int rieur de cette rubrique num ro 18 Il est inutile de leur donner un titre Pour appeler au hasard un document install dans cette rubrique il me suffit d invoquer les crit res suivants lt BOUCLE doc _substitution DOCUMENTS id_rubrique 18 0 1 par hasard gt EMBED DOCUMENT Notez bien le crit re par hasard ne signifie pas que l image sera diff rente chaque visite de la page mais qu elle sera s lectionn e au hasard chaque recalcul de la page On prendra soin dans la navigation du site d interdire l affichage de la rubrique 18 qui n a pas besoin d tre pr sent e aux visiteurs Le crit re id_rubrique 18 fera l affaire Pour terminer la mise en place du dispositif il nous suffit d ins rer cette boucle affichant un document de substitution pris au hasard dans la rubrique 18 en tant que texte alternatif notre BOUCLE_doc_haut la place du LOGO_ ARTICLE lt BOUCLE doc _haut DOCUMENTS id_article titre spip_haut gt EMBED DOCUMENT lt BOUCLE doc _haut gt lt BOUCLE doc substitution DOCUMENTS id_rubrique 18 0 1 par hacardls http www spip net fr_article2001 html 8 of 10 2006 04 17 19 32 21 SPIP Plusieurs logos pour un article Afficher un titre graphique Toujours sur le m me principe nou
217. lic m Contribuer au d veloppement de SPIP m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur Rapidit du site public mfran ais m ee catal mEspa ol mitaliano Contrairement la plupart des syst mes de publication gratuits SPIP int gre un syst me de cache permettant d acc l rer l affichage du site public Quelques pistes pour comprendre ce qui influe sur la rapidit de votre site Optimiser un site Si vous vous inqui tez pour la rapidit de votre site il est bon de vous int resser aux pistes suivantes Votre h bergement Web offre t il des performances de bonne qualit Evidemment c est subjectif L expression mauvaise qualit recouvre coup s r la plupart des h bergeurs gratuits notamment Free Bonne qualit inclut forc ment une machine d di e i e qui ne sert qu votre site de fabrication r cente mais aussi des h bergeurs commerciaux pas trop au rabais Entre les deux a devient tr s subjectif en fonction de vos exigences de la taille de votre site Si la qualit de votre h bergement laisse d sirer vous aurez int r t ne pas http www spip net fr_article997 html 1 of 3 2006 04 17 2 23 39 SPIP Rapidit du site public cr er de squelettes trop complexes i e qui demandent SPIP d afficher trop d informations diff rentes Cela vaut pour tout type d informations tout c
218. lises de cette boucle Les l ments obtenus avec une boucle HIERARCHIE sont des rubriques On peut donc utiliser toutes les balises propos es pour les boucles RUBRIQUES http www spip net fr_article913 html 2 of 2 2006 04 17 19 12 45 SPIP Les crit res communs toutes les boucles E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle m SPIP syst me de publication pour l in NT ternet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence Les crit res communs toutes les boucles m catal mDeutsch mEnglish m Espa ol mitaliano E fran ais meccccce Certains crit res s appliquent presque tous les types de boucles Ce sont des crit res destin s restreindre le nombre de r sultats affich s ou indiquer l ordre d affichage On peut sans difficult combiner plusieurs de ces crit res de s lection Classer les r sultats par crit re de classement indique l ordre de pr sentation des r sultats Ce crit re de classement correspond l une des balises tir es de la base de donn es pour chaque type de boucle Par exemple on pourra classer les articles par date par date_redac ou par titre Notez que
219. lles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue Internationaliser les squelettes m Utiliser des URLS personnalis es m Le moteur de recherche Les variables de personnalisation ua Tidy validation XHTML 1 0 m Le support LDAP Le traitement des images E Ins rer des formules math matiques en LaTEX m SPIP 1 8 l interface m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es Tidy validation XHTML 1 0 mfran ais mcatal mEspa ol mitaliano SPIP 1 8 1 permet aux webmestres qui le d sirent d utiliser sur leurs pages l outil Tidy introduisant ainsi une fonction de validation XHTML sur leur site Principe g n ral Tidy est un outil externe SPIP qui permet de transformer du code HTML 4 relativement propre en code XHTML 1 0 transitional valide SPIP exploite cet outil pour permettre aux webmestres de proposer des sites conformes aux recommandations du XHTML 1 0 transitional Important Tidy n est pas un outil magique il est incapable de transformer du code tr s sale en code conforme Face certaines erreurs de code il refuse purement et simplement de fonctionner L outil est donc int gr dans SPIP pour la fois cr er du code conforme et permettre de traquer les erreurs de code dans vos pages tape 1 il convient avant tout
220. lon la date ou selon un ordre impos m Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier m Plusieurs logos pour un article m Afficher les derniers articles de vos r dacteurs par rubrique m Afficher des l ments par lignes dans un tableau m Ne pas afficher les articles publi s depuis m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Trucs et astuces Pr senter les r sultats d une recherche par secteurs E fran ais m catal mEspa ol mitaliano Il suffit d inclure la boucle de recherche dans une boucle de type rubriques s lectionnant les rubriques de premier niveau dans la boucle de recherche on ajoute alors le crit re id_secteur pour se limiter au secteur courant lt BOUCLE_secteurs RUBRIQUES racine gt lt B_recherche gt lt b gt TITRE lt b gt lt ul gt lt BOUCLE_ recherche ARTICLES recherche id_ secteur par points inverse 0 5 gt lt li gt lt a href URL_ARTICLE TITRE lt a gt lt BOUCLE_ recherche gt On remarquera que le titre du secteur n est affich que si la recherche a donn des r sultats pour ce secteur D autre part pour chaque secteur on n affiche que les cinq articles les mieux class s par ordre d croissant de pertinence Attention cependant comme la recherche est effectu e autant de fois qu il y a de secteurs le calcul risque d tre
221. m me que votre feuille de style doit tre d clar e dans vos fichiers HTML et que ceux ci doivent tre recalcul s une premi re fois pour que cette d claration soit prise en compte la ligne lt link rel stylesheet type text css href mes_ styles css gt doit se trouver dans le cache pour que votre navigateur puisse en tenir compte http www spip net fr_article2331 html 3 of 3 2006 04 17 19 29 5 SPIP Une typographie personnalis e m Introduction m Des styles qui ont de la class x Une typographie personnalis e E s sont beaux mes formulaires m Pour en savoir plus m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m initiation utiliser les feuilles de style avec SPIP Une typographie personnalis e E fran ais m catal mDeutsch m English E italiano m Espa ol Apr s une introduction g n rale sur les feuilles de style nous allons maintenant passer en revue quelques uns de leurs usages les plus courants sous SPIP Int ressons nous ici aux styles cr s lorsque des raccourcis typographiques sont ins r s dans un texte entr sous SPIP Que l on affiche un article une br ve une rubrique ou autre n a aucune importance les styles portent toujours les m mes noms Cela ne nous emp chera pas de d couvrir comment y appliquer ventuellement des habillages graphiques distincts Le texte de base M me le text
222. m English m fran ais m Espa ol mitaliano Une boucle d articles se code en pla ant ARTICLES avec un s entre parenth ses lt BOUCLENn ARTICLES crit res gt Les l ments contenus dans une telle boucle sont des articles Les crit res de s lection On utilisera l un ou autre des crit res suivants pour indiquer comment on s lectionne les l ments tout les articles sont s lectionn s dans l int gralit du site dans toutes les rubriques Utile notamment pour afficher les articles les plus r cents dans l int gralit du site sur la page d accueil En r alit le crit re tout n est pas trait de mani re informatique c est un aide m moire pour le webmestre on obtient le m me r sultat en n indiquant aucun des crit res suivants http www spip net fr_article902 html 1 of 6 2006 04 17 19 10 42 SPIP La boucle ARTICLES DOCUMENTS m La boucle SYNDIC_ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives m La popularit des articles m La gestion des dates m Exposer un article dans une liste id_article retourne l article dont l identifiant est id_article Comme l identifiant de chaque article est unique ce crit re ne retourne qu une ou z ro r ponse id_ rubrique ret
223. m Ne pas afficher les articles publi s depuis plus d un an m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Trucs et astuces Afficher des l ments par lignes dans un tableau E fran ais m catal m English m italiano m Espa ol Par exemple on peut vouloir cr er un tableau contenant les titres des articles d une rubrique agenc s sur trois colonnes le nombre de lignes d pendant du nombre total d articles sur le principe dei article article 2 3 article article article 4 5 6 article article article 7 8 9 L astuce consiste jouer la fois avec les doublons et avec les boucles r cursives On construit une premi re boucle qui affiche les trois premiers articles de la rubrique une fois les doublons limin s On voit qu il suffit ensuite de r afficher cette boucle chaque fois qu il reste des articles pour afficher graduellement tous les articles ceux d j affich s venant chaque fois grossir les rangs des doublons Pour cela dans le code conditionnel de cette boucle on ajoute un appel r cursif vers la boucle elle m me elle sera affich e tant qu elle produit des r sultats http www spip net fr_article1498 html 1 of 2 2006 04 17 19 32 49 SPIP Afficher des l ments par lignes dans un tableau m Pr senter les r sultats d une recherche par secteurs m Afficher le nombre de messages du forum li un article m
224. m du site Web indiqu par l auteur HURL SITE l adresse URL de ce site Web Ends http www spip net fr_article912 html 2 of 2 2006 04 17 19 12 30 SPIP La boucle HIERARCHIE E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle gi NOT TERT m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La boucle HIERARCHIE m fran ais m catal mDeutsch wm English m Espa ol w italiano La boucle HIERARCHIE retourne la liste des RUBRIQUES qui m nent de la racine du site la rubrique ou l article en cours lt BOUCLEn HIERARCHIE crit res gt Les crit res de s lection On utilisera obligatoirement l un des deux crit res suivants pour indiquer comment on s lectionne les l ments id_article retourne la liste des rubriques depuis la racine jusqu la rubrique contenant l article correspondant cet identifiant id rubrique retourne la liste des rubriques depuis la racine jusqu la rubrique correspondant cet identifiant exclue Note Depuis SPIP 1 8 tout permet d obtenir aussi la rubrique http www spip net fr_article913 html 1
225. m_email text ad_ email text nom_site text par le signataire url_site text message est le message ventuellement entr par le message mediumtext signataire statut varchar 10 statut est le statut de la signature publie maj timestamp 14 accept e poubelle supprim e toute autre valeur donne la valeur de la cl de validation utilis e pour la confirmation par e mail maj a la m me signification que dans les autres tables Les relations entre objets Ces tables ne g rent aucun contenu simplement une relation entre les objets pr sents dans d autres tables Ainsi spip_ auteurs articles sp cifie la relation entre auteurs et articles Si un id_ auteur y est associ un id article cela veut dire que l auteur en question a http www spip net fr_article713 html 5 of 7 2006 04 17 19 27 12 SPIP La structure de la base de donn es crit ou co crit l article il peut y avoir plusieurs auteurs par article et vice versa bien s r spip mots articles d finit de m me la relation de r f rencement des articles par des mots cl s Gestion du site La table spip_ meta est primordiale Elle contient des couples nom valeur index s par le nom cl primaire ces couples permettent de stocker diff rentes informations telles que la configuration du site ou la version install e de SPIP La table spip_ forum _ cache est utilis e afin d adapter le syst me de cache l instantan it des
226. mais une norme chez les h bergeurs n h sitez pas demander leur installation pour en b n ficier sur votre site http www spip net fr_article3024 html 5 of 5 2006 04 17 19 23 5 SPIP Ins rer des formules math matiques en LATEX m Spip et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue Internationaliser les squelettes m Utiliser des URLS personnalis es m Le moteur de recherche m Les variables de personnalisation m Tidy validation XHTML 1 0 m Le support LDAP m Le traitement des images E Ins rer des formules math matiques en LaTEX m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es Ins rer des formules math matiques en LaTEX mfran ais mcatal mEspa ol mitaliano SPIP 1 8 introduit une puissante fonctionnalit permettant d ins rer dans les textes des formules de math matique complexes en utilisant la syntaxe de TEX LATEX Cette fonctionnalit permet par exemple d afficher une formule comme celle ci ei 6 8 ef e i8 5 en la codant directement dans le texte comme on peut le faire avec TEX Notez bien l utilisation de cette m thode n cessite videmment de conna tre la syntaxe des formules dans TEX Syntaxe qui n est pas simple Des images dans le texte http www spip net fr_article3016 html 1 o
227. matiques m Traitement automatis des images m La structure de la base de donn es 1 une m thode consistant stocker les l ments de texte des squelettes dans des fichiers de langue un fichier diff rent par langue utilis e sur le site s par s des squelettes un squelette unique par exemple article html appelant selon des codes d finis par le webmestre ces l ments de texte en fonction de la langue utilis e de cette fa on un m me squelette article html affichera automatiquement le texte R pondre cet article ou Comment on this document en fonction de la langue de l article Cette m thode est vivement conseill e elle offre le plus de souplesse elle facilite les mises jour du site on travaille avec un squelette unique qui g re automatiquement plusieurs langues et terme des outils seront ajout s SPTP facilitant le travail collectif de traduction de l interface de votre site plusieurs administrateurs parlant chacun une langue diff rente pourront traduire l interface d un m me site depuis l espace priv sans avoir besoin d intervenir sur les fichiers des squelettes 2 une m thode plus rapidement accessible techniquement tr s simple reposant sur la cr ation de fichiers de squelettes diff rents pour chaque langue Dans cette m thode on fabrique un fichier article htm1 pour g rer les articles en fran ais et un fichier article en htm1i pour les articles en anglai
228. me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La syntaxe des boucles m fran ais m catal mDeutsch mEnglish mEspa ol w italiano Syntaxe de base La syntaxe simplifi e d une boucle est la suivante lt BOUCLEn TYPE crit rel crit re2 crit rex gt Code HTML balises SPIP lt BOUCLEn gt On a vu dans l explication sur les boucles et les balises que le Code HTML balises SPIP se r p tait autant de fois que la boucle obtenait d l ments tir s de la base de donn es c est dire une fois plusieurs fois ou z ro fois La ligne importante ici est lt BOUCLEn TYPE crit rel crit re2 crit rex gt L l ment BOUCLE est l ordre indiquant qu il s agit d une boucle SPIP on ne peut donc pas le modifier dit autrement toutes les boucles de SPIP commencent http www spip net fr_article898 html 1 of 7 2006 04 17 19 10 12 SPIP La syntaxe des boucles DOCUMENTS m La boucle SYNDIC_ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives m La popularit des articles m La gestion des dates m Exposer un article dans une liste par l instruction BOUCLE L l ment n est au choix le nom de l
229. ment d un processus de nettoyage SPIP lui m me continue produire du code de plus en plus propre Tidy sert alors mettre la derni re touche de nettoyage sur du code d j tr s compliant au passage en r solvant quelques incompatibilit s difficiles g rer avec un code unique entre le HTML et le XHTML telles que certaines balises auto fermantes en XHTML et non ferm es en HTML telles que lt br gt Tidy est ensuite utilis pour identifier les erreurs de codage dans le code source des articles eux m mes lors de l insertion assez fr quent de code HTML la main dans le corps des articles Encore une fois ces fonctionnalit s sont toutes r centes et demandent sans doute des tests suppl mentaires N h sitez pas faire part de votre exp rience sur spip dev 1 Ce fichier titre son nom de l article W3C go home publi sur sur uZine qui critiquait l acharnement des proph tes de la compliance emm les webmestres qui se contentent de faire des pages Web l essentiel rappelons le est de publier sans se casser la t te Si en plus on peut le faire de mani re conforme tant mieux et c est l objet de cette passerelle SPIP Tidy http www spip net fr_article3070 html 6 of 7 2006 04 17 19 22 38 SPIP Le support LDAP m Spip et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue m Internationaliser les squelettes E
230. n es au visiteur sont tir es du CACHE par une page crite en PHP Vous pouvez donc inclure dans vos squelette des instructions en PHP elles seront ex cut es lors de la visite Utilis e de mani re assez fine cette possibilit permet une grande souplesse SPIP que vous pouvez ainsi compl ter par exemple ajouter un compteur etc ou m me faire voluer certains l ments de mise en page en fonction des informations tir es de la base de donn es 1 Siarticle html n existe pas le fichier dist est pris la place Lire ce propos Qu est ce que les fichiers dist http www spip net fr_article877 html 7 of 8 2006 04 17 19 09 48 SPIP Des boucles et des balises E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence Des boucles et des balises m fran ais m catal mDeutsch mEnglish m italiano m Espa ol Tout ce qui suit concerne d sormais le langage de description de la mise en page des squelettes dans SPIP si vous avez bien compris l explication pr c dente vous savez que nous travaillons donc da
231. n es pour les lignes d un tableau ici gris clair et gris fonc Ligne de s paration horizontale http www spip net fr_article1177 html 5 of 8 2006 04 17 19 21 0 SPIP Spip et les feuilles de style Une ligne de s paration horizontale d finie par peut tre modifi e par hr spip Gras et italique Le gras et l italique sont d finis par les raccourcis Du texte en gras du texte en italique Ils peuvent tre modifi s par les styles strong spip eti spip Styles peu utiles historique dans les versions ant rieures SPIP 1 8 le texte en gras est d clar par le style b spi p gt Les paragraphes Les paragraphes cr s par SPIP en laissant des lignes vides entre les paragraphes peuvent tre modifi s par le style p spip A priori peu utile car on peut directement param trer le comportement des l ments de texte en HTML Les formulaires Dans l espace public diff rents formulaires sont utilis s pour le moteur de recherche interne l interface de r daction des messages des forums les inscriptions l espace priv Les feuilles de style sont forml spip_ encadrer spip_bouton formrecherche Par d faut ils sont d finis ainsi http www spip net fr_article1177 html 6 of 8 2006 04 17 19 21 0 SPIP Spip et les feuilles de style forml width 100 background color FFDDAA Spip_encadrer background color EEEEEE forml
232. n de texte script SPIP 1 8 introduit les filtres hauteur et Largeur qui retournent les informations sur la taille i e Hauteur et Largeur de l l ment filtr si c est une image Ces filtres n ont qu un int r t moyen tre appliqu s directement un logo de document puisqu il y a d j HAUTEUR et LARGEUR disposition pour les documents Par contre on peut les appliquer apr s le filtre reduire_image pour conna tre la taille exacte de l image r duite Plus g n ralement on peut les appliquer sur n importe quelles balises ou filtre retournant un balise HTML lt img gt http www spip net fr_article901 html 6 of 11 2006 04 17 19 14 18 SPIP Les filtres de SPIP reduire image largeur hauteur SP P17 1introduitlefiltre reduire_image qui permet de forcer une taille maximale d affichage des images et des logos Ce filtre s utilise par exemple sur un logo d article de la fa on suivante HLOGO _ARTICLEright reduire image Dans cet exemple logo de l article appara t align droite une taille maximale de 130 pixels Depuis SPIP 1 8 2 ce filtre peut prendre deux arguments largeur et hauteur Si l un de ces deux arguments est gal 0 SPIP ne tient compte que de l autre et calcule cette dimension en conservant les proportions de l image De plus ce filtre s applique aussi la balise TEXTE et ce sont alors toutes les images que le r dacteur introduit dans le te
233. n r guli re les premiers http www spip net fr_article2001 html 6 of 10 2006 04 17 19 32 21 SPIP Plusieurs logos pour un article caract res le symbole indique le d but de la cha ne de caract res sont spip suivi de _ dans la syntaxe des expressions r guli res _ indique le caract re _ de la m me fa on que indique le caract re Ce crit re s lectionne donc les documents joints dont le titre ne commence pas par spip_ L expos du principe g n ral est termin vous avez largement de quoi vous amuser avec a sur votre propre site Les exemples suivants n en sont que des variations Afficher toujours un gros logo en haut de page Je d cide toujours de mani re arbitraire qu il doit toujours y avoir une grosse image en haut de page de mes articles Il s agit d un choix graphique de ma part pour assurer l unit graphique de mon site j affiche en haut de page une version de grand format li e l article une variation du principe du grand logo et d faut une image stock e ailleurs sur mon site Toujours le m me principe je joins mon article un document dont je fixe le titre spip_ haut Pour viter que ce document ne s affiche dans le portfolio de la BOUCLE_documents_ joints pr c dente je fais commencer son titre par spip Dans mon squelette des articles j affiche simplement en
234. n sp cifie ici comme rempla antes successives de Bookman la classique Times New Roman et en dernier recours serif serif n est pas une police en soi c est un code g n rique qui indique au navigateur de prendre la police empattements par d faut de l ordinateur de m me sans serif sp cifie la police sans empattements par d faut en g n ral Arial ou Helvetica On retiendra cette r gle importante dans la propri t font family il convient toujours de proposer plusieurs choix successifs pour s adapter aux polices de caract res install es sur l ordinateur du visiteur Notons que cette r gle est aussi valable pour le tag lt font face gt du HTML traditionnel Bien videmment d autres propri t s sont votre disposition Vous pouvez par exemple r gler la taille du texte avec la propri t font size Notez cependant que les navigateurs disposent d un r glage pour configurer la taille du texte par d faut et le texte principal de vos pages ne devrait pas outrepasser ce r glage pour des raisons de confort visuel c est l utilisateur qui choisit la taille de base non le webmestre http www spip net fr_article2332 html 2 of 6 2006 04 17 19 29 18 SPIP Une typographie personnalis e Notez bien que les styles que vous appliquez aux tags lt b gt s appliquent chaque paragraphe en tant qu objet autonome Cela autorise certains effets int ressants comme par exemple d indenter la pr
235. ne les deux balises pr c dentes et peut donc s appliquer un texte ou une balise d url Ajouter ses propres fonctions Les filtres de SPIP sont des fonctions PHP qui re oivent la balise sur laquelle ils sont appliqu s en premier param tre et retournent le texte afficher Vous pouvez utiliser directement les fonctions habituelles de PHP mais galement cr er les v tres sur le mod le lt php function mon_filtre texte texte bidouillages en PHP return texte gt Afin de ne pas avoir modifier des fichiers de SPIP qui risqueraient d tre cras s lors d une prochaine mise jour vous pouvez installer vos fonctions personnelles dans un fichier mes_fonctions php3 si SPIP rep re un fichier ayant ce nom il l inclut automatiquement Par exemple ARNO a d velopp le filtre enlett res qui n est pas inclus dans la distribution standard de SPIP Ce filtre crit un nombre en toutes lettres DATE annee enlettres deux mille deux ce filtre peut tre t l charg sur http www uzine net spip contrib a il suffit de l ajouter dans votre fichiermes_fonctions php3 pour l utiliser http www spip net fr_article901 html 10 of 11 2006 04 17 19 14 18 SPIP Les filtres de SPIP Filtres avec des param tres Depuis SPIP 1 5 il est possible de passer des param tres dans les filtres La syntaxe est BALISEfiltre arg1 arg2 Le filtre doit
236. nnel apr s le texte qui s affiche apr s la boucle si elle contient des l ments et le texte conditionnel alternatif le texte qui s affiche si la boucle est vide Nous devons cr er une boucle de type FORUMS li e un article de fa on compter son nombre de r sultats Premi re subtilit nous voulons tous les messages des forums li s l article en comptant les r ponses aux messages les r ponses aux r ponses Une simple boucle de type lt BOUCLE_ forum FORUMS id_article gt contient uniquement les messages qui r pondent l article Habituellement pour acc der aux r ponses ces messages on inclut une seconde boucle l int rieur de http www spip net fr_article1495 html 1 of 2 2006 04 17 19 33 43 SPIP Afficher le nombre de messages du forum li un article plus d un an m Pr senter les r sultats d une recherche par secteurs m Afficher le nombre de messages du forum li un article m Un menu d roulant pour pr senter une liste d articles m Remplir les meta tags HTML des pages d article celle ci Ici nous voulons que la boucle s lectionne absolument tous les messages attach s l article sans tenir compte de leur hi rarchie Pour cela il faut sp cifier le crit re plat qui comme son nom l indique sert afficher un forum plat Ce qui donne lt BOUCLE_ forum FORUMS id_article plat Voyons maintenant comment compter les l ments qu
237. nom que vous avez d cid de lui donner dans un diteur de texte et d y ajouter les lignes suivantes h3 spip color red font size 18px Rechargez la page et tous les intertitres SPIP appara tront comme par magie en rouge remarquez de plus que les autres tags lt h3 gt de votre page s il y en a ne sont pas affich s en rouge Si rien de tout cela n appara t v rifiez bien que vous avez d clar la feuille de style dans le squelette dans le tag lt head gt comme expliqu dans l article pr c dent et recalculez la page Expliquons bri vement la syntaxe de cette r gle de mise en page h3 spip juste avant les accolades signifie que la r gle qui suit ne s appliquera qu aux tags lt h3 gt qui ont un attribut class gal spip Notez bien ni les tags lt h3 gt n ayant pas cet attribut ni les tags ayant cet attribut sans tre des tags lt h3 gt ne seront concern s Les accolades contiennent la liste des propri t s graphiques associ es au style ainsi d finies Notons que toutes les propri t s non d finies dans cette liste garderont leur valeur habituelle pour le tag consid r dans le cas pr sent le tag lt h3 gt g n rera toujours un texte en gras car rien dans le style ne dit le contraire http www spip net fr_article2331 html 2 of 3 2006 04 17 19 29 5 SPIP Des styles qui ont de la class Les propri t s list es entre accolades sont chacunes termin es par un p
238. ns les fichiers html La pr sente documentation est volontairement technique il s agit ici de r f rences techniques vous pouvez pr f rer commencer par notre guide Pas pas plus didactique et revenir ensuite ici pour une documentation plus pr cise Des boucles La notion de base du langage de SPIP est la boucle La logique de la boucle Une base de donn es classiquement c est une liste d l ments ici une liste des articles une liste des rubriques une liste des auteurs etc Pour fabriquer le site on va donc extraire de cette liste certains de ses l ments http www spip net fr_article894 html 1 of 4 2006 04 17 19 10 0 SPIP Des boucles et des balises DOCUMENTS m La boucle SYNDIC_ ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives m La popularit des articles m La gestion des dates m Exposer un article dans une liste la base on veut extraire un seul l ment d une liste par exemple afficher l article d sir mais il est fr quent d extraire plusieurs l ments d une liste par exemple dans la page d une rubrique on veut afficher tous les articles contenus dans cette rubrique ainsi que toutes les sous rubriques contenues dans cette rubrique plus subtil il
239. ns sur supports mobiles dot s de connexions tr s lentes et ou d crans de petite taille smartphones PDA communiquants http www spip net fr_article3037 html 6 of 9 2006 04 17 19 24 22 SPIP SPIP 1 8 l interface graphique Espaces plus grands ou pas La zone Texte du formulaire de modification d articles s adapte pour occuper toute la hauteur de la fen tre Ce qui d s qu on utilise une d finition d cran sup rieure 800x600 permet d agrandir notablement l espace pour saisir son texte Selon le m me principe les fen tres de Navigation rapide occupent toute la hauteur de l cran Formulaires dynamiques De nombreux formulaires deviennent dynamiques des boutons de validation des cases de s lection ainsi que des zones de texte apparaissent ou disparaissent en fonction des choix des utilisateurs Ainsi dans l affichage d un article certains boutons de Validation n apparaissent que lorsqu on modifie le menu d roulant attenant On pourra galement voir de tels formulaires dans l espace de configuration du site par exemple dans la zone R f rencement de sites selon qu on s lectionne G rer un annuaire de sites Web ou D selectionner et Utiliser la syndication ou non on voit les options de configuration changer imm diatement Statistiques Les pages d affichage des statistiques ne changent pas dans leur principe On notera l apparition de boutons de
240. ns une feuille de style de sp cifier qu un lien doit s ouvrir une nouvelle fen tre Rat Eu n H ETE http www spip net fr_article2332 html 6 of 6 2006 04 17 19 29 18 SPIP Ils sont beaux mes formulaires m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m initiation utiliser les feuilles de style avec SPIP Ils sont beaux mes formulaires mfran ais mec catal mDeutsch mEnglish mEspa ol mitaliano Vous avez personnalis la mise en page et la typographie de votre site mais maintenant ce sont les formulaires SPIP qui jurent totalement sur le reste Pas de panique l aussi les feuilles de style rem dient au probl me m Introduction Vous vous souvenez que les feuilles de style utilis es en conjonction avec SPIP m Des styles permettent d adapter le rendu des raccourcis typographiques votre mise en rte j page Eh bien il en va de m me pour les formulaires g n r s par SPIP leur aspect graphique peut tre modul afin de s ins rer sans hiatus dans votre design m Une typographie personnalis e Encore une fois pas question ici de passer en revue l ensemble des styles fournis TIEN l par SPIP Sachez cependant que vous pouvez alt rer l aspect de tous les formulaires formulaires de l espace public formulaire de r ponse aux forums de recherche m Pour en de signature de p tition 1 Nous nous bornons ici donner
241. nt 21 maj idem que dans les autres tables mal timestamp 14 Les mots cl s spip_ mots id mot bigint 21 Chaque mot cl est identifi par son id_ mot type varchar 100 Le type du mot cl est le type ou groupe choisi pour le titre text mot cl En d finissant plusieurs types on d finit plusieurs classifications ind pendantes par exemple sujet poque pays titre descriptif texte parlent d eux m mes timestamp 14 maj idem que dans les autres tables descriptif text texte longblob mal http www spip net fr_article713 html 3 of 7 2006 04 17 19 27 12 SPIP La structure de la base de donn es Les sites syndiqu s spip_ syndic id syndic bigint 20 Chaque site syndiqu est identifi par son id_ syndic id_ rubrique bigint 20 id_ rubrique et id_ secteur d finissent l endroit dans la id_secteur bigint 20 hi rarchie du site o viennent s ins rer les contenus nom _site blob syndiqu s MS blob nom site url_ site descriptif sont le nom l adresse et in nes le descriptif du site syndiqu uisyndic blob url syndic est l adresse du fichier dynamique utilis pour descriptif blob r cup rer les contenus syndiqu s souvent il s agit de url site suivi de backend php3 Les articles syndiqu s spip_ syndic articles id_syndic_article bigint 20 Chaque article syndiqu est identifi par son id_syndic bigint 20 id_syndic_ article titre te
242. nt de la class m Une typographie personnalis e mis sont beaux mes formulaires m Pour en savoir plus m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur a initiation utiliser les feuilles de style avec SPIP Introduction m Deutsch T rk e m fran ais E catal m English mEspa ol mitaliano m Cette pr sentation consid re que vous connaissez le syst me des squelettes SPIP et que vous tes capables de comprendre des squelettes simples Dans le cas contraire nous vous conseillons de relire le tutorial et ou le manuel de r f rence Pourquoi les feuilles de style Si vous r alisez des pages Web de mani re traditionnelle les indications graphiques sont ins r es dans le code HTML de votre page Ainsi chaque fois que vous voulez mettre un texte en rouge vous crivez lt font color red gt Pour afficher un tableau avec des bordures paisses vous crivez lt table border 2 gt Avec cette m thode et un site statique o chaque article a une page HTML sp cifique changer la maquette de tout un site est un cauchemar il faut dans tous les fichiers HTML rechercher les morceaux de HTML modifier et effectuer les modifications une par une par exemple remplacer lt font color red gt par lt b gt si l on d cide que les l ments anciennement affich s en rouge seront d sormais en gras Comme vous le savez d j
243. nt est obligatoire m Le traitement 2 un type de calendrier jour semaine mois ou periode la valeur par des images d faut est mois m Ins rer des be dues Ces deux arguments doivent tre litt raux autrement dit ils ne peuvent tre en LATEX calcul s dynamiquement par ENV ou toute autre balise SPIP 1 8 AES l interface Les trois prochains arguments sont optionnels et peuvent tre indiqu s par des http www spip net fr_article3182 html 1 of 5 2006 04 17 19 24 40 SPIP Le calendrier de SPIP 1 8 2 graphique m Le calendrier de SPIP 1 8 2 E Images typographiques m Couleurs automatiques E Traitement automatis des images m La structure de la base de donn es balises avec et sans filtre 1 YYYY une cha ne d exactement 4 chiffres indiquant une ann e 2 MM une cha ne d exactement 2 chiffres indiquant un mois 3 JJ une cha ne d exactement 2 chiffres indiquant un jour Si ces valeurs sont omises ou nulles elles sont remplac es par celle de la date courante Ces param tres repr sentent la date d un jour dans la p riode choisie sile type est jour on affichera les l ments dont la date correspond au jour sp cifi si le type est semaine on affichera les l ments dont la date est dans la semaine qui contient le jour sp cifi si le type est moi s on affichera les l ments dont la date est dans le mois qui contient le mois sp cifi dans ce cas le param tre d
244. ochets Le texte optionnel avant et le texte optionnel apr s ne s affichent que s il existe dans la base de donn es un l ment correspondant cette balise Notre exemple devient lt BOUCLE_articles ARTICLES id_rubrique gt lt li gt SURTITRE lt br gt TITRE lt BOUCLE _articles gt On obtient alors le r sultat recherch s il existe un surtitre pour cet article il est affich et suivi du lt BR gt s il n existe pas de surtitre m me le lt BR gt est occult Utilisations avanc es A partir de SPIP 1 8 on peut imbriquer des balises tendues les unes dans les autres Ainsi si dans notre exemple on voulait n afficher le logo de l article que si le surtitre est d fini on pourrait crire lt BOUCLE_articles ARTICLES id_rubrique gt lt li gt HLOGO_ARTICLE lt br gt SURTITRE lt BOUCLE _articles gt Note On ne peut jamais mettre une boucle dans le code optionnel d une balise Ma s si on veut faire n afficher une boucle qu en fonction d une certaine balise on peut utiliser lt INCLURE gt l int rieur d un code optionnel Balises non ambigu s Quand on imbrique des boucles les unes dans les autres il peut arriver que deux boucles aient des balises homonymes Par exemple dans le code suivant http www spip net fr_article899 html 3 of 6 2006 04 17 19 10 24 SPIP La syntaxe des balises SPIP lt BOUCLE_ rubriques RUBRIQUES id_rubrique
245. oint virgule Elles sont constitu es d un nom ce nom est standardis par le langage CSS suivi d un deux points et d une ou plusieurs valeurs Ici nous voyons que la couleur est r gl e rouge et que la police de caract res doit tre affich e avec une taille de 18 pixels Important si vous ajoutez vos propres styles sachez que la valeur donn e l attribut class est totalement arbitraire Votre navigateur ne fera aucune diff rence que cet attribut soit nomm spip menu rubriques Oucheval321 La seule chose qui compte est que cette valeur corresponde bien la r gle que vous aurez nonc e dans votre feuille de style Comme vous le remarquerez le langage CSS est tr s simple et utilise le m me type de vocabulaire que les attributs HTML classiques Quand vous progresserez dans le langage des feuilles de style vous continuerez retrouver des notions plus ou moins h rit es du HTML traditionnel border width height La gestion du cache Le fait que votre feuille de style soit d finie dans un fichier s par le fameux mes_styles css aune cons quence importante En effet ce fichier au contraire de vos squelettes n est pas g r par SPIP il n en a pas besoin Cela signifie que si vous modifiez votre feuille de style vous n avez pas besoin de vider le cache de SPIP il suffit de recharger la page dans votre navigateur Cela rend le r glage de la mise en page encore plus ais Rappelons tout de
246. olice stencil ttf taille On peut pr ciser la taille d affichage de la police Cela s utilise avec la variable taille TITRE image _typo police stencil ttf HTME AHTME STANDARDS Note on ne pr cise pas 36pt on indique seulement 36 sans indication de l unit couleur http www spip net fr_article3325 html 2 of 6 2006 04 17 19 25 4 SPIP Images typographiques Cette variable permet d indiquer la couleur Par d faut le rendu est noir Cette variable est une couleur RVB hexad cimale toujours de la forme 3399BB Notez on omet le qui pr c de habituellement ce type de code couleur TITRE image _typo police stencil ttf largeur La variable largeur permet de fixer la largeur maximale de l image Notez bien c est une valeur maximale l image r elle est recadr e automatiquement ensuite pour adopter les dimensions du texte r ellement compos Le premier pav ci dessous est compos avec une largeur maximale de 300 pixels le second avec une largeur de 400 pixels TITRE image_typo police stencil ttf largeur 300 HEME AHTM L STANDARDS EME XITPNEE STANDARDS align La variable align permet de forcer l alignement de plusieurs lignes de texte lorsque c est le cas gauche droite ou au centre Exceptionnellement on utilise ici une syntaxe anglaise proche de ce qui se fait pour les feuilles de style http www spip net fr_article33
247. olution la plus simple est de demander SPIP dans la page d accueil de l espace priv de vous poser un cookie d administration Ce cookie s incrustera sur votre navigateur et SPIP vous reconna tra au moment de vous envoyer la page dans le site public il vous proposera alors en bas de page un bouton Recalculer cette page Retour au contexte On revient ici la notion de contexte Si le squelette est appel avec un contexte d id_article d id_ rubrique ou encore id_breve un autre bouton vous est propos quand SPIP d tecte le cookie Modifier cet article ou rubrique ou br ve qui vous m ne directement sur la page correspondante dans le back office Merci qui http www spip net fr_article886 html 2 of 3 2006 04 17 19 18 44 SPIP G rer le cache Derniers d tails pour des raisons videntes le moteur de recherche ne d clenche pas de cache et les pages avec forum sont r actualis es d s qu une nouvelle contribution est envoy e le r pertoire CACHE dans l arborescence du site est d coup en 16 sous r pertoires num rot s 0 1 2 9 A B F danslesquelsles fichiers cach s se distribuent quasi al atoirement cela s appelle hasher le cache et rien que pour cela m rite bien qu on le mentionne les fichiers cach s sont exploit s m me si la base de donn es est tomb e ce qui garantit le site contre des pannes transitoires du serveur mySQL 1 Pour les
248. omme sous option d une autre page elle est accessible directement videmment on a tent ici selon l habitude de SPIP de ne pas rendre plus confuse l interface pour les d butants en voulant faciliter le travail des utilisateurs confirm s La modification la plus visible par rapport aux versions pr c dentes depuis la version 1 4 est la disparition du second bandeau de navigation D sormais tous les l ments de ce second bandeau apparaissent en popup par survol des http www spip net fr_article3037 html 1 of 9 2006 04 17 19 24 22 SPIP SPIP 1 8 l interface graphique Le calendrier de SPIP 1 8 2 E Images typographiques m Couleurs automatiques m Traitement automatis des images m La structure de la base de donn es l ments principaux eux m mes r organis s selon des principes simplifi s comme un retour l interface de SPIP 1 0 Ainsi chacune des pages de ce second bandeau devient accessible en un clic depuis toutes les pages de l espace priv M P A suivre dition Forum Auteurs Tous vos articles Mots cl s Sites r f renc s Documents des rubriques nent en ligne Selon la m me logique le bandeau color accueille outre les options d interface couleur taille de l cran etc quelques popups r capitulant en permanence certaines informations utiles une navigation dans l int gralit de la hi rarchie d
249. ommuns toutes les boucles s appliquent Les balises de cette boucle Les balises tir es de la base de donn es Les balises suivantes correspondent aux l ments directement tir s de la base de donn es Vous pouvez les utiliser galement en tant que crit re de classement g n ralement par nom ID_AUTEUR affiche l identifiant unique de l auteur NOM retourne le nom de l auteur BIO retourne la biographie de l auteur EMAIL retourne son adresse email NOM_SITE le nom de son site Web URL_SITE l adresse URL de son site PGP sa cl publique pour PGP LANG est la langue de l auteur c est dire celle qu il a choisie dans l espace priv k FORMULAIRE_ECRIRE_ AUTEUR SPIP 1 4 affiche un formulaire permettant d crire l auteur Il faut que le serveur h bergeant le site accepte d envoyer des mails Ce syst me permet de ne pas divulguer l adresse email de l auteur http www spip net fr_article907 html 2 of 3 2006 04 17 19 11 16 SPIP La boucle AUTEURS Les balises calcul es par SPIP NOTES les notes de bas de page calcul es partir de l analyse du texte HURL_ AUTEUR l adresse de la page auteur php3 id_auteur Le logo LOGO_ AUTEUR le logo de l auteur ventuellement avec la gestion du survol Le logo s installe de la mani re suivante LOGO_AUTEUR alignement adresse SPIP 1 6 les variantes LOGO_AUTEUR_NORMAL et LOGO_AUT
250. oppement de SPIP Nommer Variables et fonctions Quel que soit le projet le nommage doit rester homog ne pour que le code soit facile lire Ainsi sous SPIP les noms de variables et de fonctions seront en minuscules les noms compos s de la forme variable composee D une mani re g n rale les noms seront ni trop brefs ni trop longs ile seront suffisamment explicites Cette r gle est particuli rement importante pour les variables globales qui peuvent tre partag es entre plusieurs fichiers et de nombreuses fonctions Pour les variables locales i e une fonction la r gle est plus souple Notamment on peut employer des variables d une lettre par exemple pour obtenir des expressions plus compactes Remarquer que dans tous les langages de programmation un certain nombre de lettres sont par tradition associ es certains usages exemples i j pour des compteurs de boucles n pour un d nombrement t pour un instant ou une dur e en secondes Ne pas d tourner ces conventions permet vos lecteurs d tre plus vite dans le bain Fichiers Pour des raisons historiques les fichiers inclure dans l espace public seront appel s inc fichier php3 Dans l espace priv ce sera ecrire inc fichier php3 noter le tiret bas la place du tiret normal Les fichiers de l espace public appel s par redirection HTTP depuis l espace priv sont appel s spip fichier php3 Tous les autres fichiers ont un
251. orums de l espace priv Q Q gt 1 Pr sentation et premiers pas 3 Guide de l utilisateur ar ed gt 4 Guide du webmestre et 2 du bidouilleur gt 5 Questions et r ponses ma Cr er une sous rubrique dans les squelettes les webmestres disposent d une fonction reduire_image particuli rement utile pour contr ler sa mise en page et cr er diff rentes versions de diff rentes tailles d une m me image Nous ne pouvons qu encourager les webmestres jouer avec cette fonction pour enrichir et contr ler leur interface graphique on en tirera avantage pour obtenir e des alignements d images parfaits par exemple toutes les images de la m me largeur sans s obliger installer des images de dimensions pr d finies e la garantie de ne pas faire exploser sa mise en page lorsqu une image trop grande est install e par un r dacteur http www spip net fr_article3024 html 2 of 5 2006 04 17 19 23 5 SPIP Le traitement des images e des effets de survol et d animation r alis s simplement en utilisant la m me image des tailles diff rentes sans devoir jouer avec les logos de survol e des interfaces de portfolios galeries de photos patantes Mais pour r aliser ces op rations de traitement d images SPIP fait appel des syst mes qui ne peuvent pas tre install s automatiquement avec SPIP mais doivent tre pr sents sur
252. ossier CACHE 5 Le r sultat est sauvegard dans un fichier en cache puis envoy l utilisateur mySQL L Le fichier appel est doncarticle php3 avec en param tre id_article 5 2 Lefichier article php3 est un fichier PHP sa premi re t che consiste v rifier dans le dossier CACHE sur votre serveur s il existe d j un fichier correspondant cet article 2bis Si un tel fichier existe dans CACHE article php3 v rifie sa date de cr ation Si ce fichier est suffisamment r cent il le retourne directement l utilisateur Le processus de consultation est alors termin 3 S il n existe pas un tel fichier dans CACHE premi re visite sur cet article par exemple ou si son ge est trop ancien SPIP d marre le calcul de cette page 4 C est alors la page article html qui est charg e et analys e Cette page contient la mise en page correspondant ce type de document Il s agit de HTML compl t d indications permettant de placer les l ments tir s de la base de donn es En fonction des l ments requis par article html SPIP va chercher les informations n cessaires tir es de la base de donn es mySQL et les ins rer aux endroits pr vus 5 Un fichier est ainsi fabriqu par article php3 partir de la description contenue dans article html avec les l ments tir s de la base de donn es Ce fichier est alors sauvegard dans le dossier CACHE et renvoy au visiteur http www spip net fr
253. ossier squelettes af F peri http www spip net fr_article1591 html 3 of 3 2006 04 17 2 23 19 SPIP FAQ webmestre m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur FAQ webmestre mfran ais mec catal mDeutsch wm English m Espa ol mitaliano m T rk e m S curit Les bases SPIP et IIS m Qu est ce lues L Comment fais je pour modifier la mise en page du site public IST x FAQ P sag z webmestre La gestion de la mise en page s appuie sur des fichiers l extension htm1 appel s m Rapidit du squelettes de mise en page Leur r le correspond grosso modo ce que d autres site public logiciels nomment mod les gabarits ou en anglais templates E Contribuer a bent Chaque fichier est associ un type de page diff rent ainsi un squelette pour le de SPIP sommaire un pour l affichage des articles un pour l affichage des rubriques etc Un squelette contient du HTML standard d finissant l habillage de la page dans lequel on ins re des codes sp cifiques SPTP afin de d finir quelles informations vont venir habiter cet habillage Le langage des squelettes de SPTP est tr s souple et permet de r aliser des mises en page tr s vari es un simple coup d oeil uZine Vacarme Hacktivist News Service ainsi que les sites enregistr s par leurs cr ateurs sur cette page saura vous
254. oucle afficher les auteurs de cet article devient successivement afficher les auteurs du premier article du deuxi me article et ainsi de suite On voit que par l imbrication de boucles successives on obtient diff rentes boucles incluses les unes dans les autres qui d pendent du r sultat des boucles dans lesquelles elles sont situ es Et finalement la toute premi re boucle celle qui contient toutes les autres d pend d un param tre fix dans l adresse de la page Boucles incluses et boucles successives Si l on peut inclure des boucles les unes l int rieur des autres chaque boucle incluse d pendant alors du r sultat de la boucle l int rieur de laquelle elle est install e on peut tout aussi bien installer des boucles les unes la suite des autres des boucles successives n influent pas les unes sur les autres Par exemple la page d une rubrique est typiquement constitu e des l ments suivants lt BOUCLE_rubrique RUBRIQUES id_rubrique gt lt ul gt Titre de la rubrique lt BOUCLE_articles ARTICLES id rubrique gt lt li gt Titre d l article lt li gt lt BOUCLE articles gt lt BOUCLE_sous_rubriques RUBRIQUES id_rubrique gt lt li gt Titre de la sous rubrique lt li gt lt BOUCLE_sous_rubriques gt lt ul gt lt BOUCLE_rubrique gt lt ul gt Il n y a pas de rubrique cette adresse lt ul gt lt B_rubrique gt La premi re boucle BOUC
255. oucle RUBRIQUES Le contexte de la boucle ARTICLES estl id_rubrique donn par la boucle RUBRIQUES qui elle m me va chercher le contexte donn par l URL id_rubrique 1 Donc nous sommes bien au niveau des ARTICLES avecl id_ rubrique demand De ce point de vue rien ne change En revanche la boucle RUBRIQUES a permis SPIP de s lectionner les valeurs des champs de la rubrique en question on peut donc afficher le TITRE et le TEXTE de cette rubrique Notez bien que ce TEXTE serait celui de la rubrique m me si on appelait aussi TEXTE dans la boucle ARTICLES Le fonctionnement arborescent de SPIP garantit que le TEXTE d un article ne d borde pas de la boucle ARTICLES Derni re remarque on a introduit un filtre justifier sur le champ TEXTE Ce filtre modifie le contenu du texte avant de l installer dans la page finale Ca vous fait saliver Sa AMen http www spip net fr_article883 html 2 of 2 2006 04 17 19 18 34 SPIP G rer le cache m Mon premier squelette m Un squelette plusieurs articles m Une rubrique m Boucles en boucles m G rer le cache m Des filtres m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m SPIP pas pas G rer le cache m catal m Deutsch m italiano m Portugu s E fran ais m English m Espa ol Dans les le ons pr c dentes nous avons commenc laborer des squelettes Le
256. oucles Le squelette des r sultats Les boucles permettant d afficher les r sultats de la recherche sont en r alit des boucles d j abord es ici ARTICLES RUBRIQUES BREVES Vous pouvez en effet m Les balises effectuer des recherches non seulement sur les articles mais aussi sur les propres au site rubriques et les br ves m Les formulaires a HR de ja seule diff rence par rapport ce qui est document sur les pages de ces a Les filtres de boucles est le choix du crit re de s lection qui doit tre recherche Les SPIP crit res d affichage et les balises de ces boucles sont inchang es m Les boucles recursives Cependant afin de classer les r sultats par pertinence on utilisera de pr f rence m La popularit SaS d ce nouveau crit re d affichage par points es articles m La gestion des dates Enfin on pourra utiliser la balise POINTS qui indique la pertinence des m Exposer un r sultats attention dans l absolu cette valeur n est pas tr s explicite elle est zi dansune surtout utile pour le classement des r sultats Iste Pour afficher la requ te formul e par le visiteur on peut utiliser la balise RECHERCHE SPIP 1 5 1 CRE http www spip net fr_article903 html 2 of 2 2006 04 17 19 13 56 SPIP Les filtres de SPIP E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES
257. ourne la liste des articles contenus dans la rubrique id_ rubrique id _secteur retourne les articles dans ce secteur un secteur est une rubrique qui ne d pend d aucune autre rubrique c est dire situ e la racine du site SPIP 1 4 branche le crit re branche retourne l ensemble des articles de la rubrique ET de ses sous rubriques C est une sorte d extension du crit re id_secteur Toutefois l inverse de id_secteur 2 il n est pas possible d appeler directement une branche en faisant par exemple branche 2 techniquement parlant il faut que la rubrique en question figure dans le contexte courant Ce crit re est utiliser avec parcimonie si votre site est bien structur vous ne devriez pas en avoir besoin sauf dans des cas tr s particuliers id_auteur retourne les articles correspondant cet identifiant d auteur utile pour indiquer la liste des articles crits par un auteur id_ mot retourne les articles correspondant cet identifiant de mot cl utile pour indiquer la liste des articles traitant d un sujet donn p SPIP 1 3 titre mot xxxx OU type mot yyyy retourne les articles li s au mot cl dont le nom est xxxx ou li s des mots cl s du groupe de mots cl s yyyy Attention on ne peut pas utiliser plusieurs crit res titre mot xxxx OU type mot yyyy dans une m me boucle SPIP 1 4 id groupe zzzz permet de s lectionner les articles li
258. ous ma trisons la structure de nos propres squelettes il n est pas utile de rendre la feuille de style tr s restrictive Toujours est il que cette feuille de style a le r sultat voulu les paragraphes du corps de texte s affichent avec une indentation ceux du post scriptum dans une fonte plus petite et sans indentation Pour v rifier que ces r gles s appliquent bien chacun des paragraphes lt p class spip gt etnonau lt div class gt englobant on peut s amuser d finir un cadre noir texte p spip border 1px solid black http www spip net fr_article2332 html 5 of 6 2006 04 17 19 29 18 SPIP Une typographie personnalis e On note que chaque paragraphe du corps de texte mais pas du post scriptum est entour de son propre cadre noir Si on avait simplement crit texte au lieu de texte p spip c est le texte tout entier qui serait entour d un unique cadre noir englobant Remarquons en passant l apparition de la propri t border Note cette astuce consistant tracer un cadre de couleur pour savoir quels l ments s applique pr cis ment une r gle peut tre tr s utile quand votre feuille de style s enrichit N h sitez pas l utiliser si vous commencez perdre pied Cette m thode est tr s puissante et se g n ralise avec profit pour la structuration de votre mise en page 1 Que les amateurs de liens ouvrants ne se r jouissent pas trop vite il est impossible da
259. ouve la texte longblob Pace du site k DST CETTE titre descriptif texte parlent d eux m mes n g id_secteur est l id rubrique de la rubrique en t te hl timestamp 14 dela hi rarchie contenant cette rubrique Une rubrique export varchar 10 d pend d une rubrique qui d pend d une rubrique id import bigint 20 jusqu une rubrique plac e la racine du site c est cette derni re rubrique qui d termine l id_ secteur Cette valeur pr calcul e permet d acc l rer certains calculs de l espace public en effet les br ves sont class es par secteur uniquement et non selon toute la hi rarchie maj est un champ technique mis jour automatiquement par MySQL qui contient la date de la derni re modification de l entr e dans la table export id_ import sont des champs r serv s pour des fonctionnalit s futures Les articles spip_ articles id_article bigint 21 Chaque article est identifi par son id_ article surtitre text id_ rubrique indique dans quelle rubrique est titre text rang l article soustitre tort id_ secteur indique le secteur correspondant la rubrique susmentionn e voir le paragraphe CELL E s pr c dent pour l explication de la diff rence entre descriptif text les deux chapo mediumtext p titre surtitre soustitre descriptif chapo texte longblob texte ps parlent d eux m mes ps mediumtext date est la date de publication de l article si date date
260. p_url a spip_in concerne les liens l int rieur de votre propre site Par exemple Ceci est un lien interne gt article1177 a spip_out concerne les liens vers l ext rieur de votre site Par exemple Ceci est un lien externe gt http www uzine net a spip_ur1 traite les adresses URL transform es en lien hypertexte Par exemple http www spip net fr_article1177 html 2 of 8 2006 04 17 19 21 0 SPIP Spip et les feuilles de style gt http www uzine net ce raccourci affiche directement l URL avec un lien hypertexte vers cette adresse ainsi http www uzine net Le principal int r t de ces trois styles diff rents est de permettre de diff rencier graphiquement les liens internes au site et les liens vers d autres sites Les intertitres Lesintertitres cr s par le raccourci suivant Un intertitre peuvent tre d finis par le style h3 spip Ce style est sans doute l un des plus importants car il permet de d finir la taille la police et le positionnement des intertitres dans les articles vous serez certainement amen s le modifier en fonction de vos choix graphiques et typographiques Par d faut la d finition en est h3 spip font family Verdana Arial Helvetica sans serif font weight bold font size 120 text align center margin top 2em margin bottom 1 5em naddina Nan Notez en particulier les attributs margin et padding q
261. page avec l url article php3 id_article 25 amp var mode recalcul la balise SELF retournera article php3 id_article 25 Par exemple pour faire un formulaire lt form action SELF method get gt Remarque la balise SELF repr sentant l adresse de la page elle n est pas compatible avec les lt INCLURE gt sauf si le delais del inclusion est mis 0 HENV xxxx 777Z partir de SPIP 1 8 permet d acc der la variable de nom xxxx pass e par la requ te HTTP zzzz est une partie optionnelle qui permet http www spip net fr_article1902 html 3 of 4 2006 04 17 19 13 23 SPIP Les balises propres au site de retourner une valeur m me si la variable xxxx n existe pas Par d faut la balise ENV est filtr e par htmlspecialchars Si on veut avoir le r sultat brut l toile peut tre utilis e comme pour les autres balises HENV xxxx Par exemple pour limiter la liste d auteurs affich s lt BOUCLE_auteurs AUTEURS nom Retourne la liste d auteur ayant le nom correspondant l expression r guli re pass dans l url par la variable lettre 1iste_auteur php3 lettre Z ou les auteurs qui ont un nom commen ant par un A s il n y a pas de variable dans l url La balise SPIP_ CRON introduite par SPIP 1 8 est li e la gestion par SPIP des calculs qu il doit faire p riodiquement statistiques indexation pour le moteur de recherche syndication de sites etc
262. pects de configuration Vous devrez ensuite tester la validit de ces adresses en appelant la page Voir en ligne sur un article un auteur une br ve une rubrique etc G n rer les URLs apparentes dans les pages SPIP Afin d afficher partout les URLs du type choisi utilisez dans vos squelettes les balises URL_ARTICLE URL_ RUBRIQUE URL_BREVE etc Transition d un type d URLSs l autre Depuis SPIP 1 8 1 tout est pr vu pour que la transition d un type d adresses l autre se fasse en douceur installez le fichier htaccess txt et vous pouvez ensuite librement basculer des adresses standard aux adresses propres2 propres ou html et vice versa sans jamais provoquer d erreur 404 pour les visiteurs ou les moteurs de recherche qui auraient m moris les anciennes adresses Dernier d tail pour faciliter la transition si vous choisissez les URLs propres ou propres2 les visites des pages portant les anciennes adresses standard ou html sont redirig es automatiquement vers les nouvelles adresses 1 Remarque les versions pr c dentes de SPIP incluaient le fichier inc urls php3 la racine du site s il tait pr sent cette m thode est encore valable mais est consid r e http www spip net fr_article765 html 3 of 4 2006 04 17 19 21 50 SPIP Utiliser des URLs personnalis es comme obsol te al http www spip net fr_article765
263. pensez supprimer ces deux lignes et essayez d installer Tidy selon la m thode suivante ou demandez la personne responsable de votre h bergement de le faire Vous pouvez installer une version d j compil e de Tidy correspondant votre syst me On trouvera ces versions sur le site officiel de Tidy il en existe pour Linux divers BSD MacOS X etc D compressez l archive t l charg e et installez le fichier tidy sur votre site V rifiez les droits d ex cution de ce fichier sur le serveur si n cessaire passez http www spip net fr_article3070 html 3 of 7 2006 04 17 19 22 38 SPIP Tidy validation XHTML 1 0 les droits en 777 Si vous avez un acc s SSH votre serveur vous pouvez tester le programme directement depuis le terminal Si vous n avez pas un tel acc s rien de grave passez aux tapes suivantes sachant que vous serez plus d muni si cela ne fonctionne pas du premier coup Configurez l acc s ce fichier en indiquant le chemin d acc s en le d finissant ainsi define _TIDY_COMMAND usr bin tidy xhtml true Si le chemin indiqu dans _TIDY__COMMAND est correct alors Tidy sera d clench lors des affichages des pages de votre site public Important La d finition de_TIDY_COMMAND doit se trouver dans ecrire mes_options php3 et non la racine du site dans mes_fonctions php3 Cela est d au fonctionnement assez sp cifique du syst
264. pip et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue E Internationaliser les squelettes m Utiliser des URLS personnalis es m Le moteur de recherche Les variables de personnalisation m Tidy validation XHTML 1 0 m Le support LDAP Le traitement des images m Ins rer des formules math matiques en LaTEX m SPIP 1 8 l interface graphique m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es SPIP 1 8 l interface graphique E fran ais mcatal m English mEspa ol mitaliano L interface graphique de l espace priv a t dans la version 1 8 largement remani e Au d l de l aspect purement graphique de l interface qu il est inutile de d tailler nous pr sentons ci dessous quelques uns des l ments d ergonomie introduits destin s faciliter le travail la fois des utilisateurs d butants et des utilisateurs confirm s The Un seul click interface for the SPIP user L une des principales t ches effectu es sur cette version a consist tenter de r duire le nombre de clics n cessaires pour acc der aux diff rentes pages Il est destin la fois aux utilisateurs confirm s ils gagnent du temps mais aussi aux utilisateurs d butants en rendant visible toutes les informations n cessaires telle page n est pas cach e c
265. pl t es et plus puissantes SPIP utilise le traitement d images de trois mani res diff rentes la cr ation de vignettes de pr visualition pour les images install es comme documents joints cela tait d j pr sent dans la version 1 7 SPIP 1 8 permet de plus dans ces portfolios de faire subir chaque image une rotation 90 cela est particuli rement int ressant lorsqu on installe une s rie de photographies depuis un appareil photo num rique http www spip net fr_article3024 html 1 of 5 2006 04 17 19 23 5 SPIP Le traitement des images graphique m Le calendrier de SPIP 1 8 2 E Images typographiques m Couleurs automatiques m Traitement automatis des images m La structure de la base de donn es PORTFOLIO gt 001 IMG_9282 jpg 612 462 panels gt 004 IMG_9283 jpg 612 462 pixels 274 27 271 gt 002 IMG_1064 jp9 462 x 612 pixels ETAT S nam gt 005 IMG_9284 jp9 617 x 462 pixels 27 gt 003 IMG_L065 JpQ 462 x 612 ph ls 271 275 gt 006 IMG_L066 jpg 6L2 x 462 phoels 27 de nombreux endroits dans l espace priv l affichage de vignettes destin es illustrer la navigation partir des logos des articles des rubriques et m me des auteurs par exemple si l on dote les participants un site de logos d auteurs des vignettes de ces logos accompagneront tous les messages de ces auteurs dans les f
266. police plus lisse sans empattements et plus petite sans indentation Cette op ration est en r alit tr s simple Il faut d abord modifier votre squelette afin d introduire les l ments qui permettront de discriminer le texte et le post scriptum Cela prendra par exemple l int rieur de la boucle ARTICLES principale la forme suivante http www spip net fr_article2332 html 4 of 6 2006 04 17 19 29 18 SPIP Une typographie personnalis e lt div class texte gt fTEXTE lt div gt lt div class ps gt PS lt div gt Il faut ici recalculer la page car on a modifi le HTML L affichage du navigateur est toujours le m me normal nos nouveaux styles ne faisant l objet d aucune r gle dans la feuille de style ils sont ignor s par le navigateur Rem dions y texte p spip font family Times New Roman serif text indent 50px p5 Pp Spip font family Tahoma Arial sans serif font size 90 La grande nouveaut ici ne r side pas dans les propri t s graphiques mais dans la fa on dont on les applique au code HTML En effet texte p spip signifie cette r gle s applique tous les tags lt p class spip gt qui sont contenus dans un tag ayant un attribut class gal texte On pourrait restreindre un peu cette r gle en sp cifiant que le tag parent doit en plus tre un tag lt div gt le d but de la r gle s crirait alors div texte p spip mais comme n
267. pour la gestion automatique du changement d image lors du survol avec la souris gt LOGO DE L ARTICLE 7 gt LOGO POUR SURVOL Le logo normal Le logo est install classiquement A priori il s agit d une image de taille modeste e en bas de la page de l article nous installons un document joint par le pav J OINDRE UN DOCUMENT pour faire simple installons une image J PEG GIF PNG une fois ce document install upload nous lui donnons pour titre spip _ logo Voil c est la seule manip n cessaire SPIP affiche ce document en bas de la page de l article dans l espace priv en donnant son titre spip logo et en indiquant ses dimensions en pixels http www spip net fr_article2001 html 3 of 10 2006 04 17 19 32 21 SPIP Plusieurs logos pour un article co Y Document spip_logo JPEG 11 1 ko Titre du document spip_logo Description Dimensions 198 xj300 pixels hss xfho Valider Le document spip_logo Le seul imp ratif est de donner ce document le titre spip_logo Il est inutile d installer une vignette de pr visualisation Dans le cas d un document multim dia Flash Shockwave il faut indiquer la main ses dimensions en pixels Nous d cidons de l usage de ce document intitul spip logo il sera affich sur la page d accueil du site la place du logo normal du dernier article publi De cette f
268. preserver permet d interdire ces affichages flag_preserver true On verra par exemple l utilisation de cette variable dans backenda php3 Le dossier des squelettes SPIP 1 5 Si l on souhaite mettre les squelettes de son site dans un dossier particulier par exemple pour faire des essais de diff rents jeux de squelettes trouv s sur Internet ou parce qu on aime que les choses soient bien rang es etc il est possible de fixer dansmes_fonctions php3 la variable Sdossier_ squelettes lt php GLOBALSfl dossier_ squelettes design partir de ce moment l SPIP ira chercher en priorit les squelettes pr sents dans le dossier des ign que vous aurez cr la racine du site Si de plus vous utilisez lt INCLURE xxx php3 gt SPIP ira chercher le fichier xxx php3 d abord dans design puis s il n y figure pas la racine du site Les avantages de ce rangement peuvent sembler vidents meilleure s paration du code de spip et de la structure du site possibilit de changer tout un ensemble de squelettes d un seul coup etc l inconv nient principal est qu il sera plus difficile de visualiser les squelettes via un simple navigateur En effet m me s ils http www spip net fr_article1825 html 4 of 6 2006 04 17 19 22 25 SPIP Les variables de personnalisation sont situ s dans ce sous dossier l HTML contenu dans ces fichiers de squelette doit tre con u comme s ils taient la
269. qu plus haut les squelettes http www spip net fr_article2124 html 3 of 8 2006 04 17 19 21 27 SPIP R aliser un site multilingue doivent bien pouvoir en tenir compte dans l affichage du site L Une bonne nouvelle pour commencer le multilinguisme des squelettes est pour la plus grande part totalement naturel il n est pas n cessaire de faire des squelettes diff rents pour afficher des articles de langues diff rentes Un m me squelette adapte automatiquement son affichage la lange courante Ainsi tous les l ments affich s autour et dans un article d une langue donn e seront affich s dans cette langue Cela concerne aussi bien la date de publication de l article que les formulaires de r ponse au forum de signature d une p tition etc Plus g n ralement toute balise SPIP incluse dans une boucle ARTICLES sera affich e dans la langue de l article de m me pour les rubriques et les br ves Exemple si votre page d accueil contient un sommaire affichant les dix derniers articles publi s ainsi que leur date de publication la date des articles en vietnamien s affichera en vietnamien celle des articles en cr ole de la R union s afficheront en cr ole de la R union etc Note ce fonctionnement suppose que la langue de l article fait l objet d une traduction dans SPIP Ainsi si un article est crit en volap ck mais que votre version de SPIP n est pas encore traduite en volap ck nous vous
270. qu aucune protection n est inviolable http www spip net fr_article2628 html 3 of 3 2006 04 17 2 23 9 SPIP Qu est ce que les fichiers dist m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur Qu est ce que les fichiers dist mfran ais mec pOEAIrapckyu m catal mDeutsch mEndglish m Espa ol mitaliano W occitan m S curit Comme vous le savez s rement d j sinon lisez le tutorial ou le manuel de apola r f rence le syst me de squelettes est bas sur des fichiers htm1 contenant la que les pr sentation graphique du site Par exemple article html pr sente les Ap articles rubrique html pr sente les rubriques m FAQ webmestre Or nous avons remarqu que fr quemment les utilisateurs qui manipulaient leur m Rapidit du site public en modifiant ces fichiers htm1 fournis avec SPIP rencontraient des site public probl mes lors des mises jour s ils n avaient pas pris leurs pr cautions en m Contribuer sauvegardant les fichiers modifi s au d veloppement PRAE de SPI En effet en r installant tous les nouveaux fichiers livr s avec SPIP ils crasaient purement et simplement leurs fichiers modifi s oubliant de faire une copie de sauvegarde de leurs modifications Depuis SPIP 1 8 les fichiers htm1 sont mieux rang s Un r pertoire dist est destin aux fichiers fournis avec la distribu
271. que 3 Th oriquement le HTML devrait r gler tous ces d tails automatiquement mais le r sultat n est pas toujours la hauteur surtout lors des passages la ligne ou si l on m lange des langues utilisant un sens d criture diff rent http www spip net fr_article2124 html 7 of 8 2006 04 17 19 21 27 SPIP R aliser un site multilingue 4 Malheureusement les instances de normalisation semblent pour l instant ignorer le boustroph don ce qui emp che son utilisation en HTML 5 Tous ou presque tous nous vous laissons d couvrir si votre mise en page pr sente des cas particuliers http www spip net fr_article2124 html 8 of 8 2006 04 17 19 21 27 SPIP Internationaliser les squelettes m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es Internationaliser les squelettes m fran ais mec catal mDeutsch mEndglish mEspa ol mitaliano L internationalisation des squelettes abord e dans cet article est disponible partir de SP P 1 7 ue les feuilles Pourquoi cr er des squelettes multilingues e style m lt INCLURE gt d autres squelettes D s la mise en ligne de documents SPIP adapte certaines informations A RG uiy emie automatiques dans la langue d sir e Notamment les dates sont affich es dans E a la langue du site ou d un article ou d une rubrique les formulaires sont affich
272. r lignes dans un tableau Ne pas afficher les articles publi s depuis plus d un an a Pr senter les r sultats d une recherche par secteurs Afficher le nombre de messages du forum li un article z Un menu d roulant pour pr senter une liste d articles http www spip net fr_rubrique172 html 1 of 2 2006 04 17 19 31 39 SPIP Trucs et astuces site a Remplir les meta tags HTML des pages d article m La boucle ARTICLES m SPIP 1 8 3 m Les filtres de SPIP m Traitement automatis des images m Images typographiques http www spip net fr_rubrique172 html 2 of 2 2006 04 17 19 31 39 SPIP Afficher automatiquement selon la date ou selon un ordre impos m Afficher automatiquement selon la date ou selon un ordre impos a Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier m Plusieurs logos pour un article m Afficher les derniers articles de vos r dacteurs par rubrique m Afficher des l ments par lignes dans un tableau m Ne pas afficher les articles publi s depuis plus d un an m Pr senter les r sultats d une recherche par secteurs m Afficher le m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Trucs et astuces Afficher automatiquement selon la date ou selon un ordre impos m catal mEnglish m Espa ol E fran ais meccccce E italiano La situation est la suivante dans un
273. r squelette je le sors du placard Comment crire un premier squelette qui marchouille Un squelette plusieurs articles fran ais c est a que a sert O tour l Et Et voici le premier contexte a Une rubrique ou comment faire des listes du contenu de la base Faire des listes avec une boucle SPIP Boucles en boucles Modifications r centes plusieurs niveaux de lecture m Le calendrier de SPIP Affichons sur une m me page des l ments en 1 02 provenance de plusieurs endroits a ras a G rer le cache m Principe g n ral et viter de faire ramer le serveur qui n a pas que a m lt INCLURE gt d autres faire http www spip net fr_rubrique144 html 1 of 2 2006 04 17 19 17 47 SPIP SPIP pas pas squelettes Le cache ou comment faire un site dynamique qui ne m Les balises propres au bouge pas trop site a Des filtres m La boucle ARTICLES Subtilit s squelettiques Les filtres transforment le contenu de la base de donn es en code HTML pr sentable m SPIP 1 8 3 m Les filtres de SPIP m Traitement automatis des images m Images typographiques http www spip net fr_rubrique144 html 2 of 2 2006 04 17 19 17 47 SPIP Mon premier squelette m Mon premier squelette m Un squelette plusieurs articles m Une rubrique m Boucles en boucles m G rer le cache m Des filtres m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du
274. r un mode de stockage sp cifique aux besoins de la recherche Par exemple le score de chaque mots d un article peut tre stock directement afin d tre facilement retrouv et d avoir le score total d une recherche par une simple addition L avantage est que la recherche est tr s rapide presque aussi rapide que n importe quel calcul de page L inconv nient est qu il faut une phase de construction du dit stockage des informations cela s appelle l indexation L indexation a un co t en termes de ressources temps de calcul et espace disque et elle introduit galement un l ger d calage temporel http www spip net fr_article996 html 1 of 4 2006 04 17 19 22 8 SPIP Le moteur de recherche m Le traitement des images E Ins rer des formules math matiques en LaTEX m SPIP 1 8 l interface graphique m Le calendrier de SPIP 1 8 2 Em Images typographiques m Couleurs automatiques m Traitement automatis des images m La structure de la base de donn es entre l ajout ou la modification d un contenu et la r percussion de cet ajout ou de cette modification sur les r sultats de recherche D autre part dans le cas de SPIP nous sommes oblig s d utiliser PHP et MySQL comme pour le reste du logiciel ce qui ne permet pas de r aliser un moteur tr s performant en termes de rapidit mais aussi de pertinence ou d enrichissements divers indexation de documents ext rieurs au site cr ation de champs s m
275. r_article91 1 html 2 of 3 2006 04 17 19 12 19 SPIP La boucle SYNDIC_ARTICLES DATE est la date de publication de cet article HLESAUTEURS les auteurs de l article syndiqu HDESCRIPTIF le descriptif de l article syndiqu NOM SITE est le nom du site syndiqu contenant cet article HURL SITE est l adresse URL du site http www spip net fr_article91 1 html 3 of 3 2006 04 17 19 12 19 SPIP La boucle SIGNATURES E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle VEUT la Me ni m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La boucle SIGNATURES m fran ais m catal mDeutsch mEnglish m Espa ol mitaliano La boucle SIGNATURES retourne une liste de signataires d une p tition associ e un article lt BOUCLEn SIGNATURES crit res gt Les crit res de s lection On utilisera l un ou autre des crit res suivants pour indiquer comment on s lectionne les l ments tout toutes les signatures sont s lectionn s dans l int gralit du site id signature la signature correspondant l identifiant courant id_article retourne le
276. racine Ainsi les liens vers les images ou les CSS notamment risquent de casser Exemples Pour modifier des variables uniquement pour un certain type de squelettes par exemples pour les pages de rubriques il suffit de les d finir dans le fichier d appel de ces squelettes Par exemple pour les rubriques on peut fixer des valeurs directement dans rubrique php3 lt php fond rubrique delais 2 3600 espace_logos 20 include inc public php3 Ici on a modifi la valeur de l espace autour des logos Pour modifier des valeurs de variables pour l ensemble du site on peut les d finir dans le fichier mes_fonctions php3 Attention lorsqu on d finit des valeurs dans ce fichier il faut imp rativement utiliser la syntaxe GLOBALS xxx pour chacune des variables personnaliser Par exemple pour d finir la valeur de debut_intertitre on utilise la syntaxe GLOBALS debut_intertitre L utilisation de cette syntaxe est impos e par des imp ratifs de s curit des sites lt php GLOBALS debut_intertitre lt h3 class mon_style_h3 gt GLOBALS fin_intertitre lt h3 gt GLOBALS ouvre_ref amp nbsp GLOBALS ferme_ref GLOBALS ouvre_note GLOBALS ferme_note AALAD ALOL l Na http www spip net fr_article1825 html 5 of 6 2006 04 17 19 22 25 SPIP Tidy validation XHTML 1 0 m Spip et les feui
277. rche ARTICLES lang Des squelettes internationaux pour un site massivement multilingue Ce qui pr c de nous a permis de rendre multilingue la partie proprement SPIP de notre squelette tout ce qui est issu des boucles s affiche dans le bon sens avec la bonne typographie et les l ments produits par SPIP formulaires dates sont dans la langue demand e Pour un site pr sentant un nombre modeste de langues bilingue par exemple ou pour lequel il existe une langue principale et quelques langues annexes on pourrait en rester l Les textes fig s pr sents dans les squelettes c est dire les mentions crites directement dans le HTML comme Plan du site Espace de r daction R pondre ce message peuvent dans certains cas rester dans une seule langue ou alors un site bilingue pourra utiliser des squelettes s par s pour chacune des deux langues http www spip net fr_article2124 html 6 of 8 2006 04 17 19 21 27 SPIP R aliser un site multilingue Cependant si vous voulez r aliser et g rer efficacement un site pr sentant beaucoup de langues part enti re il devient illusoire de maintenir des squelettes s par s ou d imposer une navigation dans une langue unique m me en anglais ou en esp ranto Pour r aliser un jeu de squelettes unique fonctionnant dans toutes les langues il faut internationaliser les squelettes afin de modifier les textes ind pendamment du code HTML qui les conti
278. re d un article que dans le corps du texte ou le post scriptum Les fonctions d indexation peuvent tre tudi es au sein du fichier ecri re inc_index php3 Pour mieux visualiser la dynamique d indexation du site vous pouvez ouvrir le fichier ecrire data spip 1og ou encore regarder la page ecrire admin_index php3 nota cette page encore exp rimentale n est pas livr e avec toutes les versions de SPIP et n existe qu en fran ais Dans la version SPIP 1 6 d importantes modifications ont t apport es au comportement du moteur http www spip net fr_article996 html 2 of 4 2006 04 17 19 22 8 SPIP Le moteur de recherche meilleur comportement dans un environnement multilingue le tiret bas underscore n est plus consid r comme un s parateur de mot mais comme un caract re alphab tique utile pour de la documentation informatique les mots de deux lettres et plus ne contenant que des majuscules et des chiffres sont consid r s comme des sigles et sont index s ce qui supprime l un des principaux inconv nients de la limitation de l indexation aux mots de plus de 3 lettres G8 CNT ONU sont d sormais index s La recherche La recherche s effectue simplement en s parant le texte de recherche en ses diff rents mots le m me filtre est appliqu que lors de l indexation suppression des mots de trois lettres ou moins sauf sigles et translitt ration Pour chaque contenu recherch le
279. rique de base pour restreindre l acc s certains contenus sur le site public mais cela reste d un maniement complexe et n cessitera encore des d veloppements et la r daction de tutoriels complets avant d tre facilement utilisable par tous n anmoins un exemple d utilisation avanc e est donn plus bas Le LOGIN_PUBLIC par d faut boucle sur lui m me c est dire que le formulaire revient sur la page o il se trouve On peut cependant indiquer une page vers laquelle le formulaire m nera sous la forme LOGIN_ PUBLICImapage php3 Si votre site offre une inscription automatique l espace priv les donn es de connexion l espace public sont identiques celles de l espace priv c est dire que les donn es envoy es l utilisateur pour s identifier l espace public lui permettent galement d acc der l espace priv Si au contraire vous avez interdit l inscription automatique l espace priv il faut imp rativement avoir au moins un article dont les forums seront r gl s en mode sur abonnement pour activer cette balise d s lors SPIP pourra fournir des informations de connexion pour le site public sans acc s l espace priv HURL_LOGOUT SPIP 1 5 est le pendant de LOGIN__PUBLIC il donne une URL permettant un visiteur authentifi de se d connecter SPIP 1 8 2 On peut passer un param tre cette balise pour sp cifier l adresse de retour apr s la
280. s e en dehors des boucles ARTICLES RUBRIQUES BREVES et AUTEURS retourne la langue principale du site LANG DIR LANG LEFT LANG RIGHT SP P 17 ces balises d finissent le sens d criture de la langue du contexte actuel par exemple de l article qu on est en train d afficher Voir l article R aliser un site multilingue pour plus d information MENU_LANG et MENU_LANG_ECRIRE SP P 1 7 affichent un menu de langues permettant au visiteur d obtenir la page en cours dans la langue choisie La premi re balise affiche la liste des langues du site la seconde la liste des langues de l espace priv elle est utilis e sur la page de connexion l espace priv Balises de mise en page HDOSSIER SQUELEMTTE SPIP 1 8 2 introduit cette balise pour pouvoir d velopper des squelettes facilement transportables et changeables Elle permet d obtenir le chemin du dossier dans lequel est install le squelette utilis On peut ainsi placer les fichiers accessoires feuille de style javascript etc au squelette dans le r pertoire du squelette et donc simplement distribuer ce dossier pour changer ses squelettes On crira donc par exemple pour inclure une feuille de style du r pertoire squelette lt link rel stylesheet PUCE SPIP 1 5 qui affiche devinez quoi FORMULAIRE_ADMIN SPIP 1 5 est une balise optionnelle qui permet de placer les boutons d administration recalculer cette pa
281. s note article html g re en r alit toutes les langues sauf l anglais Cette m thode est d conseill e si le site utilise de nombreuses langues et ou si on utilise des squelettes distincts selon les rubriques Par ailleurs elle est dans tous les cas avantageusement remplac e par la m thode 3 d crite ci dessous 3 la m thode des blocs multilingues introduite par SPIP 1 7 2 fonctionne aussi bien dans les contenus que dans les squelettes Il suffit de mettre dans le squelette la construction suivante lt multi gt fr R pondre cet article en Comment on this article lt multi gt et la phrase s affichera dans la langue voulue Si ce syst me est tr s souple il atteint toutefois ses limites d s que le nombre de langues est important et que l on souhaite que diff rents traducteurs interviennent dans le site il faut en effet qu ils puissent modifier le squelette ce que la m thode des fichiers de langue permet d viter 1 M thode des fichiers de langue Le principe des fichiers de langue consiste ins rer dans un squelette unique un code lequel correspondra dans chaque langue un l ment de texte une cha ne entre les diff rentes langues le code ne varie pas mais le texte est traduit http www spip net fr_article2128 html 2 of 9 2006 04 17 19 21 40 SPIP Internationaliser les squelettes Par exemple nous pouvons d cider que le codetelechargement correspond
282. s afficher les articles publi s depuis plus d un an m Pr senter les r sultats d une recherche par secteurs m Afficher le nombre de messages du forum li un article m Un menu d roulant pour pr senter une liste d articles m Remplir les meta tags HTML des pages d article lt php fond myauteur delais 24 3600 include inc public php3 2 Cr ation du fichier myauteur html Dans le fichier myauteur php3 mettre les codes suivants Juste apr s la balise lt body gt mettre lt BOUCLE_ principale AUTEURS id_ auteur Juste avant la balise lt body gt mettre lt BOUCLE_ principale gt Dans le corps de la page HTML voici le code installer on ne peut d terminer une rubrique car par d faut l auteur n est pas associ une rubrique mais un article le code peut parait biscornu mais on va donc retrouver la rubrique par rapport l article Code pour le dernier article lt B_appel_article gt Dernier article crit par lt BOUCLE nom _auteur AUTEURS id_auteur gt NOM lt BOUCLE nom auteur gt lt br gt lt BOUCLE _ appel _article ARTICLES id_auteur gt lt BOUCLE_ appel rubrique article RUBRIQUES id_rubrique par titre doublons gt TITRE majuscules lt ul gt lt BOUCLE_ rappel_article ARTICLES id_ rubrique par date inverse doublons 0 15 gt lt li gt lt a href URL ARTICLE gt http www spip net fr_article1561
283. s allons afficher une version graphique du titre de l article Il s agit d une image r alis e avec un logiciel de dessin o appara t avec une typographie particuli rement soign e effets de relief de d grad s de couleurs avec des polices de caract re exotiques le titre de l article D cr tons qu il s agira d un document joint associ l article que nous titrerons spip titre Pour appeler ce document l endroit o doit tre affich le TI TRE de l article installons la boucle d sormais connue lt BOUCLE_doc_titre DOCUMENTS id_article titre spip_titre gt EMBED DOCUMENT Notez nouveau que cette m thode permet non seulement d utiliser une image pour afficher le titre mais aussi une animation Flash un film Dans ces cas il vous faudra indiquer la main pour votre document joint quelles sont ses dimensions en pixels Compl tons le dispositif s il n existe pas de document joint portant le titre spip titre il faut afficher en tant que texte HTML classique les informations n cessaires lt BOUCLE doc titre DOCUMENTS id_article titre spip_titre gt EMBED DOCUMENT lt BOUCLE doc titre gt lt div gt SURTITRE majuscules lt div gt lt div gt lt font size 6 TITRE lt font lt div gt lt div gt SOUSTITRE majuscules lt div gt hr VHDA T Elnam ounl DATE Signalons un dernier avantage cette m thode Elle permet de faire
284. s applique qu au crit re de tri plac juste avant C est pourquoi SPIP 1 8 2 introduit la notation par qui inverse un crit re de tri en particulier Par exemple par date par num titre tri par date d croissantes puis par num ros croissants dans le titre pour les r sultats ayant la m me date Comparaisons galit s crit re lt valeur Comparaison avec une valeur fix e on peut utiliser gt lt gt lt Tous les crit res de classement tels que tir s de la base de donn es peuvent galement tre utilis s pour limiter le nombre de r sultats La valeur droite de l op rateur peut tre Une valeur constante fix e dans le squelette Par exemple lt BOUCLE_ art ARTICLES id_article 5 gt affiche l article dont le num ro est 5 utile pour mettre en vedette un article pr cis sur la page d accueil lt BOUCLE_art ARTICLES id secteur 2 gt affiche les articles du secteur num ro 2 partir de SPIP 1 8 une balise disponible dans le contexte de la boucle Par exemple lt BOUCLE_ art ARTICLES id_article 5 gt lt BOUCLE titre ARTICLES titre TITRE gt lt BOUCLE titre gt lt BOUICIE _art gt sert trouver les articles qui ont le m me titre que l article 5 Attention On ne peut utiliser q une balise simple Il n est pas permis de la filtrer ou de mettre du code optionnel http www spip net fr_article900 html 3 of 8
285. s de solution miracle mais n h sitez pas fixer un d lai d une journ e i e delais 24 3600 ou plus pour les articles et les rubriques Les pages de navigation les plus importantes peuvent avoir des delais plus courts vingt minutes ou une heure par exemple si votre site est cens r agir la validation fr quente de nouvelles br ves et de sites syndiqu s Si vous tes sur un serveur partag avec d autres sites soyez respectueux des autres et ne prenez pas tout le temps de calcul pour des pages qui changent rarement ce serait d autant plus idiot que sur les gros articles ou sur les sommaires le calcul des pages peut prendre quelques secondes ce qui ralentit la consultation de vos pages Comment provoquer une mise jour hors d lai Nous venons de d cider de delais extr mement longs et nous rep rons une f te d ortografe dans une page Correction dans l espace priv Comment effacer tout de suite cette vilaine cicatrice du site Depuis l espace priv cliquer sur Voir en ligne d clenche le recalcul pour les pages correspondant URL_ARTICLE OU URL_ RUBRIQUE de l article ou dela rubrique correspondante C est le cas le plus courant Mais sinon Dans la partie Sauvegarde Restauration de l espace priv un bouton vider le cache efface tous les fichiers cach s utile si vous faites plein de modifications et avez un site tr s complexe viter sinon Toutefois la s
286. s pouvez lister les cha nes disponibles depuis l espace priv allez dans la section Gestion des langues de la partie Administration du site puis cliquez sur l onglet Fichiers de langues Vous n avez plus qu y piocher les codes de votre choix pour la r alisation de vos squelettes http www spip net fr_article2128 html 3 of 9 2006 04 17 19 21 40 SPIP Internationaliser les squelettes e du site Qu Multilinguisme Fichiers de langue Vous pouvez ins rer les raccourcis suivants dans les squelettes de votre site pub seront automatiquement traduits dans les diff rentes langues pour lesquelles il fichier de langue Le fichier de langue public est disponible en 2A 6bnrapcky breton catal r yon Deutsch English Esperanto Espa ol Colombiano 2 fran ais fr_tu italiano Nederlands c auvernhat c lengadocian c ni ard oci_pro c proveng polski Portugu s Serbo Croatian Tatap Ti ng Vi t Raccourci Texte affich lt accueil_site gt Accueil du site lt articles gt Articles lt articles_auteur gt Articles de cet auteur lt articles_populaires gt Articles les plus populaires Les fichiers de langue dans l espace priv Exemple un webmestre veut r aliser l interface pour un site en fran ais en espagnol et en arabe mais il ne parle pas lui m me l espagnol et l arabe En ins rant dans ses squelettes les codes livr s avec SPIP il n a pas se souc
287. s signatures de la p tition de cet article http www spip net fr_article912 html 1 of 2 2006 04 17 19 12 30 SPIP La boucle SIGNATURES DOCUMENTS m La boucle SYNDIC_ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives E La popularit des articles m La gestion des dates m Exposer un article dans une liste Les crit res d affichage Les crit res communs toutes les boucles s appliquent Attention Dans ce type de boucles certains crit res de classement de la boucle ne sont pas identiques aux balises SPIP indiqu es ci dessous par nom email classe les r sultats selon le Nom du signataire k par ad email classe selon l EMAIL du signataire Les balises de cette boucle Les balises tir es de la base de donn es Les balises suivantes correspondent aux l ments directement tir s de la base de donn es Vous pouvez les utiliser galement en tant que crit re de classement g n ralement par titre HID_SIGNATURE affiche l identifiant unique du message ID_ARTICLE est l identifiant de l article pour cette p tition DATE est la date de publication HMESSAGE est le texte du message NOM est le nom de l auteur du message EMAIL est l adresse email de l auteur NOM SITE le no
288. score des diff rents mots est ensuite r cup r puis additionn afin d obtenir le score total Enfin les r sultats sont en g n ral affich s par ordre d croissant de score par points inverse c est dire de pertinence mais cela est laiss la volont de la personne qui crit les squelettes de mise en page Performances Rapidit Sur un serveur r cent et pas trop charg l indexation d un texte long plusieurs dizaines de milliers de caract res prendra entre une et deux secondes l attente est presque imperceptible compar e aux d lais de chargement via le r seau Les contenus courts sont index s de fa on quasi instantan e Bien s r ces affirmations doivent tre modul es selon la taille du site Un site vraiment tr s gros risque de voir les temps d indexation s allonger l g rement pour relativiser signalons qu un site comme Le Courrier des Balkans comporte la date d criture de ce texte environ 3 800 articles publi s et plus de 7500 messages de forum et que le moteur de recherche de SPIP ne donne aucun signe de faiblesse Par ailleurs statistiquement on peut consid rer de fa on approximative que chaque contenu ne sera index qu une seule fois compte tenu qu il y a en g n ral beaucoup plus de visites sur un site que de mises jour de contenus le surcro t de charge du serveur appara t n gligeable Qualit http www spip net fr_article996 html 3 of 4 2006 04 17 19 22 8 SP
289. se car les internautes savent tr s bien s ils ont envie ou pas d ouvrir une nouvelle fen tre or ce syst me le leur impose Mais la demande tait trop forte et nous avons craqu supprimer _ numero sert liminer le num ro d un titre si par exemple on veut faire des tris d articles par num titre mais ne pas afficher les num ros car ils ne servent qu ordonner les articles Le format des pr fixes numerot s est XX titre XX tant un nombre n chiffres illimit PtoBR transforme les sauts de paragraphe en simples passages a la ligne ce qui permet de resserrer une mise en page par exemple l int rieur d un sommaire http www spip net fr_article901 html 4 of 11 2006 04 17 19 14 18 SPIP Les filtres de SPIP taille en_ octets permet de transformer un nombre d octets 25678906 en une cha ne de caract res plus explicite 24 4 Mo supprimer _ tags est une suppression basique et brutale de tous les lt gt textebrut s apparente au filtre supprimer_tags mais il agit de mani re un peu plus subtile transformant notamment les paragraphes et lt br gt en sauts de ligne et les espaces ins cables en espaces simples Utilisation par exemple pour faire un descriptif META partir du DESCRIPTIF lt meta name description content DESCRIPTIF textebrut gt texte backend peut tre utiliser pour transformer un texte et le rendre compatible avec des flux xml
290. si d effectuer des rotations de photographies dans la nouvelle interface de portfolio PNG 167 9 ko 274 PORTFOLIO gt 001 IMG_9282 3pg 612 462 pixels 275 gt 004 IMG_9283 jpq 612 x 462 pixels 275 http www spip net fr_article3037 html 4 of 9 2006 04 17 19 24 22 gt 002 IMG_1064 jp9 462 x 612 pixeis gt 005 IMG_9284 jp9 612 x 462 pixels Modifier cet article 27 27 462 x 612 ph ets 271 275 gt 006 1MG_L066 jpg 612 x 462 pixels 271 27 SPIP SPIP 1 8 l interface graphique Le calendrier Outre les changements graphiques de l interface du calendrier interne on remarquera l apparition de cinq petits boutons de r glage ergonomique les petites horloges permettent de d velopper plus ou moins l affichage de la matin e ou de l apr s midi des loupes plus et moins permettent de zoomer sur cet affichage Interface purement textuelle SPIP 1 8 introduit une version nouvelle de l interface destin e aux malvoyants Par rapport la version texte de l interface introduite dans SPIP 14 cette nouvelle interface est nettement all g e l interface texte de l interface elle convient aux connexions relativement lentes mais pour une lecture l cran par un utilisateur voyant On peut acc der cette interface par l adresse ecrire oo ou bien en suivant le lien Afficher l interface textuelle simplifi e qui
291. si utiliser lt INCLUDE gt qui est identique Sa syntaxe g n rale est lt INCLURE fichier php3 param tre gt Le fichier php3 est le nom du fichier que l on veut int grer dans sa page Par exemple imaginons que toutes les pages du site affichent les m mes informations en bas de page On regroupe alors le code SPIP et HTML de ce pied de page dans un fichier pied htm1 squelette lui m me appel par le fichier pied php3 toujours selon le principe des couples de fichiers destin s appeler des squelettes Il suffit d ajouter la ligne suivante l endroit voulu dans chacun des squelettes voulant afficher le bas de page http www spip net fr_article1828 html 1 of 3 2006 04 17 19 21 14 SPIP lt INCLURE gt d autres squelettes Le calendrier de SPIP 1 8 2 E Images typographiques m Couleurs automatiques Traitement automatis des images m La structure de la base de donn es lt INCLURE pied php3 gt Depuis SPIP 1 8 2 la distribution inclut un fichier page php3 qui permet d appeler tout squelette en passant en param tre le fond Ainsi on pourra s viter le fichier pied php3 et remplacer avantageusement l appel ci dessus par lt INCLURE page php3 fond pied gt Pour une r flexion plus large sur ce qu apporte cette nouvelle possibilit d appel de squelettes ainsi que la balise DOSSIER_SQUELETTE On pourra consulter cet article de Spip Contrib
292. soit changer d h bergement soit se r soudre afficher des pages plus simples pour cela modifier les squelettes pour afficher moins d informations sur une m me page Sur une machine d di e Si vous utilisez votre propre machine il faut vous assurer qu elle pourra tenir la charge N importe quelle machine pas trop vieille moins de trois ans environ devrait en tre capable Par contre l utilisation de SPIP par rapport d autres syst mes de publication permet de mutualiser les ressources techniques entre plusieurs sites En effet tant que le cache est utilis la machine est peu sollicit e donc plusieurs sites peuvent cohabiter sans probl me sauf s il y a vraiment un tr s grand nombre de visites Le probl me est donc surtout de pr venir qu il y ait trop de passagers bord c est http www spip net fr_article997 html 2 of 3 2006 04 17 2 23 39 SPIP Rapidit du site public dire qu un trop grand nombre de services h berg s sites Web bo tes e mail mette en p ril la qualit du service http www spip net fr_article997 html 3 of 3 2006 04 17 2 23 39 SPIP Contribuer au d veloppement de SPIP m S curit SPIP et IIS m Qu est ce que les fichiers dist m FAQ webmestre m Rapidit du site public m Contribuer au d veloppement de SPIP m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur
293. soit claire donc texte noir sur fond clair Si nous appliquons le filtre couleur_eclaircir notre couleur extraite nous avons deux cas si la couleur est fonc e alors elle est claircie et nous obtenons l effet voulu si la couleur est d j claire alors nous l claircissons encore et nous obtenons un fond qui peut devenir quasiment blanc Or la couleur tant d j claire nous aurions voulu l utiliser telle quelle C est ici que nous appliquons le filtre couleur_eclaircir_si_foncee si la couleur est fonc e nous l claircissons si la couleur est claire nous l utilisons telle quelle Le filtre couleur_foncer_si_ claire a la logique exactement inverse Il est tr s utile par exemple pour crire en blanc sur un fond syst matiquement fonc mais en vitant de rendre ce fond quasiment noir quand la couleur d origine est d j fonc e couleur_ extreme couleur_ inverser Le filtre couleur_extreme passe une couleur fonc e en noir et une couleur claire en blanc Cela est utile pour crire en noir ou blanc sur un fond color En r alit r cup rer la couleur extr me est habituellement utilis avec couleur_inverser il inverse la couleur RVB Elle transforme notamment du noir en blanc et du blanc en noir En pratique cela permet d assurer un bon contraste quelle que soit la couleur du fond du bloc alors que dans l exemple pr c dent nous choisissions la couleur du
294. sp cialistes il s agit en fait d un include PHP du fichier correspondant permettant d ex cuter du code depuis le cache http www spip net fr_article886 html 3 of 3 2006 04 17 19 18 44 SPIP Des filtres m Mon premier squelette m Un squelette plusieurs articles m Une rubrique m Boucles en boucles m G rer le cache x Des filtres m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m SPIP pas pas Des filtres m Deutsch Portugu s m fran ais m e ee m catal m English m italiano m m Espa ol Si les BOUCLES permettent de structurer la page de mani re logique reste pr senter les donn es de mani re esth tique Question dizah gne SPIP ne peut rien pour vous mais sachez user de ses philtres Une donn e stock e dans la base de donn es se pr sente comme un bloc de texte et on peut avoir envie de manipuler sa valeur avant de l afficher l cran Les filtres sont faits pour a les filtres les plus utilis s ils sont appel s automatiquement sont typo et propre le premier est un correcteur typographique dont la mission principale est d ajouter des espaces ins cables o il en faut cf l aide en ligne de SPIP le second s int resse aux paragraphes aux raccourcis SPIP italiques gras intertitres etc il n est appliqu par d faut qu aux textes longs TEXTE CHAPO etc d autres filtr
295. sque l on travaille avec un identifiant num ro du groupe la syntaxe sera plus propre Les crit res d affichage Les crit res communs toutes les boucles s appliquent moderation oui SPIP 1 4 affiche les sites syndiqu s dont les liens sont bloqu s a priori mod r s l inverse de ce crit re est moderation oui SPIP 1 3 syndication oui syndication non permet de n afficher que les sites r f renc s faisant l objet d une syndication ou les sites non syndiqu s Les balises de cette boucle Les balises tir es de la base de donn es Les balises suivantes correspondent aux l ments directement tir s de la base de donn es Vous pouvez les utiliser galement en tant que crit re de classement http www spip net fr_article910 html 2 of 3 2006 04 17 19 11 51 SPIP La boucle SITES ou SYNDICATION g n ralement par nom_site ID_SYNDIC affiche l identifiant unique du site syndiqu HNOM SITE est le nom du site syndiqu HURL_SITE est l adresse URL du site syndiqu HDESCRIPTIF est le descriptif du site syndiqu ID_RUBRIQUE est le num ro de la rubrique contenant cette syndication HID_ SECTEUR est le num ro de la rubrique secteur la racine du site contenant cette syndication Autres balises LOGO_ SITE affiche le logo attribu au site HURL_SYNDIC affiche l adresse URL du fichier de syndication de ce site HFORMULAIRE FORUM fabr
296. succ s de notre site risque d tre fulgurant Pensons tout de suite aux pauvres neurones de notre ordinateur Dans cette le on rien d amusant rien d essentiel non plus Les flemmards en profiteront pour roupiller au fond pr s du radiateur R sum pour ceux ci et pour les gens press s dans les fichiers d appel de type tutoriel php3 r glez delais 3600 aulieudeo Au moment o une page est demand e SPIP celui ci regarde si par hasard il n aurait pas d j calcul cette page auparavant Si l URL demand e est http votresite net tutoriel php3 id_article 12 SPIP regarde dans son sous r pertoire CACHE si ce fichier existe et le cas ch ant compare l ge du fichier cach aux delais fix s dans le fichier d appel tutoriel php3 Dans notre exemple nous avions fix des delais 0 d o un recalcul syst matique des pages chaque consultation du site Passons Sdelais 3600 http www spip net fr_article886 html 1 of 3 2006 04 17 19 18 44 SPIP G rer le cache c est en secondes Notre page web n est donc recalcul e que si lorsqu un visiteur la demande sa version cach e date de plus d une heure soit 3600 s Sinon SPIP lit simplement le contenu du fichier cach 1 et renvoie le r sultat sans se connecter la base de donn es sauf pour y ins rer un hit dans les statistiques Comment fixer ces delais de mani re optimiser le rapport r activit charge du serveur Pa
297. sur votre site Vous tes alors invit s lectionner votre m thode pr f r e parfois s lectionner la seule r ellement disponible http www spip net fr_article3024 html 3 of 5 2006 04 17 19 23 5 SPIP Le traitement des images GD GD2 GD et sa version 2 nettement plus puissante est une extension de PHP d sormais fr quemment pr sente sur les serveurs y compris les h bergeurs mutualis s Si GD2 est pr sente vous pouvez l utiliser elle donne des r sultats de bonne qualit En revanche GD comprendre version 1 de GD est propos e comme pis aller le traitement des images se fait en 256 couleurs et introduit de fortes d gradation des images elle n est donc s lectionner que si aucune autre m thode ne fonctionne sur votre site Imagemagick par convert Convert est le logiciel en ligne de commande de Imagemagick La qualit est absolument patante cependant son installation est relativement complexe Une fois convert install sur votre site vous devez configurer le chemin d acc s dans mes_options php3 il s agit d un appel en ligne de commande par la variable suivante convert_ command bin convert Il convient ici d indiquer le chemin complet d acc s au programme Sous Linux ce chemin est souvent convert_ command bin convert sous MacOS X s il est install avec Fink convert_ command sw bin convert ces valeurs sont fournies titre in
298. t cette balise car il est d conseill d ins rer syst matiquement les documents dans les pages sans un contr le strict sauf faire exploser la dur e de chargement de vos pages Web La balise peut tre compl t e de param tres propres aux formats utilis s encore une fois utilisation tr s sp cifique par exemple HEMBED DOCUMENT jautostart true 1 Si on utilise un crit re avec un nom doublons unnom celui ci n exclura pas les documents int gr s dans le texte de l article kS 4 at http www spip net fr_article1823 html 4 of 4 2006 04 17 19 12 3 SPIP La boucle SYNDIC_ARTICLES m Principe g n ral Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES E La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS La boucle SITES ou SYNDICATION m La boucle DOCUMENTS m La boucle SYNDIC_ARTICLES m La boucle m SPIP syst me de publication pour l in NT ternet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La boucle SYNDIC ARTICLES m fran ais me e e ee catal m Deutsch E English m Espa ol w italiano La boucle SYNDIC_ARTICLES retourne une liste des articles des sites syndiqu s On peut soit l utiliser l int rieur d une boucle SITES cette derni re r cup re une liste de sites r f renc s ensuit
299. t du bidouilleur m Le d veloppement de SPIP et ses outils Le d veloppement de SPIP et ses outils Les diff rents outils de communication utilis s pour d velopper SPIP Le d veloppement de SPIP est d sormais fait sous SVN fran ais oo x O Il est facile suivre travers diff rents outils dont EURE l interface Web propos e sur ce site SPIP Zone Modifications r centes Un outil communautaire pour d velopper des squelettes m Le NET CR SRE des outils des scripts autour de SPIP 1 8 2 As n E Internationaliser les http www spip net fr_rubrique205 html 1 of 3 2006 04 17 19 35 16 SPIP Le d veloppement de SPIP et ses outils squelettes m Principe g n ral m lt INCLURE gt d autres squelettes Les balises propres au site m La boucle ARTICLES m SPIP 1 8 3 m Les filtres de SPIP a Traitement automatis des images m Images typographiques La liste des annonces des d veloppements spip core rezo net La liste spip core n est pas une liste de discussion personne ne peut y poster de message Elle est destin e recevoir les informations sur les plus r cents d veloppements On peut n anmoins s y abonner et consulter ses archives si l on veut tester les tous derniers d veloppements de SPIP et disposer des informations n cessaires N B Tous les messages de spip core sont galement disponibles sur spip dev La liste des d veloppeurs spip dev rezo net Attention
300. te id_ mot retourne le mot cl dont l identifiant est id_ mot id_groupe retourne les mots cl s associ s au groupe de mots dont le num ro est id_ groupe SPIP 1 4 http www spip net fr_article909 html 1 of 3 2006 04 17 19 11 38 SPIP La boucle MOTS m La boucle DOCUMENTS m La boucle SYNDIC_ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives E La popularit des articles m La gestion des dates m Exposer un article dans une liste id_article retourne les mots cl s associ s cet article c est l utilisation la plus courante de cette boucle id_rubrique retourne les mots cl s associ s une rubrique SPIP 1 4 id_breve retourne les mots associ s une br ve SPIP 1 4 id_syndic retourne les mots associ s un site r f renc SPIP 1 4 id_forum retourne les mots associ s un message de forum SPIP 1 4 attention utilisation tr s sp cifique titre france retourne le mot cl intitul france par exemple type pays retourne les mots cl s du groupe de mots cl s intitul pays par exemple Les crit res d affichage Les crit res communs toutes les boucles s appliquent Les balises de cette boucle Les balises tir es de la base de donn es
301. te courante Ainsi age lt 30 permettra de ne pas afficher les articles g s de plus de 30 jours http www spip net fr_article1971 html 2 of 4 2006 04 17 19 16 3 SPIP La gestion des dates L age_relatif permet de comparer les dates de publication de deux articles si l on vient de s lectionner un article dans une boucle une seconde boucle plac e l int rieur de la premi re pourra demander les articles publi s dans la semaine qui pr c de celui ci via age_relatif lt 7 age relatif gt 0 etc Les crit res age et age_relatif permettent de distinguer deux articles publi s le m me jour ce n tait pas le cas avant SPIP 1 6 On peut donc d sormais programmer des boucles pour obtenir l article pr c dent ou le suivant lt BOUCLE_ art ARTICLES id_article gt lt BOUCLE_ precedent ARTICLES age _relatif 0 par date inverse 1 1 gt pr c dent lt a href URL_ARTICLE TITRE lt a gt DATE lt BOUCLE_ precedent gt lt br gt lt b gt TITRE lt b gt HDATE lt br gt lt BOUCLE _suivant ARTICLES A DE TE S mama ald i Attention Malgr les apparences les comparaisons de date sont d un maniement d licat en effet cause des dates floues un article publi un mois donn sans que le jour soit pr cis le calcul de l age relatif peut donner la valeur z ro dans un sens et pas dans l autre D o la dissym trie des boucles pr sent es ci dessus
302. tent lt BOUCLE_keywords MOTS Iid _nrticlaU M HTITRE 2 On remarquera que pour les mots cl s et l auteur on utilise une boucle imbriqu e pour aller chercher ces informations partir de l id_ article courant De plus on sp cifie une virgule comme s parateur afin que le contenu du meta tag soit compr hensible y compris par un moteur de recherche Attention le code donn ci dessus titre d exemple est un peu na f si le NoM d un auteur ou le HDESCRIPTIF d un article peuvent contenir des tags html http www spip net fr_article1493 html 1 of 2 2006 04 17 19 34 8 SPIP Remplir les meta tags HTML des pages d article m Ne pas afficher les articles publi s depuis plus d un an m Pr senter les r sultats d une recherche par secteurs m Afficher le nombre de messages du forum li un article m Un menu d roulant pour pr senter une liste d articles m Remplir les meta tags HTML des pages d article mise en italiques saut de paragraphe la page qui en r sultera sera en effet pleine d erreurs Pour viter cela il faut penser passer un filtre comme supprimer_tags sur le champ en question remplacer DESCRIPTIF par DESCRIPTIF supprimer _ tags http www spip net fr_article1493 html 2 of 2 2006 04 17 19 34 8 SPIP Le d veloppement de SPIP et ses outils m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre e
303. ter le nombre total de contributions dans un forum N B En l absence de crit re id_forum ou id_parent lorsque plat n est pas utilis seuls les messages n ayant pas de parent i e la racine d un thread sont affich s id_secteur retourne les messages correspondant au secteur A priori peu utile mais cela permet par exemple de faire un grand forum th matique regroupant tous les messages d un secteur quel que soit l endroit o l on se trouve partir de la version SPIP 1 4 les messages des forums peuvent tre li es des mots cl s Les crit res de mots cl s peuvent donc tre d sormais utilis s dans les boucles FORUMS e id mot titre mot xxx r cup rent les messages li s au mot dont le num ro est id mot ou dont le titre est titre mot e id_groupe type _mot yyyy r cup rent les messages li s des mots du groupe id groupe ou du groupe dont le titre est type mot http www spip net fr_article908 html 2 of 4 2006 04 17 19 11 26 SPIP La boucle FORUMS Les crit res d affichage Les crit res communs toutes les boucles s appliquent Les balises de cette boucle Les balises tir es de la base de donn es Les balises suivantes correspondent aux l ments directement tir s de la base de donn es Vous pouvez les utiliser galement en tant que crit re de classement g n ralement par titre ID_FORUM affiche l identifiant unique du message ID_THREAD
304. terface m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es Spip et les feuilles de style m fran ais m catal mDeutsch wm English mEspa ol mitaliano E 000e e SPIP 1 2 Lorsque l on utilise les raccourcis typographiques dans les articles dans SPIP permettant par exemple de mettre en gras en italique cr er des liens hypertextes des intertitres etc SPIP produit les balises HTML n cessaires ces effets chacune de ces balises tant alors associ e une classe de style CSS Par exemple Ceci est un lien gt http www uzine net est transform en code HTML ainsi Ceci est un lt a href http www uzine net class spip_out gt lien lt a gt Le code HTML est ainsi compl t par l appel un style CSS intitul spip_ out L utilisateur peut donc pousser la personnalisation de son interface graphique en d finissant ce style spip_ out couleur diff rente fond color police utilis e La plupart des raccourcis typographiques de SPIP peuvent ainsi tre param tr s avec des feuilles de style certains sont tr s utiles d autres seront r serv s aux webmestres qui souhaitent obtenir des effets exotiques http www spip net fr_article1177 html 1 of 8 2006 04 17 19 21 0 SPIP Spip et les feuilles de style graphique m Le calendrier de SPIP 1 8 2 E Images typographiques m Coul
305. texte principal de la rubrique HID_ SECTEUR est l identifiant du secteur dont d pend la rubrique le secteur tant la rubrique situ e la racine du site LANG retourne la langue de cette rubrique Les balises calcul es par SPIP Les l ments suivants sont calcul s par SPIP Ils ne peuvent pas tre utilis s comme crit re de classement NOTES les notes de bas de page calcul es partir de l analyse du texte HINTRODUCTION les 600 premiers caract res du texte les enrichissements typographiques gras italique sont supprim s http www spip net fr_article904 html 3 of 5 2006 04 17 19 10 52 SPIP La boucle RUBRIQUES HURL_ RUBRIQUE est l URL de la page de la rubrique SPIP 1 4 DATE affiche la date de la derni re publication effectu e dans la rubrique et ou ses sous rubriques articles br ves HFORMULAIRE FORUM fabrique l interface permettant de poster un message r pondant cette rubrique Pour en savoir plus voir aussi Les formulaires HPARAMETRES_ FORUM fabrique la liste des variables exploit es par l interface du formulaire permettant de r pondre cette rubrique Par exemple lt A HREF forum php3 PARAMETRES_ FORUM gt R pondre cette rubrique lt A gt Depuis SPIP 1 8 2 on peut lui passer un param tre sp cifiant l adresse de retour apr s avoir post le message Par exemple lt A HREF forum php3 PARAMETRES_FORUM SELF gt R pondre
306. tilisez des polices commerciales faites attention ne pas vous retrouver ainsi diffuser des polices pour lesquelles cela n est pas autoris N B 1 L image cr e par image_t ypo est au format PNG 24 avec une couche alpha pour r aliser la transparence Pour forcer Microsoft Explorer afficher correctement cette transparence SPIP utilise une classe de feuille de style sp cifique format_pno d finie dans spip_style css celle ci appelle un comportement behavior rendant l affichage possible sous MSIE On a donc encore une fois tout int r t int grer le spip_style css standard dans ses propres squelettes quitte le surcharger avec ses http www spip net fr_article3325 html 5 of 6 2006 04 17 19 25 4 SPIP Images typographiques propres styles N B 2 L affichage de certaines polices notamment les anglaises et certaines italiques est probl matique Les techniques de rendu typographique dans GD2 sont visiblement encore en d veloppement nous rencontrons bugs sur bugs de ce c t Esp rons que les fonctions GD2 progresseront rapidement N B 3 De l arabe du farsi de l h breu Malheureusement non Nous rencontrons pour l heure deux difficult s qui ne permettent pas de proposer de solution propre pour l affichage de l h breu et de l arabe Tout d abord la gestion de l affichage bidirectionnel n est pas assur par GD2 il n est donc pas possible pour l instant de cr er des images t
307. time l article n a pas encore t publi c est la date de statut varchar 10 Cr ation o p a date redac est la date de publication ant rieure id_secteur bigint 21 i Si vous r glez cette valeur sinon elle est gale maj timestamp 14 0000 00 00 pan varchat 10 statut est le statut actuel de l article prepa en images text cours de r daction prop propos la date_redac datetime publication publie publi refuse refus visites int 11 poubelle la poubelle referers blob accepter _ forum permet de r gler accepter forum char 3 manuellement si l article accepte des forums par d faut oui maj m me signification que dans la table des rubriques export est un champ r serv pour des fonctionnalit s futures images est un champ contenant la liste des images utilis es par l article dans un format particulier Ce champ est g n r par spip_image php3 http www spip net fr_article713 html 2 of 7 2006 04 17 19 27 12 SPIP La structure de la base de donn es visites et referers sont utilis s pour les statistiques sur les articles Le premier est le nombre de chargements de l article dans l espace public le deuxi me contient un extrait de hash des diff rents referers afin de conna tre le nombre de referers distincts Voir inc stats php3 Les auteurs spip_auteurs id_auteur bigint 21 Chaque auteur est identifi par son id_ auteur nom
308. tion correspondante SPIP cherchera les fichiers de squelette en priorit dans ce sous dossier avant tous les pr c dents Voici l ordre par priorit d croissante dans lequel sont utilis s les fichiers de squelettes selon leur nom rubrique 10 html si ce fichier existe il ne s applique qu la rubrique num ro 10 si ce fichier n existe pas SPIP regarde si il n y a pas un fichier rubrique 10 html si ce fichier existe la rubrique 10 ainsi que ses sous rubriques l utilisent c est donc r cursif Note pour que ces fichiers soient pris en compte il faut que le fichier par d faut rubrique htm1 se trouve dans le m me http www spip net fr_article1591 html 2 of 3 2006 04 17 2 23 19 SPIP Qu est ce que les fichiers dist r pertoire si ce fichier n existe pas SPIP regarde s il n y a pas un fichier rubrique html qui s applique toutes les rubriques du site qui ne sont pas concern es par les fichiers indiqu s ci dessus Historique Jusqu SP P 1 7 2 si ce fichier n existe pas SPIP utilise alors le fichier rubrique dist html qui est le fichier fourni par d faut Si vous voulez modifier ce fichier renommez le en rubrique htm1 de fa on ne pas craser vos modifications la prochaine mise jour de SPIP 1 sauf ventuellement ceux qu on n utiliserait que dans un appel lt INCLURE squel php3 gt Dans ce cas le fichier squel php3 peut aussi tre dans le d
309. tion de spip Ces fichiers contiennent les informations sur la mise en page par d faut du site et ne devraient pas tre modifi s http www spip net fr_article1591 html 1 of 3 2006 04 17 2 23 19 SPIP Qu est ce que les fichiers dist Ainsi un utilisateur qui veut cr er sa propre mise en page d veloppera ses fichiers article html rubrique html etc la racine du site ou mieux dans le r pertoire squelettes d di A la prochaine r installation de SPIP seuls les fichiers dans dist seront cras s et le webmestre ne perdra pas ses personnalisations Remarque Les fichiers php3 pendants des fichiers htm1 dans un squelette SPIP doivent toujours rester la racine du site 1 Historique Depuis SPIP 1 3 et jusqu SP P 1 7 2 les fichiers de squelettes fournis dans la distribution de SPTP taient nomm s article dist html rubrique dist html et ainsi de suite Pour personnaliser ces fichiers il suffisait de les renommer d abord article html rubrique html etc sans le dist Pour aller plus loin Depuis SPIP 1 8 SPIP recherche les fichiers htm1 des squelettes d abord la racine du site puis s ils n y existent pas dans le r pertoire squelettes En dernier recours SPIP prend les fichiers par d faut dans le r pertoire dist Remarque De plus si on d finit une variable de personnalisation Sdossier_ squelettes comme expliqu dans la documenta
310. toutes les modifier et ajout une nouvelle couleur couleurs_spip indiquant qu on ajoute une valeur au tableau array Scouleurs_spip http www spip net fr_article3037 html 9 of 9 2006 04 17 19 24 22 SPIP Le calendrier de SPIP 1 8 2 m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es Le calendrier de SPIP 1 8 2 E fran ais meccccce catal mEspa ol mitaliano m Spip et les SPIP 1 8 2 permet de visualiser dans l espace public des calendriers avec le m me Las oo affichage que celui de l espace priv et plus g n ralement de construire des an agendas quelconques b n ficiant des outils de mises en pages de ces calendriers squelettes Cette possibilit est fournie par un nouveau crit re de boucle et trois nouveaux m R aliser un site filtres multilingue m Internationaliser Le crit re agenda poss de un nombre variable d arguments et peut donc s crire les squelettes de deux fa ons m Utiliser des agenda datetime type AAAA MM JJ URLs personnalis es m Le moteur de recherche Les deux premiers arguments sont m Les variables de personnalisation m Tidy validation agenda datetime periode AAAA MM JJ AAAA2 MM2 JJ 2 1 un nom de champ SQL de type datetime par exemple date ou date_redac pour la table Articles et date_t ime pour les Breves cet XHTML 1 0 m Le support LDAP argume
311. tre d fini de la mani re suivante dans mes fonctions php3 function filtre texte arg1 valeur par defaut1 arg2 valeur par d faut 2 Calculs return une chaine de caract res On peut ainsi appeler n importe quelle fonction php ou s appuyer sur des fonctions d finies dans SPIP ou dansmes_fonctions php3 pour peu qu elles respectent l ordre des arguments le texte traiter doit tre imp rativement le premier argument Par exemple pour enlever les points la fin d un texte on pourra faire TEXTE rtrim Depuis SPIP 1 8 les arguments des filtres peuvent tre des balises sans codes optionnels ni filtres Par exemple TOTAL_ BOUCLE COMPTEUR_BOUCLE Fin Depuis SPIP 1 8 2 on peut mettre un balise avec notation tendue en param tre Par exemple DESCRIPTIF sinon CHAPO sinon TEXTE couper 300 l http www spip net fr_article901 html 11 of 11 2006 04 17 19 14 18 SPIP Les boucles r cursives E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle arr VAUT LEE m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel
312. ttp www spip net fr_article2035 html 2 of 3 2006 04 17 19 31 51 SPIP Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier m Afficher automatiquement selon la date ou selon un ordre impos a Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier m Plusieurs logos pour un article m Afficher les derniers articles de vos r dacteurs par rubrique m Afficher des l ments par lignes dans un m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Trucs et astuces Trier des articles par ordre alphab tique sauf un qu il faut afficher en premier E fran ais mocatal mEnglish mEspa ol mitaliano Mettons que vous voulez pr senter une s rie d articles par ordre alphab tique sauf le prologue que vous voulez l gitimement afficher au d but de la liste Il existe une astuce pour duper le tri effectu par SPIP il suffit d ajouter un espace au d but du titre de l article par exemple transformer Prologue en Prologue Le tri alphab tique pensera alors que ce titre doit passer avant les autres et l affichera en premier Cependant l espace suppl mentaire du titre sera ignor par le navigateur Web et ne provoquera pas de d calage disgr cieux dans la mise en page Notez bien l astuce ne fonctionnera que si vous utilisez un classement alphab tique sur le titre des
313. tuellement avec la gestion du survol HLOGO_ ARTICLE RUBRIQUE le logo de l article ventuellement remplac par le logo de la rubrique s il n existe pas de logo sp cifique l article LOGO_ RUBRIQUE le logo dela rubrique de l article http www spip net fr_article902 html 5 of 6 2006 04 17 19 10 42 SPIP La boucle ARTICLES Les logos s installent de la mani re suivante LOGO_ARTICLE alignement adresse L alignement peut tre 1eft ou right L adresse est l URL de destination du lien de ce logo par exemple URL_ARTICLE Si l on n indique pas d adresse le bouton n est pas cliquable Si l on veut r cup rer directement le nom du fichier du logo alors que les balises pr c dentes fabriquent le code HTML complet pour ins rer l image dans la page par exemple pour afficher une image en fond de tableau on utilisera le filtre fichier comme suit LOGO_ARTICLE fichier Par ailleurs deux balises permettent de r cup rer un seul des deux logos H LOGO_ ARTICLE NORMAL est le logo sans survol LOGO_ ARTICLE SURVOL est le logo de survol http www spip net fr_article902 html 6 of 6 2006 04 17 19 10 42 SPIP La boucle RUBRIQUES E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle S
314. tuellement les images incluses dans une br ve lt BOUCLEn DOCUMENTS crit res gt Cette boucle g re non seulement les documents joints non install s dans le texte d un article mais peut aussi acc der aux images depuis la version 1 4 les images sont g r es au niveau du programme comme un genre sp cifique de documents aux vignettes de pr visualisation et aux documents d j ins r s dans le corps de l article Pour m moire on utilisera donc le plus fr quemment utilisation courante la boucle DOCUMENTS avec au minimum les crit res suivants explications ci apr s lt BOUCLEn DOCUMENTS http www spip net fr_article1823 html 1 of 4 2006 04 17 19 12 3 SPIP La boucle DOCUMENTS DOCUMENTS m La boucle SYNDIC_ ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives m La popularit des articles m La gestion des dates m Exposer un article dans une liste Les crit res de s lection Une boucle DOCUMENTS s utilise en g n ral l int rieur d un article ou d une rubrique ventuellement dans une br ve mais ici l utilisation sera r serv e la r cup ration d images ce qui sera tr s sp cifique id_article retourne les documents de l article dont l identifiant est id_article
315. u d l ments pr cis un titre une date un texte etc A l int rieur d une boucle il faut donc pouvoir indiquer quel endroit du code HTML on place tel ou tel de ces l ments pr cis Pour cela on va utiliser des balises SPIP Fonctionnement simplifi Une balise SPIP se place l int rieur d une boucle puisqu il faut savoir si l on veut r cup rer un l ment d un article d une rubrique etc Le nom de ces balises est g n ralement simple et nous fournirons pour chaque type de boucle la liste compl te des balises que l on peut utiliser Une balise est toujours pr c d e du signe di se http www spip net fr_article899 html 1 of 6 2006 04 17 19 10 24 SPIP La syntaxe des balises SPIP m La boucle DOCUMENTS m La boucle SYNDIC_ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives E La popularit des articles m La gestion des dates m Exposer un article dans une liste Par exemple affichons une liste de noms d articles lt BOUCLE_articles ARTICLES id_rubrique gt lt li gt TITRE lt BOUCLE articles gt Lorsque la boucle sera ex cut e la balise SPIP TITRE sera chaque fois remplac e par le titre de l article en question lt li gt Titre de l article 1 lt li gt
316. ubli lt BOUCLENn AUTEURS crit res gt Les crit res de s lection On utilisera l un ou autre des crit res suivants pour indiquer comment on s lectionne les l ments tout les auteurs sont s lectionn s qu ils aient crit un article ou non id auteur retourne l auteur dont l identifiant est id_auteur Comme l identifiant de chaque auteur est unique ce crit re retourne une ou z ro r ponse id_article retourne tous les auteurs de cet article http www spip net fr_article907 html 1 of 3 2006 04 17 19 11 16 SPIP La boucle AUTEURS DOCUMENTS m La boucle SYNDIC_ ARTICLES m La boucle SIGNATURES m La boucle HIERARCHIE m Les crit res communs toutes les boucles m Les balises propres au site m Les formulaires m Les boucles de recherche m Les filtres de SPIP m Les boucles r cursives m La popularit des articles m La gestion des dates m Exposer un article dans une liste lang s lectionne les auteurs qui ont choisi dans l espace priv la langue demand e dans l adresse de la page Si un auteur ne s est jamais connect dans l espace priv il ne sera pas trouv par ce crit re lang_select Par d faut une boucle AUTEURS affiche les balises et les cha nes localis es dans la langue du contexte 1 Si on utilise ce crit re ces informations seront localis es dans la langue choisie par l auteur Les crit res d affichage Les crit res c
317. ui doit s afficher sur l article expos et ce qui doit s afficher sur les autres articles Ainsi EXPOSE oui non affichera oui sur l article expos et non sur les autres Avec un peu d astuce il est possible de d sactiver le lien sur l article expos et dans le m me temps de choisir la feuille de style lt BOUCLE_menu ARTICLES id rubrique lt br gt gt lt a EXPOSEf id href l URL_ ARTICLE cr era le HTML suivant lt a href articlei html class lien Tout sur ma soeur lt a gt lt br gt lt a id article2 html class lien ce qui s affiche ainsi Tout sur ma soeur Tout sur moi Tout sur mon fr re Historique http www spip net fr_article2319 html 2 of 3 2006 04 17 19 16 17 SPIP Exposer un article dans une liste Cette fonctionnalit a t introduite par SP P 1 7 1 avec la balise EXPOSER La syntaxe compl te de EXPOSER tait la suivante HEXPOSERoui non Celle ci est d sormais obsol te Il est donc conseill d utiliser EXPOSE dont la syntaxe compl te est plus conforme au mod le g n ral des balises de SPIP http www spip net fr_article2319 html 3 of 3 2006 04 17 19 16 17 SPIP SPIP pas pas m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m SPIP pas pas SPIP pas pas Pas pas comment cr er un SPIP qui d fie les limites Mon premie
318. ui permettent d agir sur l espacement de l intertitre avec les paragraphes pr c dent et suivant Sans ce r glage il y aurait de fortes chances que l intertitre serait soit trop coll au reste du texte soit trop espac selon les go ts Code et cadre Les l ments de code d finis par le raccourci lt code gt Du code dans le texte lt code gt http www spip net fr_article1177 html 3 of 8 2006 04 17 19 21 0 SPIP Spip et les feuilles de style sont param tr s par le style spip_ code Peu utilis sauf dans le cas d une documentation technique comme celle ci o l on doit citer des morceaux de code informatique des noms de fichiers ou de r pertoires Introduit dans SPIP 1 3 la balise lt cadre gt lt cadre gt permet de pr senter du code source dans un tableau l ment de formulaire dans lequel il est facile copier coller le texte La feuille de style associ e est spip_ cadre d finie ainsi par d faut Spip_cadre width 100 background color FFFFFF padding 5px Les notes de bas de page Les notes de bas de page d finies par le raccourci Le texte Une note de bas de pagel l sont param tr s par le style p spip_ note Souvent inutile puisque les notes peuvent tre modifi es directement en HTML lors de l emploi de la balise NOTES dans vos squelettes Les tableaux Les tableaux sont d finis dans SPIP de la fa on suivante Nom
319. une page pour un article syndiqu puisqu on pr f rera renvoyer directement vers l article en question id syndic retourne la liste des articles du site syndiqu dont l identifiant est id_ syndic id_ rubrique retourne la liste des articles syndiqu s dans cette rubrique id_secteur retourne la liste des articles syndiqu s dans ce secteur Les crit res d affichage Les crit res communs toutes les boucles s appliquent Les balises de cette boucle Les balises tir es de la base de donn es Les balises suivantes correspondent aux l ments directement tir s de la base de donn es Vous pouvez les utiliser galement en tant que crit re de classement g n ralement par titre ID_SYNDIC_ARTICLE affiche l identifiant unique de l article syndiqu ID_SYNDIC affiche l identifiant unique du site syndiqu contenant cet article TITRE est le titre de l article Remarque il est pr f rable d utiliser ici le titre brut de l article syndiqu via le code TITRE pour viter le moteur typographique En effet les titres sont cens s tre d j typographiquement corrects dans les backends et on ne souhaite pas passer la correction typographique sur des titres en anglais ou sur des titres comprenant des expressions du genre Les fichiers tcshrc HURL_ ARTICLE est l adresse URL de l article syndiqu sur son site original http www spip net f
320. ur cette initiation 1 Et m me les boutons d administration qui s affichent en bas des pages lorsque vous tes connect 2 Notons cependant que certains navigateurs imposent leurs propres boutons stylis s et ne vous laisseront pas en changer l aspect http www spip net fr_article2336 html 3 of 3 2006 04 17 19 29 40 SPIP Pour en savoir plus m Introduction m Des styles qui ont de la class E Une typographie personnalis e mis sont beaux mes formulaires m Pour en savoir plus m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m initiation utiliser les feuilles de style avec SPIP Pour en savoir plus m catal mDeutsch wm English m Espa ol T rk e E fran ais m italiano m Cette initiation n a fait qu effleurer la puissance des feuilles de style Vous tes libres de vous contenter du niveau abord ici ou d explorer les nombreux documents disponibles sur le Web afin aller plus loin Citons quelques portes de sortie int ressantes En fran ais OpenWeb site m lant argumentaires id ologiques et articles techniques sur les CSS et autres standards du Web un cours CSS d butant Techniques et astuces pratiques pour une mise en page CSS vous expliquera comment g rer le positionnement d l ments avec les feuilles de style une collection de recettes pour une utilisation efficace des CSS
321. utilis s en tant que tels Les op rateurs unaires doivent tre coll s au param tre auquel ils s appliquent Par convention lors d un appel de fonction il n y a pas d espace devant la parenth se ouvrante f x et non f x A contrario et pour bien distinguer on laisse un espace devant la parenth se quand il s agit d une structure de contr le int gr e au langage if x et non if x Les virgules et points virgules sont suivis mais non pr c d s d un espace R gles de programmation R fl chir Avant de programmer une nouvelle fonctionnalit r fl chir m thodes et algorithmes utilis s pour l impl mentation l g ret performance robustesse ne pas h siter faire quelques calculs grossiers pour valider les choix ad quation au projet portabilit s curit souplesse implications sur les autres fonctionnalit s modifications et ajouts faire sur les fonctionnalit s existantes place naturelle pour cette fonctionnalit dans le projet en mati re d interface de fichiers Ne pas n gliger la factorisation ou mise en commun du code par des fonctions notamment dans des fichiers inclure Eviter par contre le plus possible les fichiers inclus contenant du code hors fonctions sauf lorsque c est naturel et voulu http www spip net fr_article825 html 3 of 5 2006 04 17 2 23 56 SPIP Contribuer au d vel
322. v couleur d une image typographique modifier la couleur d une image image_sepia Modifier la couleur http www spip net fr_article3326 html 3 of 6 2006 04 17 19 26 14 SPIP Couleurs automatiques Une fois la couleur extraite il est utile de la manipuler afin de jouer avec diff rentes variantes de la couleur tout en respectant la coh rence graphique couleur _ foncer couleur_ eclaircir partir de la couleur extraite d une image nous souhaitons afficher des couleurs plus fonc es et plus claires HLOGO RUBRIQUE couleur_extraire HLOGO RUBRIQUE couleur_extraire couleur foncer Appliqu aux couleurs extraites des exemples pr c dents cela donne On constate qu on a ainsi des cama eux de couleurs faciles obtenir l ensemble tant tr s coh rent couleur foncer si claire couleur eclaircir_si_foncee Si nous appliquons la couleur extraite au fond d un pav de texte il faut d terminer dans quelle couleur nous voulons crire ce texte par exemple noir sur orange ou blanc sur orange c est ce que nous verrons avec les fonctions suivantes http www spip net fr_article3326 html 4 of 6 2006 04 17 19 26 14 SPIP Couleurs automatiques Pour l instant nous d cidons que le texte sera d une certaine couleur Nous voulons par exemple que le texte soit noir Il faut donc choisir la couleur du fond en fonction de ce texte noir il faut que la couleur du fond
323. www spip net fr_article1846 html 2 of 3 2006 04 17 19 15 42 SPIP La popularit des articles Cet article a une popularit absolue gale 1 soit 17 de 2 Au total ce site fait environ 5 visites par jour Enfin un crit re de tri peut se r v ler utile par popularite quel on utilisera par exemple de la mani re suivante pour afficher la liste des 10 articles les plus populaires de la rubrique courante lt BOUCLE_hitparade ARTICLES id_rubrique par popularite inverse 0 10 gt lt li gt TITRE popularit HPOPULARITE lt On enl vera id_rubrique pour afficher un hit parade du site entier VAR XL FA 12 Cia http www spip net fr_article1846 html 3 of 3 2006 04 17 19 15 42 SPIP La gestion des dates E Principe g n ral m Des boucles et des balises m La syntaxe des boucles m La syntaxe des balises SPIP m La boucle ARTICLES m La boucle RUBRIQUES m La boucle BREVES m La boucle AUTEURS m La boucle FORUMS m La boucle MOTS m La boucle SITES ou SYNDICATION m La boucle Pars m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Mise en page manuel de r f rence La gestion des dates m fran ais m catal mDeutsch m English m italiano oc m Espa ol SPIP 1 6 introduit une s rie de crit res et de balises pour mieux g rer les dates des articles En voici une liste Affic
324. xt id_ syndic r f re au site syndiqu d o est tir Te EE l article date PES titre url date lesauteurs parlent d eux m mes lesauteurs text El ments interactifs Les messages de forums spip_ forum id_forum bigint 21 Chaque message de forum est identifi par son id_parent bigint 21 id_ forum id_rubrique bigint 21 L objet auquel est attach le forum est identifi par bigint 21 son id_ rubrique id_ article ou id_ breve Par d faut ces valeurs sont gales z ro Le message parent c est dire le message auquel r pond ce message est identifi par id_ parent Si le id_article id_breve bigint 21 date heure datetime titre text message ne r pond aucun autre message cette texte mediumtext valeur est gale z ro auteur text titre texte nom site url_ site sont le titre et le email auteur text texte du message le nom et l adresse du lien y attach auteur et email auteur sont le nom et l e mail use N ra d clar s par l auteur Dans le cas des forums par F abonnement ils ne sont pas forc ment identiques aux HU varchar i donn es enregistr es dans la fiche de l auteur i e Ip varchal 16 dans la table spip_auteurs maj timestamp l4 gt id_ auteur identifie l auteur du message dans le cas id_auteur bigint 20 de forums par abonnement id message bigint 21 statut est le statut du message publie lisible http www spip net fr_article713 html 4 of 7 2006
325. xte gr ce aux raccourcis SPTP qui sont alors r duites Ainsi par exemple TEXTE reduire image 600 0 affiche totues les images ins r es dans le fil du texte une largeur maximale de 600 pixels Cela permet de pr server la mise en page m me sans que le r dacteur ait se soucier de la taille des images qu il t l charge sur le site NB Si l option cr ation de vignettes est activ e dans la configuration du site ces logos r duits seront des fichiers d images sp cifiques calcul s automatiquement par le serveur id alement avec l extension GD2 install e sur le serveur pour les formats accept s par le serveur avec GD2 habituellement les formats J PG et PNG Sinon c est une version compl te de l image qui est affich e mais avec une taille d affichage fix e directement en HTML Autres Filtres traduire nom langue s applique la balise LANG et retourne un traduction du code de langue qu elle retourne fr en it etc dans cette langue Remarque Les traductions des codes sont faites dans la langue que repr sente ce code et suivent les conventions d criture de cette langue http www spip net fr_article901 html 7 of 11 2006 04 17 19 14 18 SPIP Les filtres de SPIP Ainsi fr sera traduit fran ais en minuscule alors que es sera traduit Espa ol avec une majuscule alterner a b c SPIP 1 8 2 s applique une balise num rique en g n ral COMPTEUR BOUC
326. xxx b est une variante tr s labor e de la pr c dente Elle permet de http www spip net fr_article900 html 6 of 8 2006 04 17 19 13 8 SPIP Les crit res communs toutes les boucles faire commencer la limitation des r sultats par une variable pass e dans l URL cette variable remplace ainsi le a que l on indiquait pr c demment C est un fonctionnement un peu compliqu que fort heureusement on n a pas besoin d utiliser trop souvent La variable pass e dans l URL commence forc ment par debut_xxx o xxx est un mot choisi par le webmestre Ainsi pour une page dont l URL est petition php3 id _article 13 amp debut_signatures 200 avec un squelette petition html contenant par exemple lt BOUCLE_ signatures SIGNATURES on obtiendra la liste des 100 signatures partir de la 20 1 i me rappel Avec l URL petition php3 id _article 13 amp debut_signatures 300 on obtient la liste des 100 signatures partir de la 30 1 i me rappel a n b partir de SPIP 1 8 est une variante de a b qui limite l affichage en fonction du nombre de r sultats dans la boucle a est le r sultat partir duquel commencer faire l affichage b indique le nombre de r sultats ne pas afficher la fin dela boucle 0 n 10 affichera tous les r sultats de la boucle sauf les 10 derniers n a b partir de SPIP 1 8 est le pendant de a n b Onlimite b r sultats en commen ant l affichage au
327. ypographiques pour des cha nes s crivant de droite gauche Pour l arabe et le farsi les ligatures ne sont pas g r es En particulier les ligatures d OpenType sont purement et simplement ignor es g AS CA CT http www spip net fr_article3325 html 6 of 6 2006 04 17 19 25 4 SPIP Couleurs automatiques m Spip et les feuilles de style m lt INCLURE gt d autres squelettes m R aliser un site multilingue Internationaliser les squelettes m Utiliser des URLS personnalis es m Le moteur de recherche Les variables de personnalisation m Tidy validation XHTML 1 0 m Le support LDAP Le traitement des images m Ins rer des formules math matiques en LaTEX m SPIP 1 8 l interface m SPIP syst me de publication pour l internet m Documentation en fran ais m Guide du webmestre et du bidouilleur m Guide des fonctions avanc es Couleurs automatiques E fran ais mocatal mitaliano SPIP 1 9 et GD2 SPIP permet d extraire automatiquement une couleur d une image afin de l appliquer d autres l ments d interface Par exemple c t du logo d un article nous allons afficher le titre du m me article dans une couleur tir e de ce logo De cette fa on tout en rendant l affichage plus vari d un article l autre la couleur utilis e change en fonction du logo le fait que la couleur soit extraite de l image assure une certaine coh rence graphique Cette fon

PDF – 3.3 Mo - SPIP

Contents

Download Pdf Manuals

Related Search

Related Contents

PDF &ndash; 3.3 Mo - SPIP

Contents

Download Pdf Manuals

Related Search

Related Contents

PDF – 3.3 Mo - SPIP