Lorsque vous installez SPIP sur votre propre serveur, ou que vous utilisez une intallation mutualisée de SPIP, celui-ci ne pourra pas toujours créer les « répertoires de données » avec les droits appropriés. Vous devrez alors intervenir avec votre logiciel de FTP ou de SSH habituel, pour « fixer les droits d’accès » manuellement.

Cette opération concerne quatre répertoires, SPIP vous signalera leur emplacement. Celui-ci varie selon que SPIP est en usage mutualisé ou non, et selon les versions de SPIP ; depuis SPIP 1.9, ces répertoires se nomment IMG, tmp, config et local.

Les logiciels (« clients ») FTP ont des fonctionnements différents, mais la procédure est généralement la suivante :

- sélectionnez le dossier dont vous voulez modifier les « droits d’accès » ;

- trouvez dans votre logiciel de FTP une fonction intitulée « changer (ou modifier, ou fixer) les droits d’accès » ;

- si cette fonction se présente sous la forme d’une interface graphique, vous devez cocher la case correspondant à « Ecriture », pour l’utilisateur « Autres » (ou « Tous utilisateurs ») :

- si cette modification se fait en mode « texte », la configuration numérique est « 777 ».

Lors vous avez effectué cette opération pour chaque répertoire signalé par le système d’installation, rechargez la page, la procédure se poursuit automatiquement.

install1/Votre connexion SQL

Votre connexion SQL

Cette étape consiste à indiquer les informations nécessaires à la connexion de SPIP au serveur SQL.

- Adresse de la base de données : en fonction des choix de votre hébergeur, cette information sera simplement « localhost », ou bien l’adresse de votre site (« www.monsite.org»).

- Le login de connexion : souvent, il s’agit du même login que celui utilisé pour le téléchargement de vos fichiers par FTP.

- Le mot de passe de connexion : souvent, il s’agit du même mot de passe que celui de votre accès FTP au site.

- Ces informations ne s’inventent pas : si vous ne les connaissez pas, c’est que votre hébergeur ne vous les a pas fournies. Donc : si n’avez pas sous la main ces trois informations, vous ne pouvez pas continuer.

- Ces informations vous sont fournies par l’hébergeur de votre site : pour les obtenir, vous devez le contacter directement (ne demandez pas à l’équipe de développement de SPIP de vous les fournir, nous ne les connaissons pas !). Chez certains hébergeurs, ces informations vous sont fournies dans un mode d’emploi en ligne.

- Notez encore que, très souvent, il faut demander à votre hébergeur d’activer votre accès SQL, ou effectuer vous-même une opération spécifique dans ce but. Beaucoup d’hébergeurs annonçant un hébergement doté d’une base de données SQL n’activent pas automatiquement cette connexion lors de l’ouverture du site ; une démarche supplémentaire de votre part (après l’ouverture de votre compte chez cet hébergeur) est souvent nécessaire. Dans ce cas, voyez la documentation de votre hébergeur pour savoir comment activer votre connexion SQL. (Là encore : l’équipe de SPIP ne peut pas vous aider.)

install2/Choix de votre base

Choix de votre base

- Vous devez indiquer le nom de la base de données que vous a attribué votre hébergeur. Cette information vous est fournie par votre hébergeur : si vous ne l’avez pas, demandez-la lui, ou bien consultez la documentation en ligne de cet hébergeur (inutile de la demander à l’équipe de développement de SPIP, nous ne connaissons pas cette information).

- Très souvent, cette information correspond au login de votre compte d’hébergement (celui que vous utilisez pour vous connecter à votre site par FTP).

- Première possibilité (le plus souvent) : une liste de comptes est affichée (parfois un peu longue, selon la configuration fixée par votre hébergeur). Parmi les comptes indiqués, un seul correspond au vôtre, il vous suffit donc de le sélectionner et de valider pour passer à l’étape suivante.

- Deuxième possibilité : un seul nom, correspondant à votre compte, s’affiche (automatiquement, votre hébergeur a configuré son système pour que s’affiche uniquement votre propre compte). Facile : sélectionnez ce compte et validez.

- Troisième possibilité (généralement sur un hébergement pour professionnels, ou s’il s’agit d’une machine sur laquelle vous avez des droits élevés) : vous devez créer votre propre base. Dans ce cas (après avoir bien vérifié qu’un tel compte n’existait pas dans la liste indiquée ci-dessus), vous pouvez indiquer le nom de votre choix à la suite de l’indication « Créez une nouvelle base ».

- Dernière possibilité (échec) : votre compte n’apparaît pas dans la liste proposée, et vous ne pouvez pas en créer vous-même. C’est assez rare : cela signifie que votre hébergeur a créé pour vous un accès au serveur de la base, mais a oublié de vous créer un compte. Dans ce cas, vous devez directement consulter votre hébergeur.

install5/Informations personnelles

Informations personnelles

Cette étape est très simple, mais doit être effectuée attentivement. En effet, c’est elle qui détermine vos identifiants de connexion à votre propre site ! Si vous procédez trop vite, vous risquez de ne pas pouvoir vous connecter...

Notez qu’une fois votre site installé, vous aurez la possibilité de modifier ces informations.

- Votre identité publique : c’est ce qui apparaîtra en tant que signature de vos articles.

- Vos identifiants de connexion : il s’agit ici des identifiants que vous choisissez vous-même pour vous connecter à votre propre système SPIP. Ces informations n’ont aucunement besoin d’être identiques à celles que votre hébergeur vous a indiquées pour vous connecter à votre compte par FTP. Au contraire, nous vous recommandons très fortement de ne pas utiliser les mêmes identifiants pour votre accès SPIP (que vous choisissez librement) et pour votre connexion FTP (imposées par votre hébergeur).

ftp_auth/Vérification par FTP

Authentification par FTP

Certaines fonctionnalités de SPIP influent directement sur la structure et le contenu mêmes de la base de données (notamment : mise-à-jour, sauvegarde et restauration de la base...). Pour ces fonctionnalités, particulièrement sensibles, il a été ajouté une procédure d’identification par FTP, de façon à les réserver aux quelques personnes ayant accès au serveur du site par FTP (généralement, si un site peut comporter plusieurs administrateurs pour SPIP, l’accès FTP est réservé à un webmestre principal).

erreur_mysql/Un problème de squelette ?

Un problème de squelette ?

Lorsque SPIP se trouve confronté à une erreur dans sa communication avec la base de données SQL, il affiche à l’écran la requête qui a échoué, ainsi que le message d’erreur renvoyé par la base de données (en rouge).

Le problème peut provenir :
- soit d’une erreur dans la définition de votre squelette, si vous êtes en train de modifier votre site ;
- soit d’une panne de la base de données.

Par exemple, un message du type
> Unknown column 'articles.chapi' in 'where clause' signale que la boucle fait appel à un critère de sélection (chapi) qui n’est pas prévu.

En revanche, un message du type
> Can't open file: 'spip_articles.MYD' signale un grave problème de la base SQL elle-même : voyez alors avec votre hébergeur pour qu’il révise son installation et/ou répare votre base de données. Vous pouvez aussi tenter une auto-réparation de la base (si votre base le permet).

Les articles

raccourcis/Les raccourcis typographiques

Pour faciliter la mise en page des documents publiés avec SPIP, le système propose un certain nombre de « raccourcis SPIP » destinés :
- à simplifier l’utilisation par des utilisateurs ne connaissant pas le HTML ;
- à faciliter le traitement automatique de la mise en page.

Par conséquent naturellement vous pouvez toujours utiliser le code HTML dans vos documents SPIP, mais nous vous conseillons d’utiliser de préférence ces quelques raccourcis SPIP (peu nombreux), qui sont beaucoup plus faciles à mémoriser et plus particulièrement permettent au système certaines opérations automatisées.

Les raccourcis typographiques simples de SPIP

Dans un premier temps, nous présentons ici les raccourcis typographiques les plus courants et les plus simples. Pour les utilisateurs qui souhaiteraient affiner encore le contrôle de la mise en forme de leurs textes, nous présenterons des versions plus complexes de ces raccourcis.

N.B. Les raccourcis simples répondent déjà largement à la grande majorité des besoins, et permettent de publier en ligne presque aussi simplement que l’on écrit un mail.

SPIP respecte automatiquement les principales règles d’espacement de la typographie française - ainsi des espaces insécables sont ajoutées devant les caractères « :», « ; », « ! », « ? » -, et place des espaces insécables avant et après les guillemets « à la française ».

(Note : cette fonctionnalité n’est activée que sur les sites dont la langue principale est le français.)

Pour créer des paragraphes, il suffit de laisser une ligne vide, un peu comment on sépare les paragraphes dans un email (on « saute » une ligne).

Le fait de simplement « revenir à la ligne » (retour-chariot) sans séparer les deux paragraphes par une ligne vide ne suffit pas pour provoquer un changement de paragraphe (cela ne provoque même pas un retour à la ligne).

Vous pouvez laisser plusieurs lignes vides à la suite sans que cela modifie la présentation.

On peut insérer une puce en début de ligne dans SPIP : il suffit de revenir à la ligne et de commencer la nouvelle ligne avec un tiret (« - »).

Notez : ici un simple retour à la ligne suffit (on peut faire des énumérations dans le même paragraphe) ; mais si l’on « saute » une ligne avant la ligne commençant par un tiret, une ligne vide est affichée avant l’énumération.

- Qu'est-ce que cela peut faire que je lutte pour la mauvaise cause 
puisque je suis de bonne foi?
- Et qu'est-ce que ça peut faire que je sois de mauvaise foi 
puisque c'est pour la bonne cause. (Jacques 
Prévert)

On notera qu’il s’agit bien d’insérer une puce et non de créer une liste (pour créer des listes voir)

On indique simplement du texte en italique en le plaçant entre des accolades simples : « ...du texte {en italique} en... ».

On indique du texte en gras en le plaçant entre des accolades doubles : « ...du texte {{en gras}} en... ».

Les intertitres sont des titres à l’intérieur d’un texte permettant d’en indiquer la structure. Dans SPIP, on les indique très simplement en les plaçant entre des accolades triples : « {{{Un titre de partie}}} » affichera le texte en gras et centré :

Il est très simple d’insérer un trait de séparation horizontal sur toute la largeur du texte : il suffit de placer une ligne ne contenant qu’une succession d’au moins quatre tirets, ainsi :

SPIP est une initiative du [minirézo->http://www.minirezo.net/].

(Mnémotechnique : le tiret suivi d’un chevron dessine une sorte de flèche qui indique que le texte du lien (avant la flèche) « pointe vers » une adresse.)

L’adresse du lien peut être une adresse absolue (commençant, comme ici, par http://), une adresse relative (vers une autre page du même site), un lien vers un document utilisant un protocole de l’internet (ftp://...), une adresse email (« [->minirezo@rezo.net] »)...

Application spécifique : vous pouvez afficher en toutes lettres un lien cliquable sous la forme d’une adresse URL, en n’indiquant rien avant la « flèche ». Par exemple :

[->http://dmoz.org/World/Deutsch/Kultur/Literatur/Autoren_und_Autorinnen/P/Proust,_Marcel/]

Notez que, dans le cas des URL très longues, l’affichage est tronqué (pour éviter de dégrader votre interface graphique), mais le lien hypertexte pointe vers la bonne adresse.

Il est possible de préciser la langue de la page vers laquelle le lien pointe, ce que les navigateurs afficheront à leur convenance. Pour cela, il faut mettre le code-langue entre accolades.

[Un site en français{fr}->http:///www.adresse.tld]

Cela est particulièrement recommandé lorsque la page de destination n’est pas dans la même langue que votre texte.

Si l’on veut donner beaucoup d’informations sur le lien sans allonger excessivement la zone cliquable, on peut provoquer l’apparition d’une info-bulle en plaçant avant la flèche le signe | suivi du texte souhaité :

[voir ici|Ce lien vous expliquera tout ce qu'il faut savoir->http:///www.adresse.tld]

Ce même système de liens hypertextes facilite, de plus, la création de liens à l’intérieur de votre site sous SPIP. La seule subtilité consiste à repérer le numéro de l’article, de la rubrique, ou de la brève vers laquelle vous voulez mener votre lien hypertexte : NUMERO

lorsque vous « visitez », dans l’espace privé, un article, une brève ou une rubrique, la colonne de gauche contient un pavé indiquant, en gros caractères, ce numéro.

Application spécifique : on peut, là aussi, ne rien spécifier avant la « flèche » ([->aut13]...). SPIP insérera automatiquement les informations nécessaires. Dans le cas d’un document joint ou d’une image, si l’on a indiqué un titre manuellement, c’est ce titre qui sera affiché ; sinon c’est le nom du fichier lui-même qui sera utilisé.

Les raccourcis pour mentionner la langue et créer une info-bulle, expliqués pour les liens externes, fonctionnent également pour les liens internes.

Une note de bas de page est, habituellement, signalée par un numéro placé à l’intérieur du texte, numéro repris en bas de page et proposant un complément d’information.

Dans SPIP, cette fonctionnalité (assez lourde à gérer manuellement en HTML) est automatisée : les notes sont numérotées par SPIP, qui gère également des liens hypertextes à l’intérieur du document pour passer directement de l’appel de note au texte de la note correspondante, et vice-versa.

Une note de bas de page est indiquée, dans SPIP, entre doubles crochets : « Une note[[Voici un complément d'information.]] de bas de page. » sera affiché sous la forme : « Une note [1] de bas de page. »

Il est souvent pratique, dans un forum de discussion, de citer un extrait du message auquel on est en train de répondre. Pour homogénéiser la présentation de telles citations, SPIP propose le raccourci <quote>...</quote>.

<quote>C'est drôlement bien, SPIP.</quote>

Kikou, je suis bien d'accord :-)

Fonctionnalités plus complètes

Les raccourcis qui suivent offrent des fonctionnalités plus puissantes et d’un usage plus spécifique. Si cela est votre premier contact avec les raccourcis de SPIP, il est sans doute inutile que vous tentiez de les apprendre par cœur dès maintenant. Il vous suffit de savoir qu’ils existent ; lorsque vous en aurez réellement besoin, revenez sur cette page, il sera alors beaucoup plus facile pour vous de mémoriser des raccourcis dont vous avez réellement l’utilité.

Pour réaliser des tableaux très simples dans SPIP, il suffit de faire des lignes dont les « cases » sont séparées par le symbole « | » (pipe, un trait vertical), lignes commençant et se terminant par des traits verticaux. Il est impératif de laisser des lignes vides avant et après ce tableau.

Nom	Prénom	Age
Marso	Ben	23 ans
Capitaine		non connu
Philant	Philippe	46 ans
Cadoc	Bébé	4 mois


| {{Nom}} | {{Prénom}} | {{Age}} |
| Marso | Ben | 23 ans |
| Capitaine | | non connu |
| Philant | Philippe | 46 ans |
| Cadoc | Bébé | 4 mois |

Remarquez que toutes les entrées de la première ligne sont placées en gras. SPIP identifie ainsi qu’il s’agit d’une page d’entête, et lui attribue une présentation différente des autres lignes (fond de couleur différente). La présence d’une telle ligne n’est pas obligatoire.

On peut aussi ajouter une légende et un résumé à la table. Ces deux informations sont optionnelles mais sont très importantes pour rendre la table accessible aux mal-voyants, le résumé donnant une meilleure idée du contenu de la table.
Ces informations sont spécifiées entre double trait vertical avant la table comme ceci :


||Légende|Résumé||
| {{Nom}} | {{Date de naissance}} | {{Ville}} |
| Jacques | 5/10/1970 | Paris |
| Claire | 12/2/1975 | Belfort |
| Martin | 1/31/1957 | Nice |
| Marie | 23/12/1948 | Perpignan |

Légende
Résumé
Nom	Date de naissance	Ville
Jacques	5/10/1970	Paris
Claire	12/2/1975	Belfort
Martin	1/31/1957	Nice
Marie	23/12/1948	Perpignan

On peut ne pas spécifier l’une ou l’autre des informations, mais il faut bien penser à mettre un trait vertical simple devant le résumé si vous ne spécifiez que celui-ci : || | résumé ||

Il est également possible de fusionner une case avec d’autres, en réduisant son contenu à |<| pour la fusionner avec la case qui la précède horizontalement ; ou à |^| pour la fusionner avec la case qui la précède verticalement.

||Tableau avec fusion| Raccourci de fusion||
| {{Colonne 1}} | {{Colonne 2}} | {{Colonne 3}} |
| Ligne 1 | L1C2 et L1C3 |<|
| Ligne 2 | L2C2 et L3C2|L2C3|
| Ligne 3 |^| L3C3 |

Fabriquer des listes ou des énumérations

Tableau avec fusion
Raccourci de fusion
Colonne 1	Colonne 2	Colonne 3
Ligne 1	L1C2 et L1C3
Ligne 2	L2C2 et L3C2	L2C3
Ligne 3	L3C3

- Un simple retour à la ligne s’obtient en tapant _ (le trait de soulignement ou underscore) au début de la ligne, suivi d’une espace.

N.B. En typographie classique, le simple retour à la ligne est très rare (limité essentiellement à la poésie). On le confond souvent avec le changement de paragraphe tel qu’il est affiché sur les documents imprimés (sans espacement vertical entre les paragraphes), alors que, par défaut, les butineurs Web insèrent un espacement entre les paragraphes. Beaucoup d’utilisateurs cherchent à reproduire cette caractéristique de l’imprimé (pas d’espacement vertical) en insérant de simples retours à la ligne entre ce qu’ils considèrent être des paragraphes ; cela est un erreur qui risque de nuire à la facilité de maintenance et d’évolution de leur site. La solution consiste à définir, dans les squelettes, une feuille de style (CSS) décrivant le comportement des paragraphes (c’est-à-dire, selon les choix, pas d’espacement vertical entre les paragraphes, indentation de la première ligne...).

- On peut faire des énumérations imbriquées en ajoutant des étoiles après le tiret d’énumération.

-* Ton cheval est:
-** alezan;
-** bai;
-** noir;
-* mais mon lapin est:
-** blanc;
-*** angora; 
-*** ou à poil ras.

- Enfin, on peut faire des listes numérotées en utilisant le # à la place de l’étoile :

-# premier
-# deuxieme
-# troisieme

». Pensez à cliquer sur le lien pour vérifier que le terme entré (nom propre ou nom commun) est correctement orthographié, et qu’il pointe sur une destination valide.

Le glossaire externe prédéfini est Wikipedia qui impose certaines conventions sur les titres. Cette encyclopédie multilingue écrite sur un mode coopératif est ouverte à tous les contributeurs via Internet ; prenez le temps de la connaître et d’y contribuer afin d’enrichir ce fonds de savoir partagé.

Vous pouvez aussi référencer un autre glossaire en plaçant après le terme le signe # suivi du nom G du glossaire. SPIP appliquera alors la fonction glossaire_G sur le terme pour obtenir le lien à insérer. Cette fonction aura été placée dans le fichier mes_options.php. Si le nom G se termine par des chiffres, ceux-ci seront préalablement retirés de ce nom, et formeront le deuxième argument de la fonction, ce qui est très utile pour un glossaire divisé en sections. On écrira donc :

pour indiquer que l’on référence l’explication du terme read dans la section 2 du glossaire nommé man.

Les raccourcis pour mentionner la langue et créer une info-bulle, expliqués pour les liens externes, fonctionnent également pour les glossaires.

Vous pouvez définir des « ancres HTML » afin de pouvoir construire un lien direct vers un point donné au milieu d’une page d’un site SPIP. Il suffit d’introduire le raccourci :

et cela créera une ancre de nom direct. Ainsi, s’il s’agit, par exemple, de l’article 3723, l’URL http://monsite/spip.php?page=article.php&id_article=3723#direct conduira directement à l’endroit de l’article où est situé cette ancre.

Il est à noter que les ancres sont compatibles avec les liens hypertexte à l’intérieur du site. Ainsi, le raccourci « [ce point précis->art123#precis] » conduira vers l’ancre nommée « precis » défini dans l’article 123.

Dans la plupart des cas, le système de notes automatiques indiqué ci-dessus suffit amplement. Cependant, vous pouvez gérer les notes d’une manière non automatique en « forçant » le choix du numéro ou de la mention affichée pour réaliser le lien.

Le principe général consiste à indiquer votre choix de la mention utilisée entre chevrons au début de la note :

Une note «forcée»[[<xxx> Le texte de la note.]]

vous pouvez utiliser les notes numérotées automatiques[[En plaçant le texte de la note entre crochets.]],
- mais aussi forcer la numérotation de la note[[<23> En indiquant le numéro de la note entre les symboles «<» et «>».]],
- utiliser des notes sous forme d'astérisques [[<*> En plaçant simplement une astérisque entre les symboles «<» et «>».]],
- fabriquer des notes sans références (non numérotées); attention, de telles notes ne présentent plus de lien entre la note et l'appel de note[[<> En n'indiquant rien entre les symboles «<» et «>».]],
- donner un nom (en toutes lettres) à une note; cet usage est très répandu pour les références bibliographiques[[<Rab> François Rabelais.]];
- rappeler une note déjà existante[[<23>]] en indiquant le numéro de cette note entre les symboles «<» et «>» et en laissant vide le reste de la note.

Dans certains cas, il peut être utile d’indiquer à SPIP que certaines parties d’un document ne doivent pas être « traitées » par le filtre des raccourcis typographiques : vous ne voulez pas corriger la typographie, vous devez afficher du code source (par exemple en PHP, JavaScript...)...

<HTML>texte à ne 
pas transformer; attention!</HTML>

(ici, notez l’absence d’espaces avant le point-virgule et le point d’exclamation).

Certains utilisateurs de SPIP veulent parfois afficher du code informatique dans leurs pages. Le raccourci <code>...</code> est là pour ça.

 <code><?php     // ceci est du langage php
      echo "bonjour";
</code>

Il existe un autre raccourci pour publier des extraits de code informatique de plusieurs lignes : <cadre>...</cadre>. Cela place le code dans un « formulaire » (ceci est souvent utilisé sur la présente page). L’avantage de cette méthode est de faciliter grandement le copier-coller à partir de votre page Web : il suffit de placer le curseur à l’intérieur du code, de faire « tout sélectionner » (ctrl-A) pour pouvoir copier directement le code. De plus sur de nombreux butineurs, ce cadre permet de bien restituer les tabulations en début de ligne.

class Texte {
	var 
type = 'texte';
	var 
texte;
}

 class Champ {
	var 
type = 'champ';
	var 
nom_champ, 
id_champ;
	var 
cond_avant, 
cond_apres; // tableaux d'objets
	var 
fonctions;
}

[1] Voici un complément d’information.

[2] En plaçant le texte de la note entre crochets.

[23] En indiquant le numéro de la note entre les symboles « < » et « > ».

[*] En plaçant simplement une astérisque entre les symboles « < » et « > ».

En n’indiquant rien entre les symboles « < » et « > ».

[Rab] François Rabelais.

arttitre/Titre, surtitre, soustitre

Titre, surtitre, soustitre

- Le surtitre et le soustitre sont totalement optionnels. Si vous n’en avez pas besoin, laissez-les vides, la présentation du site s’adaptera automatiquement à leur présence ou absence.

Les administrateurs du site peuvent, s’ils le désirent, totalement supprimer l’utilisation du surtitre et/ou du soustitre, via la page « Configuration précise ».

artrub/Choisir la rubrique

Choisir la rubrique

Le menu indique toute la hiérarchie des rubriques (telles qu’elles ont été créées par les administrateurs du site) : sélectionnez celle dans laquelle vous voulez placer l’article.

artdesc/Descriptif rapide

Le descriptif rapide

Le descriptif rapide est utilisé pour la navigation à l’intérieur du site : il permet d’indiquer brièvement, dans les sommaires par exemple, le thème de l’article.

Ce descriptif est optionnel ; de même, on peut le rédiger de la longueur que l’on veut. Cependant, il a été prévu à l’origine pour des textes très courts (une ou deux phrases), qui figureront dans les listes d’articles (sommaires, listes des articles de tel auteur, tri d’articles par mot-clé, réponses du moteur de recherche, etc.).

Les administrateurs du site peuvent, via l’interface de « Configuration précise », désactiver totalement l’affichage du descriptif.

artchap/Chapeau

Le chapeau

Le chapeau, dans le jargon de la presse, désigne le court texte qui « chapeaute » l’article. Son utilisation est optionnelle.

Les administrateurs peuvent, via l’interface de « Configuration précise », désactiver totalement l’utilisation du chapeau.

artvirt/Redirection d’article

Redirection d’article

Cette option permet de créer un « article virtuel » : il s’agit d’un article dont le titre, la date et les auteurs sont enregistrés dans votre site sous SPIP, mais qui pointe vers une autre adresse.

Cette fonctionnalité vous permet de référencer dans votre système SPIP des articles qui ne sont pas réalisés avec SPIP (par exemple pour intégrer à la navigation de votre site sous SPIP des pages réalisées antérieurement à l’installation de SPIP).

Pour indiquer que votre article est un « article virtuel », il suffit d’indiquer, dans la case correspondante, l’URL de l’article-cible (dans le cas d’une référence externe à votre site) ou le raccourci SPIP vers l’article, la rubrique, la brève etc. de votre site (art123, br5, doc28, ...)

Pour supprimer la redirection, il suffit de « vider » la case de redirection (effacer l’adresse de l’article-cible).

arttexte/Texte

Le texte de l’article

Rien de bien compliqué : il s’agit du texte de votre article, comme son nom l’indique.

- Il y a cependant un point qui peut parfois poser problème : la longueur des textes. Pour certains textes très longs (dans notre expérience, à partir de 32 ko), il arrive que ce texte soit tronqué ou carrément refusé lors du transfert dans SPIP. Ce problème n’est pas dû à SPIP, mais aux navigateur Web que vous utilisez. Lorsque vous êtes confronté à un texte « trop long » pour un navigateur, essayez avec un autre logiciel.

- Le texte de l’article se prête particulièrement bien à l’utilisation des raccourcis typographiques de SPIP.

artdate/Date

La date de publication en ligne

La date de l’article correspond, en général, à la date de sa mise en ligne (ou publication sur le site Web).

- Cette date est fixée automatiquement au moment où l’article est validé par un administrateur (donc au moment où il apparaît sur le site public).

artdate_redac/Date de rédaction antérieure

La date de rédaction antérieure

Cette fonction a été ajoutée pour des cas très spécifiques, lorsque SPIP est utilisé pour installer des archives et que ces archives doivent avoir une date de publication différente de la date de mise en ligne.

Il s’agit de pouvoir indiquer qu’un document a déjà fait l’objet d’une précédente publication : article de journal, livre... ou d’une publication future (parution de cet article dans le prochain numéro).

- Par défaut, cette date ne s’affiche pas : le bouton « Ne pas afficher de date de rédaction antérieure » est sélectionné lors de la création de l’article.

- Si l’on veut indiquer une telle date, il faut à la fois sélectionner l’option « Afficher la date » et utiliser les menus déroulants pour la fixer.

Cette date, contrairement à la « date de publication » de l’article, n’est pas calculée automatiquement lors de la validation de l’article. C’est pourquoi elle peut être modifiée à tout moment.

Les administrateurs peuvent, via l’interface de « Configuration précise », désactiver l’utilisation de la date de rédaction antérieure.

artauteurs/Les auteurs

Les auteurs

Lorsqu’un administrateur ou un rédacteur crée un article, il est considéré automatiquement comme l’auteur de cet article. Dans bien des cas il faudra changer les auteurs (quand on intègre au site le texte d’une autre personne, quand un texte ne doit pas être signé, ou encore quand on l’édite à plusieurs...)

Un menu déroulant proposant la liste de tous les rédacteurs du site permet de sélectionner et d’ajouter un nouvel auteur.

Si plus de 50 rédacteurs participent au site, il est difficile de les présenter sous forme de menu déroulant (temps de chargement interminable) ; dans ce cas, le menu déroulant est remplacé par une case de recherche : indiquez le nom de l’auteur que vous voulez ajouter, et cliquez sur « Chercher ». Si plusieurs rédacteurs correspondent à cette recherche, le système vous proposera de sélectionner celui qui vous convient.

A la suite de chaque auteur de l’article, un lien « Retirer l’auteur » permet de simplement effacer cet auteur.

C’est uniquement en tant qu’auteur de cet article précis que le rédacteur est supprimé ; il reste bien entendu présent dans la liste des rédacteurs du site.

Cela se fait en deux étapes : il faut simplement ajouter le nouvel auteur, et retirer le précédent (voir ci-dessus).

- Notez finalement que les administrateurs ont beaucoup plus de possibilités sur cette liste d’auteurs que les rédacteurs. Les rédacteurs ne peuvent pas, en particulier, se retirer eux-mêmes d’un article. Si un rédacteur veut publier un article anonyme (sans auteur), il doit demander à un administrateur d’effectuer cette opération.

logoart/Logo de l’article

Logo de l’article

SPIP vous permet d’installer un logo correspondant à l’article. De cette façon, dans l’interface de navigation du site public, il sera possible d’afficher un bouton graphique menant à l’article.

Pour un article, il est possible :
- de ne pas utiliser de logo ;
- d’installer un logo graphique simple ;
- d’utiliser un logo animé gérant le « survol » (logo « 2 positions » : le logo change lorsque que la souris le survole).

Lorsque vous créez vos images (avec votre logiciel habituel), vous devez les créer à l’un des formats suivants :
- GIF (le fichier GIF peut être un « GIF animé ») ;
- JPEG ;
- PNG.

Veillez particulièrement à ce que le nom de vos fichiers ait une terminaison indiquant leur format : .gif, .jpg ou .png. Le nom du fichier n’a aucune importance, à condition de ne pas oublier cette terminaison.

Si vous créez un bouton gérant le « survol », créez deux fichiers graphiques différents (un pour le bouton « normal », et un autre fichier s’affichant lorsque le bouton est survolé par la souris) : il convient alors que ces deux fichiers aient exactement la même taille (en pixels).

Pour ajouter un bouton, une interface est disponible dans la colonne de gauche de l’article, sous la mention « LOGO DE L’ARTICLE ».

Selon la version de votre navigateur, cliquez sur le bouton « Browse », « Sélectionner », « File », « Fichier »... ce qui déclenche l’ouverture d’une interface permettant de sélectionner, sur votre disque dur, le fichier graphique correspondant à votre bouton.

Une fois ce fichier sélectionné, cliquez sur le bouton « Télécharger ». Votre logo s’affiche alors. Il est suivi d’un bouton « Supprimer le logo », qui vous permet, simplement, de supprimer ce logo.

Si vous ne comptez pas obtenir un logo gérant le survol, aucune autre opération n’est nécessaire.

Il peut arriver que vous vouliez remplacer le logo par un autre fichier. Cela se fait en deux étapes :
- commencez par « Supprimer le logo » : l’interface précédente, dotée du bouton « Télécharger », apparaît à nouveau ;
- téléchargez le nouveau fichier, selon la procédure déjà décrite.

Du fait du fonctionnement des butineurs, l’image qui s’affiche alors est erronée, puisqu’il s’agit encore de la version précédente (l’image est « en cache » de votre navigateur). Cliquez sur cette image (avec le bouton droit de votre souris, ou en maintenant la touche « ctrl » sur Macintosh) afin de faire apparaître un menu déroulant local : sélectionnez l’option « Recharger cette image » (ou, en anglais, « Reload image »). La nouvelle version de votre logo devrait alors s’afficher.

Après l’installation du premier fichier (logo simple), l’interface affiche non seulement le logo que vous avez installé sur le serveur, mais ajoute une seconde interface, sous le titre « LOGO POUR LE SURVOL ». C’est par cette interface que vous pouvez indiquer le second fichier nécessaire à la gestion du survol.

Si, lorsque vous avez installé les deux fichiers, vous supprimez le premier (le bouton « simple »), l’interface du second logo ne s’affiche plus. En effet, en l’absence du premier logo, il n’y a plus de raison de gérer un quelconque « survol » !

Aucune intervention dans le « texte » de votre article n’est nécessaire. Lors de l’affichage sur le site public, la gestion des logos des rubriques est entièrement automatique. Le code HTML sera généré en fonction de la taille du logo, et la fonction de survol en JavaScript sera également créée automatiquement.

artstatut/Le statut de l’article

Le statut de l’article

Le statut de l’article correspond à sa situation éditoriale sur le site. L’article peut être :
- en cours de rédaction ;
- proposé à l’évaluation ;
- publié en ligne ;
- à la poubelle ;
- refusé.

Ces étapes, que seuls les administrateurs peuvent modifier, permettent la gestion du site.

Lorsqu’il est créé, un article est naturellement considéré comme étant « en cours de rédaction » : ses auteurs sont en train de le rédiger, de le modifier...

L’article « en cours de rédaction » n’est visible que par les auteurs de l’article et par les administrateurs. Les autres rédacteurs du site n’y ont pas accès.

Lorsque l’auteur juge que son article est prêt, il le « propose » aux autres participants, afin qu’il soit éventuellement discuté collectivement, avant d’être validé (publié en ligne) ou refusé.

Lorsque l’article est « proposé à l’évaluation », il est indiqué sur la page « à suivre » de tous les utilisateurs de l’espace privé, qui sont ainsi invités à venir le discuter par l’intermédiaire du forum de discussion interne placé à la suite de l’article.

Un tel article est alors visible par tous les rédacteurs. En revanche, il ne peut être modifié que par son auteur ou un administrateur.

Après avoir été éventuellement discuté par les rédacteurs (pendant la phase de « proposition »), un article peut être « validé », c’est-à-dire publié en ligne par un administrateur. Dès lors, tous les visiteurs du site public y ont accès.

Lorsqu’un article est publié en ligne, seuls les administrateurs peuvent le modifier. Son auteur doit donc demander à un administrateur s’il veut y porter des corrections.

Un article « proposé » qui ne conviendrait pas à la ligne éditoriale du site peut être « refusé » si les administrateurs refusent de le publier en ligne.

Un article « refusé » n’est plus visible que par son auteur et par les administrateurs.

Un article « refusé » ne peut cependant plus être modifié par son auteur, qui ne pourra donc pas non plus le reproposer à la publication. Dans le cas d’un article qui demanderait des retouches, on préférera donc repasser l’article « en cours de rédaction » au lieu de le « refuser » purement et simplement, afin que son auteur puisse le modifier et le représenter ultérieurement.

Un article « à la poubelle » n’est plus visible dans l’espace privé, même par les administrateurs. Attention donc, cette option est « violente » : l’article disparaît complètement. Une fois mis à la poubelle l’article sera automatiquement supprimé de la base de données au bout de 24 ou 48 heures.

Cette option est donc réservée aux articles créés par erreur, que l’on veut totalement détruire. On préférera, le plus souvent, l’option « Article refusé », qui est moins définitive.

- Notez enfin que les administrateurs peuvent à tout moment modifier le statut d’un article. Un article publié peut ainsi être repassé en « rédaction ». Cependant, une fois un article publié en ligne, n’abusez pas de ces changements de statut : vous obtiendriez en effet un site « à trou », avec des pages qui apparaissent et disparaissent, ce qui est très pénalisant pour le visiteur.

artprop/Proposer son article

Proposer un article

Lorsque l’article est « en cours de rédaction » (voir la rubrique « Le statut de l’article »), il est suivi d’un bouton « Demander la publication de cet article ».

Cela signifie que l’article est alors « Proposé à l’évaluation », c’est-à-dire présenté à tous les autres rédacteurs, qui seront invités à le commenter, dans l’attente d’une validation (publication) ou d’un refus de la part des administrateurs.

Attention : une fois l’article « proposé à l’évaluation », il n’est plus possible à l’auteur de revenir sur sa décision et de repasser le texte « en cours de rédaction ». Donc l’opération « Demander la publication de cet article » ne doit être effectuée par l’auteur qu’une fois qu’il considère son texte comme complet et définitif. Seul un administrateur peut alors remettre le texte « en cours de rédaction ».

Les rubriques

rubhier/Une structure hiérarchisée

La structure hiérarchique des rubriques

La structure des rubriques constitue l’ossature de votre site ; c’est elle qui va déterminer son interface, le mode de navigation, les relations entre articles et entre brèves...

Dans SPIP, cette structure est de type hiérarchique : une rubrique peut contenir des sous-rubriques qui, elles-mêmes, contiennent des sous-rubriques, etc.

Dans l’exemple ci-dessus, on comprend bien que la rubrique 222 dépend de la rubrique 22, qui elle-même dépend de la rubrique 2, laquelle ne dépend d’aucune autre rubrique (dans ce cas, on considérera que la rubrique 2 se trouve à la racine du site).

Par structure hiérarchisée, on entend le fait qu’une rubrique ne dépend que d’une seule autre rubrique (et non de plusieurs), et qu’une rubrique ne peut dépendre d’une de ses propres sous-rubriques (c’est-à-dire : SPIP n’autorise pas les structures circulaires). Cette structure, très classique, a été retenue en raison de sa simplicité d’utilisation.

Seuls les administrateurs peuvent créer, modifier ou supprimer des rubriques.

rubrub/Choisir la rubrique

Choisir la rubrique

Le fonctionnement de ce menu déroulant est très simple : le menu indique toute la hiérarchie des rubriques (telles qu’elles sont créées par les administrateurs du site), il suffit de sélectionner celle dans laquelle on veut placer la sous-rubrique.

Vous pouvez, par l’intermédiaire de ce menu déroulant, faire dépendre la présente rubrique d’une autre rubrique. Dans ce cas, il faut comprendre que l’ensemble des sous-rubriques contenues dans la présente rubrique se « déplacent » avec elle dans la hiérarchie du site. De la même façon, les articles contenus dans cette rubrique et ses sous-rubriques se déplacent avec elle.

rublogo/Logo de la rubrique

Logo de la rubrique

Vous pouvez installer sur votre site un logo pour chaque rubrique. Ce logo peut être soit un logo unique (image fixe), soit un logo à deux positions gérant le survol de la souris.

L’installation d’images pour ce logo de rubrique se déroule exactement de la même façon que pour le logo d’un article.

N.B. Les logos des rubriques ont un fonctionnement récursif : en l’absence d’un logo pour une rubrique donnée, SPIP va tenter de lui substituer le logo d’une rubrique dont elle dépend.

Dans la hiérarchie ci-dessus, en l’absence d’un logo pour la rubrique 221, SPIP lui substituera (uniquement pour la visite du site public) le logo de la rubrique 22 ou encore, s’il n’y a pas de logo pour cette rubrique, celui de la rubrique 2. Sinon, SPIP affichera le logo installé à la racine du site.

Notez encore que, si le webmestre l’a programmé ainsi, le logo d’une rubrique pourra être utilisé comme logo de substitution pour les articles qu’elle contient.

Les brèves

breves/Les brèves

Les brèves

Les brèves constituent une méthode simple et rapide de publication dans SPIP. Contrairement aux articles, les brèves sont constituées d’un nombre très réduit d’informations : un titre, un texte et un lien hypertexte. Ainsi, le système de brève est-il idéal pour un suivi de l’actualité, une revue de presse en ligne, etc.

brevesrub/Choisir la rubrique

Position des brèves dans la structure du site

Afin de simplifier leur utilisation (et pour éviter que les brèves ne fassent double-emploi avec les articles), l’intégration des brèves dans la hiérarchie des rubriques est réduite au strict minimum : les brèves dépendent uniquement des rubriques situées à la racine du site.

Dans notre exemple, on pourra placer des brèves dans les rubriques 1 et 2, mais pas dans leurs sous-rubriques (contrairement aux articles, que l’on peut placer n’importe où). De ce fait, la présentation de la page des brèves se fait directement en fonction de ces grandes rubriques, et le menu déroulant permettant d’indiquer la position des brèves est très court.

breveslien/Le lien hypertexte

Le lien hypertexte des brèves

Afin de faciliter l’utilisation des brèves dans le cadre d’une revue de presse en ligne, chaque brève peut recevoir l’indication d’un lien hypertexte. Il suffit d’indiquer le titre du site ou de l’article référencé, et son adresse (URL).

N. B. Ce système de lien n’empêche pas d’intégrer des liens hypertextes dans le corps du texte de la brève, mais le lien hypertexte séparé permet au webmestre du site de lui appliquer un traitement graphique spécifique.

brevesstatut/Le statut de la brève

Le statut de la brève

La gestion d’une brève est plus simple que celle d’un article. Une brève n’a pas d’auteur. Son statut est soit « Proposée », « Validée » ou « Refusée ». Seuls les administrateurs peuvent en modifier le statut.

Les brèves « proposées » sont signalées sur la page « A suivre » : tous les rédacteurs peuvent les consulter et les modifier. Les administrateurs se voient proposer deux boutons - permettant de les valider ou de les refuser.

Les brèves « validées » sont celles qui apparaissent sur le site public. Seuls les administrateurs peuvent dès lors les modifier.

Une brève « refusée » n’est pas publiée sur le site public, et seuls les administrateurs peuvent y accéder dans le site privé.

breveslogo/Le logo de la brève

Logo de la brève

Vous pouvez installer sur votre site un logo pour chaque brève. Ce logo peut être soit un logo unique (image fixe), soit un logo à deux positions gérant le survol de la souris.

L’installation d’images pour ce logo de brève se déroule exactement de la même façon que pour le logo d’un article.

Images et documents

ins_img/Insérer des images

Insérer des images dans le texte

SPIP vous offre la possibilité d’illustrer vos articles et vos brèves avec des images. Cela s’effectue en plusieurs étapes : vous devez envoyer le fichier de votre image vers le site, puis insérer l’image à l’intérieur du texte.

Lorsque vous créez vos images (avec votre logiciel habituel), vous devez les créer à l’un des formats suivants :
- GIF (extension .gif),
- JPEG (extension .jpg),
- PNG (extension .png).

Veillez particulièrement à ce que le nom de vos fichiers ait une terminaison indiquant leur format : .gif, .jpg ou .png. Si vous installez un fichier dont le nom ne contient pas cette extension, le système ne saura pas utiliser l’image.

Avant de pouvoir insérer vos images à l’intérieur du texte, il faut bien entendu installer ces images sur le serveur. Cela se fait, dans SPIP, par l’interface graphique.

Lorsque vous « modifiez » un article ou une brève, la colonne de gauche vous propose une interface intitulée : « Ajouter une image ». Cela se présente sous la forme d’un champ suivi d’un bouton nommé, suivant les navigateurs, « parcourir », « Browse », « Sélectionner », « File », « Fichier »...

Lorsque vous cliquez sur ce bouton, une interface s’ouvre, vous permettant de visiter votre disque dur et d’indiquer quel fichier graphique vous voulez sélectionner.

Si l’opération a réussi, votre image apparaît dans la colonne de gauche, complétée de plusieurs indications...

Une fois votre image envoyée au serveur, une case apparaît sur la gauche de l’écran. Il y a là toutes les informations nécessaires qui la concernent. (Une partie de ces informations apparaît masquée, cliquer sur le triangle pour « déplier » la boîte d’information.)

- Affichage sous forme de vignette. Une prévisualisation de votre image apparaît. Si l’image est de grande taille (plus de 200 pixels de large), c’est une version de taille réduite qui est affichée.

- Raccourcis SPIP. Voir ci-après : SPIP vous rappelle les 3 « raccourcis » qui vous permettent d’insérer cette image à l’intérieur de votre texte. Notez que chaque image est « numérotée » ainsi : « IMG1 », « IMG2 »... Ces « raccourcis » sont utilisés dans la troisième étape.

- Taille de l’image. Juste au-dessus de l’image, la largeur et la hauteur de votre image (en pixels - ou « points ») sont rappelées.

- Titre et description de l’image. Vous pouvez, si vous le désirez, indiquer un nom et une description pour chaque image. Par exemple une explication, ou une mention du copyright du photographe...

- Supprimer cette image. Comme son nom l’indique, le bouton « Supprimer cette image » permet d’effacer ce fichier, si vous avez fait une erreur de manipulation, ou si vous décidez finalement de ne pas utiliser l’image dans ce texte. Il est conseillé d’effacer les images inutilisées, afin d’éviter d’encombrer votre serveur avec des fichiers inutiles.

Vous pouvez recommencer l’opération avec autant d’images que vous le désirez (un article ou une brève peuvent contenir autant d’images que nécessaire).

A ce stade, les fichiers graphiques sont bien présents sur le serveur, mais il reste à indiquer à quel endroit de votre texte vous voulez les insérer. Pour cela, inutile de faire du HTML, SPIP vous propose un « raccourci » permettant d’insérer votre image simplement.

Pour chaque image, voyez la mention des 3 raccourcis :
- <img1|left>
- <img1|center>
- <img1|right>

Recopiez l’un de ces raccourcis (le nombre correspond au numéro de l’image, il change donc pour chaque fichier), et recopiez-le à l’intérieur de la case « Texte », là vous désirez le situer dans votre article. « left » aligne l’image à gauche, « right » à droite, et « center » place votre image au centre du texte.

Lors de l’affichage à l’écran, SPIP remplacera ces raccourcis par le code HTML correspondant, en calculant automatiquement la taille des images.

Si vous avez indiqué un titre et/ou une description, les mentions sont remplacées par :
- <doc1|left>
- <doc1|center>
- <doc1|right>

Elles s’utilisent de la même façon que ci-dessus ; cependant, lorsque vous insérez un « raccourci » de ce type, SPIP insère dans votre texte non seulement l’image, mais le titre et la description que vous lui avez donnée. Votre image apparaît ainsi avec, éventuellement, une explication et des mentions de copyright, le nom de l’artiste, etc.

ins_doc/Joindre des documents

Joindre des documents multimédia

L’interface de SPIP vous permet de proposer sur votre site des fichiers multimédia (son, vidéo, textes...).

Les rédacteurs peuvent joindre des documents aux articles. Ces documents peuvent être soit présentés à la suite du texte (à la façon de « pièces jointes »), soit présentés à l’intérieur du texte sous la forme d’une vignette de prévisualisation.

Les administrateurs du site peuvent, de plus, installer des documents directement dans les rubriques.

Notez bien la différence importante entre ces deux utilisations : joints aux articles, les documents sont des « pièces jointes », qui n’ont pas d’intérêt sans l’article auquel ils sont associés (dans la navigation dans le site, on peut consulter de tels fichiers à partir des articles) ; lorsqu’ils sont installés directement dans les rubriques, les documents deviennent des éléments du site comparables aux articles et aux brèves, et non plus des compléments d’information.

L’installation des fichiers sur le serveur se fait au travers de l’interface « Joindre un document » pour les articles, et « Publier un document dans cette rubrique » pour les rubriques.

Vous remarquerez que, pour les articles, cette interface apparaît à deux endroits différents : en bas de la page de chaque article, et dans la colonne de gauche (sous les images) lorsque vous modifiez un article. Ces interfaces ont exactement la même fonction, mais vous utiliserez l’une ou l’autre en fonction de vos besoins. Pour les rubriques, l’installation des documents se fait sur la page de la rubrique concernée.

Avant d’installer vos fichiers, vous devez les créer sur votre ordinateur. L’interface d’envoi des documents vous rappelle la liste des formats autorisés sur ce système. Veillez absolument à nommer vos fichiers avec la terminaison correcte (par exemple, « xxxxxx.mp3 » pour un fichier au format MP3.

L’interface est la même que pour les images : le bouton « Fichier », ou « File », ou « Parcourir », « Browse » (selon les navigateurs) ouvre une fenêtre qui vous permet de sélectionner le fichier sur votre disque dur. Une fois ce fichier sélectionné, cliquez sur « Télécharger » pour envoyer le fichier. Attention : selon la taille de votre fichier, cette opération peut prendre du temps. Notez aussi que, selon les réglages de l’hébergeur de votre site, les fichiers trop gros pourront être refusés ; dans ce cas, vous pourrez contourner cette limitation en installant vos fichiers par FTP.

Une fois le fichier transféré sur le serveur, une boîte d’information apparaît. Plusieurs opérations peuvent y être réalisées.

Cette notion est très importante : contrairement aux images, que l’on insère dans le corps du texte, les documents n’apparaissent pas directement. Une vignette de prévisualisation est présentée au visiteur, sur laquelle il pourra cliquer pour obtenir le document correspondant.

La partie supérieure de la boîte d’information vous permet de choisir la vignette de prévisualisation. Vous pouvez opter pour une vignette par défaut, ou installer un logo personnalisé.

La vignette par défaut est installée automatiquement par le système, en fonction du format du document. L’avantage de laisser une telle vignette est que la présentation des documents d’un même type sur l’ensemble de votre site sera uniforme.

Si vous préférez, vous pouvez installer un logo (de taille réduite de préférence, et au format GIF, JPG ou PNG), qui apparaîtra à la place de la vignette par défaut. Une fois un tel logo installé, un lien « Supprimer la vignette personnalisée » vous permettra de revenir à la vignette par défaut si nécessaire.

- Dans la page de modification des articles, les « raccourcis » vous permettant d’insérer le document dans le corps du texte sont présentés, identiques à ceux des images.

- La partie inférieure vous permet de donner un titre et de fournir un descriptif pour votre document. Inutile d’indiquer ici le format et le poids du fichier multimédia, cette information sera fournie automatiquement par le système de publication.

- Enfin, le bouton « Supprimer ce document » permet d’effacer les documents inutiles. Notez bien : il est impératif de supprimer les documents non désirés, faute de quoi ils apparaîtront sur le site public.

- Dans le cas des documents installés dans les rubriques, vous pouvez de plus modifier la date de mise en ligne du document (sur le même principe que vous modifiez la date de publication d’un article ou d’une brève). Une fois ces réglages effectués, les documents des rubriques sont immédiatement disponibles sur le site public (il n’est pas nécessaire de les « valider » comme les brèves ou les articles).

Pour les documents associés aux articles, vous pouvez vous contenter de les installer et de préciser les informations (étapes 1 et 2 ci-dessus). Lorsque vous publierez l’article, ces documents apparaîtront à la suite du texte sous la forme d’une liste de documents joints.

Cependant, vous pouvez également décider d’insérer les vignettes de prévisualisation à l’intérieur du texte. Vous obtiendrez ainsi des images cliquables à l’intérieur de l’article.

Ici, la procédure est exactement la même que pour les images, à la différence près que les vignettes seront des éléments cliquables. Insérez un raccourci de la forme <imgxx|yy> ou <docxx|yy> selon que vous voulez afficher uniquement la vignette, ou bien le titre et le descriptif.

Notez bien : les documents que vous aurez installé à l’intérieur du texte n’appaîtront plus sous l’article. Pour les articles, il y a donc deux emplacements où apparaissent les documents : à l’intérieur du texte (vignette cliquable), ou à la suite de l’article sous la mention « Document joint ».

Certains formats de fichiers multimédia sont conçus pour être affichés directement dans une page Web (par exemple une vidéo insérée directement dans l’article).

Pour pouvoir insérer de tels documents dans le corps de l’article, non plus sous forme de vignette cliquable, mais en tant qu’animation multimédia, vous devez indiquer ses dimensions : largeur et hauteur absolument supérieures à zéro (pour les fichiers audio, on choisira pour largeur la dimension que l’on souhaite attribuer au curseur de défilement, et une hauteur réduite, par exemple 25 pixels).

Notez bien : les cases vous permettant d’indiquer les dimensions n’apparaissent que pour les documents dont le fichier correspond à certains formats acceptés par SPIP pour l’intégration à l’intérieur des articles (notamment : avi, quicktime, real, flash).

Une fois ces dimensions fixées, un raccourci SPIP supplémentaire vous sera proposé, de la forme <embxx|yy> (pour mémoire : « embed »).

Si vous connaissez bien le fonctionnement de ces types d’inclusion, sachez que vous pouvez ajouter des paramètres supplémentaires, par exemple :

<emb54|center|autostart=true|quality=high>

ins_upload/Installer des fichiers par FTP ou SSH

Installer des fichiers par FTP ou SCP

Certains serveurs interdisent l’envoi de fichiers au travers d’une interface Web, ou en limitent la taille. Et même quand cela est possible, il peut être pénible d’envoyer des fichiers lourds de cette façon. SPIP permet de contourner ces limitations en installant directement les fichiers que vous souhaitez utiliser comme images ou comme documents par FTP ou SCP.

Cette opération est donc évidemment réservée aux personnes qui possèdent de tels droits de connexion vers les disques du serveurs HTTP.

L’emplacement du dossier où déposer vos fichiers dépend de votre statut sur le site et de la version de SPIP installée. Avant SPIP 1.9 ce dossier était le sous-dossier upload de ecrire, et SPIP ne faisait apparaître son contenu qu’aux seuls administrateurs principaux du site. Depuis SPIP 1.9, le dossier de transfert est un sous-dossier de tmp, il se nomme toujours upload et SPIP ne fait apparaître l’intégralité de son contenu qu’aux seuls administrateurs principaux du site. Mais de plus, il est prévu pour avoir autant de sous-dossiers que d’administrateurs restreints, le nom de ces dossiers étant le login de ces administrateurs. Pour un administrateur restreint, SPIP ne fera apparaître que le contenu du dossier à son nom.

Après installation de vos fichiers par FTP ou SCP, pensez à vérifier qu’ils sont bien accessibles en lecture par le serveur HTTP (tant les fichiers eux-mêmes que le répertoire qui les contient).

Cela fait, un menu déroulant apparaîtra automatiquement après l’interface de téléchargement des fichiers par le Web, vous proposant la liste des fichiers contenus dans ce dossier. Noter que SPIP n’affichera en fait que les fichiers réputés sans danger, ce qui exclut les fichiers non répertoriés dans la nomenclature MIME, en particulier les fichiers sans extension. On peut contourner l’interdiction en prenant une extension autorisée (par exemple renommer x.php en x.txt), ce qui permettra de charger le fichier tout en empêchant son utilisation abusive sur le site. On pourra utiliser le formulaire de description du document pour préciser quel était son nom d’origine.

Grâce à ce menu, vous pourrez sélectionner le fichier qui vous intéresse, et valider votre choix. Si l’opération est réussie, pensez à nettoyer votre dossier de transfert en supprimant ce fichier (le système en a créé une copie à un autre endroit du serveur, votre fichier d’origine n’est donc plus utile), afin de ne pas allonger indéfiniment la liste du menu déroulant et la place occupée sur le disque.

Si vous installez plusieurs fichiers à la fois dans votre dossier de transfert, une fonctionnalité supplémentaire vous est proposée dans l’interface du site : vous pourrez installer tous ces fichiers en une seule opération. Cela peut se révéler pratique pour créer rapidement des portfolios.

Collection d’images et de documents

On peut facilement ajouter d’un coup une collection d’images ou de documents en téléchargeant une archive au format zip les contenant tous.

SPIP proposera alors d’ajouter l’archive telle quelle à l’article, ou de déballer celle-ci pour associer à l’article tous les documents et images qu’elle contient, ou encore les deux à la fois. En cas de déballage, seront bien entendu appliquées les mêmes règles d’exclusion que ci-dessus en ce qui concerne les fichiers potentiellement dangereux. On pourra de plus demander que le nom de chaque fichier soit automatiquement recopié comme nom de la pièce ainsi jointe.

Les mots-clés

mots/Principe des mots-clés

Les mots-clés

L’une des limitations importantes de SPIP est sa structure hiérarchique : chaque article ne peut se trouver que dans une seule rubrique, ce qui pose parfois des difficultés de classement.

Les mots-clés offrent un moyen de navigation transversal à l’intérieur du site. En associant un ou plusieurs mots-clés à un article, on dispose en effet d’un moyen de créer des liens avec d’autres articles aux thèmes similaires, mais situés dans d’autres rubriques.

Les mots-clés n’ont réellement d’intérêt que si chaque mot est associé à plusieurs articles, afin de pouvoir relier ces différents articles entre eux.

Fréquemment, la structure des rubriques, si elle est bien conçue, permet de se passer des mots-clés : les articles de thèmes similaires se trouvent simplement dans les mêmes rubriques, il est alors inutile d’ajouter des mots-clés pour indiquer le thème de chacun. Les administrateurs peuvent donc, dans la page de Configuration précise, désactiver totalement l’utilisation des mots-clés.

artmots/Les mots-clés

Les mots-clés

Afin de diversifier la navigation dans le site, il est possible d’associer des mots-clés aux articles, aux brèves et aux sites référencés. Ainsi le visiteur du site pourra non seulement naviguer de rubrique en rubrique, mais également d’un article traitant d’un thème (indiqué par un mot clé) à un autre article associé au même mot-clé.

Il est possible d’indiquer, pour chaque article, brève ou site, autant de mots-clés que nécessaire.

Un menu déroulant indique la totalité des mots-clés du site. Son utilisation est très simple. Attention : lorsqu’il existe plus de 50 mots-clés, ce menu déroulant est remplacé par un moteur de recherche : indiquez le mot désiré, et cliquez sur « Recherche ».

N. B. Seuls les administrateurs peuvent créer des mots-clés, à partir de la page qui est consacrée à leur gestion (bouton « Les mots-clés » dans l’interface de navigation supérieure).

Les administrateurs peuvent désactiver l’utilisation des mots-clés pour l’ensemble du site, via l’interface « <a href="./?exec=aide_index&aide=confart" target="_top">Configuration précise ».

motsgroupes/Les groupes de mots

Les groupes de mots

Lorsque l’on utilise beaucoup de mots-clés, il peut devenir difficile de les manipuler rapidement. C’est pourquoi on peut créer des groupes réunissant ces mots. L’interface devient alors plus claire (par exemple, un groupe « Pays » regroupera « Namibie », « Allemagne », « Pérou », tandis qu’un groupe « Thèmes » regroupera « Chômage », « Poésie », « Animaux »...).

Les sites référencés

reference/Référencer un site

Sites référencés

SPIP propose un système complet permettant de gérer des listes de liens vers d’autres sites. Ce système est très complet et permet notamment :
- de regrouper ces listes dans des rubriques (dans les mêmes rubriques que des articles, ou des rubriques spécifiques dédiées à cet usage, à la façon d’un annuaire de liens) ;
- d’attribuer un logo à chaque site ;
- d’attribuer des mots-clés pour chaque site référencé ;
- d’ajouter un descriptif personnalisé pour chaque site.

On peut de plus, pour les sites qui l’autorisent, récupérer automatiquement les derniers articles publiés (voir « Les sites syndiqués »).

Un bouton « référencer un nouveau site » dans la page de chaque rubrique de votre site vous permet d’indiquer un nouveau site.

La méthode « traditionnelle » consiste à indiquer le nom du site, l’URL de cette page, puis d’insérer une description. Il est également possible de choisir la rubrique dans laquelle ce référencement sera inséré dans votre propre site.

Un cadre en bas de page vous permet de gérer, éventuellement, la syndication de contenu. Pour plus de précisions sur ce sujet, voyez l’explication sur les sites syndiqués. Pour un référencement simple, il suffit de laisser l’option « Pas de syndication ».

Lors de la création d’un nouveau référencement de site, un cadre apparaît en haut de page vous permettant de référencer rapidement un site, sans indiquer vous-même son titre et son descriptif. Pour cela, il vous suffit d’indiquer l’URL de la page à référencer et de valider. Dans la mesure du possible, SPIP va récupérer automatiquement à cette adresse le titre de la page et un descriptif. Vous pourrez ultérieurement modifier ces informations.

Dans la page de « Configuration précise du site », les administrateurs peuvent indiquer que seuls les administrateurs peuvent proposer des sites, ou les rédacteurs, ou même les visiteurs du site (dans ce cas, un formulaire sur le site public permettra aux visiteurs de proposer des sites).

Dans tous les cas, seuls les administrateurs pourront valider ces propositions de référencement. Lorsqu’un référencement de site est proposé, tous les participants à l’espace privé peuvent discuter dans un forum lié à chaque site de la pertinence du référencement.

rubsyn/Sites syndiqués

Sites syndiqués

Les sites fabriqués à l’aide d’un système de publication automatique (tel SPIP ou wordpress) peuvent facilement créer un fichier indiquant en permanence la liste de leurs dernières publications. Il existe en particulier un format standardisé pour un tel fichier, intitulé « fichier backend » (au format RSS ou Atom).

Ce fichier peut être facilement analysé de manière automatique, afin de récupérer en permanence la liste des nouveautés de tels sites. De cette manière, SPIP vous permet d’afficher sur votre propre site la liste des derniers articles publiés sur d’autres sites.

Pour chaque site référencé dans vos propres rubriques, vous avez la possibilité d’indiquer qu’il faut récupérer la liste des derniers articles publiés sur ce site. Cela, évidemment, si le site référencé propose un fichier backend.

Pour les sites gérés sous SPIP ou wordPress, ces fichiers backend sont faciles à localiser : il s’agit tout simplement du fichier situé à la racine du site, et portant le nom « backend.xml » (éventuellement, « backend.php » ou « spip.php ?page=backend »). Par exemple, pour uZine (http://contrib.spip.net), l’adresse du fichier backend est :

Notez enfin que L’autre portail fournit de tels fichiers pour les sites qu’il référence, même si ces sites ne comportent pas leur propre système de backend. Vous trouverez sur cette page une trentaine de fichiers backend pour les sites référencés par L’autre portail, ainsi qu’une poignée de fichiers thématiques.

Lorsque vous référencez un site dans une de vos rubriques, en plus d’indiquer le nom du site, l’URL de sa page d’accueil et une description, vous pouvez choisir de le syndiquer (un site syndiqué est donc avant tout un site référencé, pour lequel on demande à SPIP de récupérer la liste des dernières publications).

Pour cela, sélectionnez l’option « Syndication » et indiquez l’adresse du fichier backend du site désiré. Après validation, un message vous indiquera immédiatement si la syndication a fonctionné correctement.

Si la syndication a échoué :
- vérifiez l’URL que vous avez indiquée pour ce site ;
- vérifiez que le site que vous souhaitez syndiquer est actuellement accessible en ligne.

La fonction de référencement rapide d’un site (indiquer directement l’URL d’un site, SPIP se chargeant de récupérer automatiquement les informations nécessaires) est particulièrement adaptée aux sites syndiqués. En effet, au lieu d’indiquer lors du référencement rapide l’URL de la page d’accueil, préférez alors indiquer l’URL du fichier backend de ce site : SPIP récupèrera automatiquement un grand nombre d’informations et procèdera directement à la syndication.

Lorsque la syndication fonctionne, SPIP affiche la liste des derniers articles publiés par ce site. Voyez la page de l’aide consacrée à la gestion de ces liens.

SPIP fabrique automatiquement le fichier backend de votre propre site. Cependant, n’oubliez pas de paramétrer le nom et l’adresse de votre site sur la page de configuration précise.

artsyn/Articles syndiqués

Les articles syndiqués

Lorsque vous réclamez la syndication d’un site, SPIP affiche la liste des derniers articles publiés sur ce site, sous la mention « Articles syndiqués tirés de ce site ».

Pour chaque article, SPIP indique :
- le titre de l’article (il suffit de cliquer sur ce titre pour accéder à l’article sur son site d’origine) ;
- éventuellement les auteurs des articles ;
- éventuellement un descriptif de l’article.

Ces informations, tirées automatiquement du site référencé, ne peuvent pas être modifiées.

De plus, pour chaque article, un bouton « bloquer ce lien » vous permet d’en bloquer l’affichage sur votre propre site (parce qu’un article ne vous convient pas, parce qu’une erreur rend ce lien inopérant...). Vous pourrez à tout moment rétablir l’affichage de cet article sur votre site.

Il est possible de demander que chacun des futurs liens en provenance du site soit a priori bloqué. Les articles ainsi récupérés ne s’afficheront qu’une fois que vous les aurez, un par un, validés « à la main ».

confhttpproxy/Utiliser un proxy

Utiliser un proxy HTTP

Si votre site se situe derrière un pare-feu (firewall), il peut être nécessaire de configurer un proxy HTTP pour aller chercher sur Internet les nouveautés de sites syndiqués.

Ce proxy doit autoriser les requêtes vers l’extérieur sans authentification aucune.

Indiquez, dans la configuration de votre site (section « fonctionnalités de SPIP »), le proxy au format suivant :

où nomproxy est le nom du serveur faisant office de proxy, et port le numéro de port TCP (le plus souvent 3128, 8080, voire 80) sur lequel envoyer les requêtes.

Attention : ce réglage est global : SPIP ira chercher tous les sites syndiqués à travers ce proxy. Depuis SPIP 1.9, il est possible de préciser que certains hôtes ne doivent pas utiliser ce proxy. Mais pour les versions antérieures ou pour des réglages encore plus fins, il faudra impérativement vous tourner vers l’administrateur de votre réseau.

La messagerie interne

messut/

Les messages entre utilisateurs

SPIP facilite l’envoi de messages entre utilisateurs du site, sans passer par l’échange d’emails.

Lorsqu’un message est « envoyé » par un utilisateur à un ou plusieurs autres utilisateurs, il devient un forum de discussion privé. Ainsi, une fois un message envoyé, une discussion peut avoir lieu, sous la forme d’un forum placé sous le texte de ce message. Dans SPIP, on peut donc considérer qu’un message est également un forum privé (c’est-à-dire qu’il est inutile de s’envoyer une multitude de messages pour discuter, il suffit de « rester » dans un même message avec son correspondant pour « discuter » grâce au forum privé qui lui est associé).

Note : Les messages entre utilisateurs et les forums qui y sont associés sont privés, c’est-à-dire que SPIP n’offre pas d’interface permettant aux administrateurs du site de voir ces messages. Cependant, nous attirons votre attention sur le caractère très relatif de cette confidentialité : un administrateur du site, doté d’un outil d’accès direct à la base de données, pourra toujours consulter ces messages.

La méthode la plus simple pour envoyer un message consiste à cliquer sur le logo vert (un petit « M » complété d’un triangle) qui est affiché à côté du nom de votre destinataire. Cela ouvre immédiatement un nouveau message.

La seconde méthode consiste à utiliser le bouton « Nouveau message » présent sur chaque page de SPIP. Cela créé un nouveau message sans destinataire. Avant de pouvoir envoyer ce message, vous devrez évidemment indiquer à qui il est destiné.

La seule erreur courante consiste à oublier d’« envoyer » ce message : tant que le message est indiqué « en cours de rédaction », seul son auteur peut y accéder. Il faut donc l’envoyer pour qu’il soit présenté à ses destinataires (attention : une fois un message envoyé, il ne peut plus être modifié).

À tout moment il est possible d’ajouter un destinataire : soit pendant la rédaction du message, soit lorsqu’il est déjà envoyé (par exemple pour inscrire un nouveau participant à une discussion dans un forum qui l’intéresse).

De la même façon, on peut retirer un participant à tout moment. Un bouton « Ne plus participer à cette discussion » permet d’ailleurs à l’un des participants de s’exclure de lui-même d’une discussion.

N’importe quel message peut être transformé en rendez-vous : c’est-à-dire qu’il est lié à une date et affiché dans le calendrier de SPIP.

Certains rédacteurs ne peuvent pas être joints (ils n’apparaissent pas dans la liste « Ajouter un participant », et leur nom n’est pas accompagné d’un logo de messagerie) :
- les rédacteurs qui ont décidé individuellement de ne pas utiliser la messagerie interne ;
- les rédacteurs qui ne se sont pas connectés à l’espace privé du site depuis plus de 15 jours ne sont pas joignables (pour ces utilisateurs qui se connectent peu souvent, il est préférable d’utiliser un email classique).

messpense/

Les pense-bête

Un pense-bête est, dans sa forme, similaire à un message : mais il ne comporte aucun destinataire. Il est uniquement accessible à son auteur.

Comme son nom l’indique, le pense-bête est destiné à noter des éléments que l’on souhaite conserver.

L’utilisation la plus pratique du pense-bête consiste à lui fixer une date. De cette façon, le pense-bête est rappelé à son auteur jusqu’à cette date (et pendant les 24 heures qui suivent), et il apparaît dans le calendrier de SPIP.

Note : Comme pour les messages entre utilisateurs, nous attirons votre attention sur la confidentialité toute relative de ces pense-bête. SPIP n’offre aucune possibilité aux administrateurs du site de voir vos messages ; cependant, d’autres outils d’accès direct à la base de données le permettent.

messcalen/Le calendrier

Le calendrier

- des informations communes à l’ensemble du site ; il s’agit des articles et des brèves publiés - de cette façon le calendrier permet de retrouver des articles en fonction de leur date de mise en ligne ;

- des informations privées ; il s’agit des messages entre utilisateurs et des pense-bête dotés d’une date de « rendez-vous ». Ce calendrier permet ainsi de rappeler et de noter des rendez-vous.

Notez que chaque jour du calendrier est accompagné d’un petit logo bleu : ce logo permet de créer un pense-bête directement associé à cette date (on pourra régler plus précisément l’heure d’un rendez-vous grâce à l’interface d’édition de ce pense-bête).

messconf/Configuration personnelle de la messagerie

Configuration personnelle de la messagerie interne

Chaque utilisateur du site peut configurer individuellement l’utilisation qu’il souhaite faire de la messagerie interne.

Notez bien : Les administrateurs du site peuvent décider de ne pas utiliser la messagerie sur leur site.

Si la messagerie interne est disponible pour l’ensemble du site (option réservée aux administrateurs), chaque utilisateur peut décider individuellement de ne pas l’utiliser (c’est-à-dire qu’il ne souhaite tout simplement pas échanger de messages avec d’autres utilisateurs par ce biais).

Lorsque cette fonction est disponible (choix des administrateurs), et lorsqu’il utilise la messagerie interne, un rédacteur peut décider de ne pas participer à la « liste des rédacteurs connectés ».

Cette fonction affiche en permanence la liste des rédacteurs connectés en direct, facilitant ainsi les dicussions rapides entre utilisateurs. Certains utilisateurs trouvent que cette fonction est intrusive et/ou ne veulent pas être « dérangés » lorsqu’ils se connectent. Il leur suffit alors de désactiver cette option : ils n’apparaîtront plus dans la liste des rédacteurs connectés, et cette liste ne s’affichera plus sur leurs pages.

Note : Lorsqu’un administrateur indique qu’il ne souhaite pas apparaître dans la liste des rédacteurs connectés, la liste est cependant toujours affichée : il « voit » les autres, mais les autres ne le « voient » pas.

Suivi des forums

suiviforum/Suivi des forums

Le suivi des forums

La page de suivi des forums est un élément important de votre site, si vous autorisez l’utilisation des forums publics (à ce sujet, voir la documentation sur la configuration des forums publics). C’est là, en effet, que se déroule la modération de ces forums.

Les messages ne sont pas ici présentés selon leur structure hiérarchique (par thread), mais les uns à la suite des autres, dans l’ordre chronologique inversé (les plus récents en haut). En revanche, chaque message est accompagné du nom de l’article auquel il se réfère.

La principale possibilité consiste à supprimer les contributions. Attention : cette opération est irréversible. Un message supprimé ne peut plus être remis en ligne. Un message supprimé n’est cependant pas effacé de la base de données : il apparaît sur cette page encadré de rouge, avec l’indication de la date d’envoi du message et l’adresse IP de l’expéditeur.

- Si vous avez configuré les forums publics pour fonctionner avec une modération a priori, les messages en attente sont encadrés de jaune, et vous proposent deux boutons : Supprimer ce message et Valider ce message.

Configuration du site

confnom/Nom et adresse de votre site

Nom et adresse de votre site

Le nom et l’adresse (URL) de votre site sont, en particulier, utilisés pour la génération du fichier « backend » qui permet la syndication de votre site (c’est-à-dire l’affichage sur un site extérieur des 10 derniers articles publiés sur votre site).

L’adresse de votre site doit être celle du dossier de la page d’accueil, et non celle du fichier HTML correspondant ; elle doit donc se terminer par le caractère « / ». Si l’adresse de votre page d’accueil est :

confart/Contenu des articles

Contenu des articles

Les articles sont constitués d’un certain nombre d’éléments : le titre, le surtitre, le soustitre, le descriptif, le chapeau, un post-scriptum... Certains sites, cependant, n’ont pas besoin de tous ces éléments : les rédacteurs n’en ont aucun usage, ou l’interface graphique du site public ne les intègre pas.

Afin d’alléger l’interface de gestion du site et/ou d’empêcher purement et simplement les rédacteurs d’utiliser certains éléments que le webmestre ne souhaite pas intégrer, la page de « Configuration précise » permet de désactiver totalement l’utilisation de ces éléments.

N. B. Il est important de comprendre que, par rapport au choix interface simplifiée / interface complète, qui n’influe que sur l’interface de chaque utilisateur, le choix des options de la « configuration précise » influe sur l’ensemble des utilisateurs. Ainsi, si vous décidez de désactiver l’utilisation du surtitre, plus aucun rédacteur ni aucun administrateur ne pourra utiliser de surtitre dans ses articles.

L’interface s’adapte à la présence ou l’absence de ces éléments. Si vous désactivez l’utilisation des mots-clés, le bouton correspondant dans la barre de navigation supérieure disparaît carrément.

confdates/Articles post-datés

Publication des articles post-datés

Les administrateurs ont la possibilité de modifier la date de publication en ligne d’un article (lorsque celui-ci est déclaré « publié en ligne »).

Comment SPIP doit-il se comporter lorsque l’on fixe cette date de publication en ligne à une date future ? SPIP doit-il publier tous les articles, quelque soit la date de publication fixée (au risque d’un affichage farfelu, un article indiquant « 31 mai 2015 » alors qu’on n’est encore que le 21 mai), ou doit-il attendre l’échéance fixée (ici le 31 mai) avant d’afficher cet article sur le site public ?

Ce fonctionnement peut être activé à l’aide de l’option « Ne pas publier les articles avant la date de publication fixée ». Pour assigner une date de publication future à un article, il faut dans un premier temps proposer l’article à la publication. Cela fait apparaître le champ "Date de Publication", qui permet de régler la date future souhaitée. On peut ensuite publier l’article, il ne sera réellement publié sur le site public que lorsque la date de publication déclarée sera atteinte.

- L’intérêt principal de cette manœuvre est de pouvoir échelonner à l’avance la publication d’une série d’articles. Cas pratique : le webmestre part en vacances pendant un mois ; s’il a déjà rédigé quelques articles, il peut les passer, dans l’espace privé, dans l’état « publié en ligne », mais leur fixer des dates de publication réparties pendant le mois de son absence. De cette façon, plutôt que de mettre en ligne un paquet d’articles d’un seul coup, puis plus aucun pendant un mois, le site publie régulièrement de « nouveaux » articles, malgré l’absence de leur auteur.

- Un site de science-fiction qui publierait des chroniques martiennes aurait, pour sa part, intérêt à désactiver cette fonction, sauf à vouloir attendre l’année 2089. Même remarque pour un mensuel dont le numéro d’avril est publié le 20 mars.

confforums/Fonctionnement des forums

Fonctionnement des forums publics

La façon de gérer les forums publics d’un site varie énormément d’un webmestre à l’autre, en fonction notamment des besoins réels du site. Certains webmestres ne veulent pas de forums, d’autres veulent des forums d’accès libre, d’autres encore préfèrent modérer les forums à priori, ne publiant les messages qu’une fois qu’ils ont été validés par un administrateur.

SPIP vous permet de déterminer le fonctionnement de vos forums publics (les forums internes à la gestion du site sont toujours gérés comme des forums ouverts à tous les rédacteurs, et modérés a posteriori).

Lorsque les forums sont désactivés, l’interface d’envoi de contributions disparaît, et les anciennes contributions ne sont plus affichées (elles ne sont pas effacées de la base, mais leur affichage est interrompu). Cette option suspend le fonctionnement des forums, même si l’affichage des forums est prévu dans la mise en page (squelettes) du site.

Vous pouvez l’utiliser en permanence (le site n’offre jamais de forums de discussion), ou temporairement (suspendre l’activité des forums, le temps de calmer un spammeur fou ou de partir en vacances à la chasse au troll... ou encore lors d’un éventuel transfert de votre site sur un nouveau serveur).

Lorsque les forums sont modérés a posteriori, les contributions s’affichent dès qu’elles sont postées par les utilisateurs. Libre à vous, ensuite, d’utiliser la page de suivi des forums de SPIP pour modérer plus ou moins sévèrement ces messages. La modération a posteriori est le mode par défaut de SPIP.

Dans les forums modérés a priori, les contributions des utilisateurs sont stockées, mais pas affichées. Les administrateurs doivent utiliser la page de suivi des forums de SPIP pour valider (ou refuser) chaque message.

Si les forums sont accessibles sur abonnement, les utilisateurs désirant participer doivent s’inscrire en fournissant leur adresse email. Ils reçoivent alors leur identifiant par email. Pour les rédacteurs qui ont déjà accès au site privé, cet identifiant correspond à leur login habituel.

Ce mode est un compromis entre le besoin de responsabilisation (les participants doivent fournir une adresse email valide), et l’absence de modération a priori (une fois inscrits, ces utilisateurs peuvent poster leurs contributions directement).

Ce mode permet de plus d’exclure les utilisateurs qui abuseraient des forums (black-list). En effet, lorsque vous supprimez (via la page « Suivre les forums ») une contribution postée dans le mode « sur abonnement », vous avez accès à la « fiche » (extrêmement réduite) de l’auteur de cette contribution. Vous pouvez alors simplement placer cet auteur « à la poubelle » : son identifiant ne « fonctionnera » plus, et il ne pourra en obtenir d’autre avec cette adresse email.

Attention : le mode « forum sur abonnement » suppose que votre hébergeur supporte la fonction d’envoi de mail automatique. Si ce n’est pas le cas, changez d’hébergeur ;)

confbreves/Système de brèves

Activer/désactiver le système de brèves

Certains sites n’utilisent pas les brèves, ces courts articles sans auteur. Il se peut notamment que le webmestre du site ne les ait pas incluses dans l’interface de navigation du site public.

Dans ce cas, vous pouvez purement et simplement décider de les désactiver. Les rédacteurs ne pourront pas plus en créer. L’interface s’en trouvera d’autant allégée.

confmessagerie/Messagerie interne

Messagerie interne

Une raison pour décider de ne pas utiliser la messagerie interne est la place que les messages occupent dans la base de données : ces messages (comme par exemple les messages des forums liés à vos articles) sont conservés dans la base de données, et ainsi occupent de l’espace chez votre hébergeur. De plus, les fonctions de messagerie interne provoquent un travail supplémentaire sur la machine qui vous héberge (interrogations de la base de données) : sur une machine peu puissante (et/ou très lente), vous pouvez préférer alléger le travail de la machine en désactivant la messagerie.

Si vous activez cette fonctionnalité, la liste des utilisateurs connectés à l’espace privé de votre site apparaît en permanence. Cela facilite notamment l’échange de messages instantanés entre utilisateurs.

Cette fonction provoque des appels supplémentaires à la base de données ; sur une machine peu puissante, vous pouvez préférer la désactiver. Notez également que certains utilisateurs trouvent cette fonctionnalité intrusive.

Notez bien : Lorsque vous activez pour l’ensemble du site les fonctionnalités ci-dessus, il reste possible, pour chaque utilisateur, de désactiver ces fonctions pour lui-même. De cette façon, si un utilisateur trouve inutiles ou intrusives les fonctionnalités de la messagerie interne, il peut simplement désactiver cette fonction pour son usage propre.

confstat/Statistiques des visites

Les statistiques des visites

SPIP intègre un système simple vous permettant de compter et suivre le nombre de visites pour le site et pour chaque article. Il permet aussi de connaître quels sont les autres sites qui ont mené des visiteurs vers votre site et vers chaque article.

SPIP identifie chaque jour les « visiteurs uniques » de votre site en fonction de leur adresse IP. Le système est rapide et relativement fiable (il s’agit d’une estimation relativement correcte du nombre de visiteurs du site, et non des simples « hits » ou des « pages vues » ; un visiteur qui visite plusieurs fois la même page est bien compté pour un unique « visiteur unique »).

On nomme « entrée directe » une arrivée sur le site ou sur la page d’un article depuis un autre site Web qui affiche un lien hypertexte vers votre propre site (ce site étant lui-même considéré comme un « referer »).

Pour l’intégralité du site et pour chaque article, SPIP affiche la liste des principaux « referers » (les pages qui affichent un lien hypertexte vers votre site), accompagnés du nombre d’« entrées directes » (le nombre de visiteurs qui ont suivi ce lien).

Un système complet d’analyse du trafic d’un site est un logiciel très gourmand en puissance et en mémoire ; le système de SPIP est donc très simplifié, afin d’être le plus rapide possible, et d’occuper peu d’espace disque sur le serveur. De plus, le comptage des « visiteurs uniques » se base sur l’adresse IP des visiteurs chaque jour, ce qui ne constitue pas la méthode la plus précise dans l’absolue ; on considère cependant que cela fournit une information relativement fiable.

Pour une information absolument complète sur le trafic du site, on pourra donc préférer se tourner vers un système d’analyse des statistiques plus spécialisé.

Le système de suivi du trafic intégré à SPIP effectue un calcul du nombre de visiteurs et des referers chaque jour (et non en temps réel). Certaines informations pourront ainsi vous sembler parfois incohérentes, car elles ne prennent pas en compte les visites de la journée en cours ; en cas de doute, la page spécifique affichant les statistiques est la plus fiable et la plus détaillée. Dans cette logique, la page des statistiques d’un article n’est disponible qu’après le premier jour de parution d’un article (les chiffres ne sont pas connus auparavant, car SPIP ne les a pas encore analysés).

Le comptage du nombre de visiteurs uniques ne devrait pas occuper beaucoup de place, ni utiliser beaucoup de puissance machine. Il n’y a donc d’intérêt à le désactiver que pour des serveurs très lents.

Le système de comptage des referers et des entrées directes est, lui, nettement plus gourmand. Il est donc désactivé par défaut. Il est conseillé de ne l’activer que sur les serveurs ne posant aucun problème de puissance de calcul (les serveurs qui ont déjà du mal à calculer les articles très longs ne pourront certainement pas, en plus, calculer les referers).

N.B. L’espace disque occupé et le temps de calcul utilisé pour le suivi des visites et des referers augmentent avec le trafic de votre site. Plus un site est visité, plus les besoins techniques pour effectuer ces tâches augmentent.

confmails/Envoi automatique de mails

Envoi automatique de mails

Les rédacteurs et les administrateurs ne passent pas forcément leur vie dans l’espace de gestion de leur site. Afin de faciliter le travail coopératif et le suivi de la vie du site, le système peut vous prévenir par email de certains événements du site...

Attention : certains hébergeurs désactivent la fonction qui permet l’envoi automatique de mails. Si vous êtes dans cette situation, les options suivantes ne pourront pas être activées.

Afin de permettre aux auteurs de suivre les discussions provoquées par leurs articles, cette option permet de faire suivre automatiquement, à l’auteur d’un article, chaque message posté à la suite de son article.

Si cette option est activée, lorsqu’un message est posté dans le site public à la suite d’un article, le (ou les) auteur(s) de l’article reçoivent par mail le texte de la contribution, et le rappel de l’adresse (URL) de cet article ; d’un clic il(s) peut (peuvent) donc se rendre sur la page de l’article et éventuellement répondre aux commentaires.

Lorsqu’un article est proposé pour la validation ou publié, vous pouvez demander à SPIP de le signaler par mail. De cette façon, les participants à la vie du site sont informés en temps réel des évolutions importantes du site.

Pour un site coopératif (plusieurs rédacteurs), nous vous conseillons de créer une liste de diffusion des rédacteurs (la fonction de liste de diffusion n’est pas fournie par SPIP), vers laquelle envoyer de tels messages.

Cette fonctionnalité de SPIP permet de créer des emails du type « Quoi de neuf ? » : si vous l’activez, et après avoir fixé l’intervalle de temps entre les différentes annonces, un mail est envoyé régulièrement à l’adresse indiquée, récapitulant les derniers articles et brèves publiés.

Le fonctionnement est très simple : si vous activez cette option en indiquant un intervalle de 7 jours, SPIP enverra à l’adresse désirée, tous les 7 jours, la liste des articles et brèves publiés depuis 7 jours.

Un bouton « Envoyer maintenant » provoque l’envoi immédiat de ce mail récapitulatif (et relance un nouveau délai avant l’envoi du prochain mail).

Vous pouvez envoyer ce mail d’annonce des nouveautés vers l’adresse du webmestre principal (qui fera suivre), ou, si vous aimez les sites qui se gèrent entièrement tous seuls, directement à la liste de vos abonnés (la fonction de liste de diffusion n’est pas fournie par SPIP).

confmoteur/Moteur de recherche intégré

Activer/désactiver le moteur de recherche

SPIP intègre un moteur de recherche. Lorsque celui-ci est activé, un système d’indexation des articles analyse le contenu de tous les articles. Cette opération, si elle permet ensuite des recherches extrêmement rapides, nécessite beaucoup de travail de la part du serveur qui héberge le site. Dans le cas d’un hébergeur lent, cela peut poser quelques difficultés.

Pour cette raison, vous pouvez activer ou désactiver le système d’indexation.

D’une manière générale, si votre site est très gros, nous vous conseillons de ne pas utiliser le moteur de recherche intégré à SPIP, et de vous orienter vers des produits spécialisés, tels que Sphinx.

Configuration de l’interface personnelle

intersimple/Interface simplifiée / complète

Interface simplifiée / interface complète

Chaque utilisateur de SPIP peut modifier son propre affichage (sans influer, à l’inverse de la page de « Configuration précise », sur l’affichage pour les autres utilisateurs.)

De nombreuses fonctions de SPIP sont rarement (ou pas du tout) utilisées par certains rédacteurs. Passer en mode « interface simplifiée » permet donc d’alléger l’interface et de faciliter sa compréhension. Dans ce mode, seuls les éléments réellement indispensables à la gestion du site sont affichés. Par exemple, peu d’utilisateurs faisant appel à la « date de rédaction antérieure », celle-ci n’apparaît donc pas en « affichage simplifié ».

N.B. Les différences d’affichage sont beaucoup plus évidentes pour les administrateurs, ceux-ci ayant en effet à leur disposition beaucoup plus de fonctions que les rédacteurs du site.

Pour que ces modifications soient appliquées, vous devez accepter l’utilisation des cookies.

cookie/Le cookie de correspondance

Le cookie d’administration

Les administrateurs peuvent activer un cookie qui provoquera l’affichage d’informations supplémentaires lors de la visite du site public. Ces informations facilitent la gestion du site.

Sur toutes les pages du site public apparaît un bouton « Recalculer cette page ». SPIP intégrant un système de cache, certaines modifications peuvent ne pas apparaître immédiatement en ligne. (Les pages affichées sur le site public ne sont pas directement tirées de la base de données : elles sont calculées à intervalle régulier et stockées dans le cache.)

En recalculant une page, l’administrateur provoque l’affichage de la page en fonction des éléments contenus dans la base de données, sans attendre la prochaine mise à jour du cache.

Les pages des articles, des rubriques et des brèves contiennent un bouton « Modifier cet article » (ou « rubrique »...). Ce bouton mène directement du site public à la page de l’espace privé correspondant à cet article (ou rubrique...). Ce bouton facilite donc la correction des erreurs repérées en ligne, ou la mise à jour de tout élément du site.

Si le système de statistiques intégré à SPIP est activé, les pages des articles sont complétées de l’information suivante : nombre de visites (estimation) et nombre de referers différents.

Les referers sont les liens vers cet article précis depuis l’extérieur du site (c’est-à-dire : lorsqu’un autre site a fait un lien directement vers cet article, ou lorsque l’adresse de cet article a été communiqué par email).

Le cookie d’admin permet aussi à SPIP de reconnaître votre navigateur lorsque vous vous reconnectez : vous n’avez donc qu’à entrer votre mot de passe pour entrer dans l’espace privé.

(NB : Si la connexion se fait par cookie - c’est le cas le plus courant -, ce cookie est posé dès votre arrivée dans l’espace privé.)

deconnect/Se déconnecter

Se déconnecter

Le bouton « Se déconnecter » sert à annuler votre identification à l’espace privé. Lorsque vous effectuez cette opération, les informations d’identification que vous aviez indiquées pour accéder à l’espace privé du site sont « oubliées » par le système ; SPIP vous propose d’entrer à nouveau ces informations, ou de revenir à l’espace public du site.

L’intérêt principal de cette fonction est d’interdire qu’une autre personne, utilisant la même machine que vous, puisse accéder à l’espace privé du site en exploitant vos propres informations d’identification.

- Vous vous connectez depuis chez vous et vous êtes la seule personne à accéder à votre ordinateur

Dans ce cas, le fait de vous déconnecter avec cette fonction lorsque vous avez fini de travailler sur l’espace privé du site peut sembler une opération superflue. L’opération de déconnexion est évidemment conseillée, mais si vous oubliez de l’effectuer, ça n’est pas très grave.

- Vous accédez au site privé depuis une machine commune à plusieurs utilisateurs (machine au travail, dans un cyber-café...)

Dans ce cas, il est vivement conseillé de vous déconnecter systématiquement en utilisant cette fonction lorsque vous avez terminé d’utiliser l’ordinateur. Cela interdit totalement à toute personne qui utiliserait cette machine après vous de pouvoir accéder à l’espace privé en se faisant passer pour vous.

Certains utilisateurs peuvent avoir besoin de se connecter à l’espace privé sous plusieurs identités. Dans ce cas, en utilisant cette fonction de déconnexion, ils peuvent se reconnecter immédiatement au site avec de nouvelles informations d’identification.

Usages avancés

artmodif/Articles en cours de modification

Articles en cours d’édition

Lorsqu’un rédacteur intervient sur un article pour le modifier, les autres participants au site qui se rendent sur la page de cet article sont prévenus et il leur est déconseillé d’intervenir à leur tour sur l’article.

En effet, si deux rédacteurs interviennent en même temps sur le même article, les modifications de l’un risquent d’« écraser » les modifications de l’autre.

Si vous voyez la mention « Attention, un rédacteur est intervenu sur cet article », il est donc fortement déconseillé de le modifier à ce moment. Revenez plus tard sur cet article, pour intervenir lorsque l’autre rédacteur aura effectué et enregistré ses modifications.

À l’inverse, lorsque vous-mêmes intervenez pour modifier un article, les autres participants au site qui visiteraient cette page seraient prévenus de votre intervention. Tant que vous modifiez l’article, et pendant une durée d’une heure, les autres rédacteurs sont invités à ne pas intervenir sur ce texte. Lorsque vous considérez que vous avez terminé de travailler sur cet article, et que d’autres peuvent à leur tour intervenir dessus, vous pouvez « libérer » cet article. L’avertissement aux autres participants disparaîtra, et ils pourront si nécessaire effectuer leurs propres modifications.

suivimodif/Suivi des révisions

Suivi des révisions

Le suivi des révisions des articles permet de voir les modifications qui ont été apportées aux articles au cours de leur édition.

Seul les articles déjà publiés ou en cours de validation sont visibles dans cette liste. En cliquant sur le titre d’un article dans la liste on arrive sur une page affichant les différences entre la dernière version et la version précédente.

On peut comparer la version actuelle avec une version antérieure en cliquant sur le lien « comparaison » correspondant.
On peut aussi changer la version affichée en cliquant sur la date de la version qu’on veut consulter.

previsu/La prévisualisation

La prévisualisation

Quand un article est « proposé à l’évaluation », les administrateurs et/ou les rédacteurs (en fonction de la configuration) peuvent prévisualiser celui-ci dans la maquette graphique du site.

Cela permet de vérifier la bonne mise en page de l’article. La prévisualisation fonctionne aussi pour les brèves, les rubriques etc.

latex/Formules mathématiques

Formules mathématiques

SPIP permet d’insérer des formules mathématiques grâce à la notation LaTeX qui sera automatiquement transformée en une image insérée dans le texte.

On placera un texte qui contient des formules entre les balises <math> et </math>. Le code LaTeX d’une formule sera placé entre des caractères dollar « $ ».

confurl/Type d’adresses URL

Choisir un jeu d’URLs

SPIP offre la possibilité, dans ce tableau affiché sur la page de configuration, de choisir le jeu d’URLs que vous souhaitez utiliser (Vous devez évacuer —commenter ou supprimer— la variable $type_urls de votre fichier mes_options.php, pour voir apparaître ce tableau de configuration.).

Pour que votre choix du type d’URL soit pris en compte, il est, le plus souvent et sur la plupart des installations, nécessaire d’utiliser un fichier htaccess :
Inspirez-vous du fichier htaccess.txt fourni avec SPIP à titre d’exemple, et qui fonctionne chez la plupart des hébergeurs avec les types d’URLs proposées.

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 aspects de configuration ( attention : toute modification du fichier .htaccess peut fortement impacter le fonctionnement de votre site web.)

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.

SPIP, un logiciel libre

licence/Licence et conditions d’utilisation

Ce programme est un logiciel libre ; vous pouvez le redistribuer et/ou le modifier conformément aux dispositions de la Licence Publique Générale GNU, telle que publiée par la Free Software Foundation ; version 2 de la licence, ou encore (à votre choix) toute version ultérieure.

Ce programme est distribué dans l’espoir qu’il sera utile, mais SANS AUCUNE GARANTIE ; sans même la garantie implicite de COMMERCIALISATION ou D’ADAPTATION À UN OBJET PARTICULIER. Pour plus de détails, voir la Licence Publique Générale GNU.

Un exemplaire de la Licence Publique Générale GNU doit être fourni avec ce programme ; si ce n’est pas le cas, écrivez à la Free Software Foundation Inc., 675 Mass Ave, Cambridge, MA 02139, États-Unis.

Ce logiciel est téléchargeable à l’adresse https://www.spip.net/ ; vous trouverez également, sur ce site, un mode d’emploi complet et des informations supplémentaires.

En droit français, SPIP est régi par les dispositions du code de la propriété intellectuelle (CPI). Le noyau de SPIP est une œuvre de collaboration entre ses auteurs, désignés ci-dessus (article L 113-1 du CPI). L’ensemble du projet SPIP forme une œuvre collective au sens des articles L 113-2 et L 113-5 du CPI. Les auteurs mettent l’œuvre à disposition de tous selon les droits et obligations définis par la licence publique générale GNU.

Les traductions de l’interface sont le fruit du travail réalisé par une équipe de traducteurs réunis sur le site spip.net.

Installation de SPIP

install0/Régler les droits d’accès

Préliminaire : Régler les droits d’accès

install1/Votre connexion SQL

Votre connexion SQL

install2/Choix de votre base

Choix de votre base

install5/Informations personnelles

Informations personnelles

ftp_auth/Vérification par FTP

Authentification par FTP

erreur_mysql/Un problème de squelette ?

Un problème de squelette ?

Les articles

raccourcis/Les raccourcis typographiques

Les raccourcis typographiques simples de SPIP

Un titre de partie

Fonctionnalités plus complètes

Fabriquer des listes ou des énumérations

arttitre/Titre, surtitre, soustitre

Titre, surtitre, soustitre

artrub/Choisir la rubrique

Choisir la rubrique

artdesc/Descriptif rapide

Le descriptif rapide

artchap/Chapeau

Le chapeau

artvirt/Redirection d’article

Redirection d’article

arttexte/Texte

Le texte de l’article

artdate/Date

La date de publication en ligne

artdate_redac/Date de rédaction antérieure

La date de rédaction antérieure

artauteurs/Les auteurs

Les auteurs

logoart/Logo de l’article

Logo de l’article

artstatut/Le statut de l’article

Le statut de l’article

artprop/Proposer son article

Proposer un article

Les rubriques

rubhier/Une structure hiérarchisée

La structure hiérarchique des rubriques

rubrub/Choisir la rubrique

Choisir la rubrique

rublogo/Logo de la rubrique

Logo de la rubrique

Les brèves

breves/Les brèves

Les brèves

brevesrub/Choisir la rubrique

Position des brèves dans la structure du site

breveslien/Le lien hypertexte

Le lien hypertexte des brèves

brevesstatut/Le statut de la brève

Le statut de la brève

breveslogo/Le logo de la brève

Logo de la brève

Images et documents

ins_img/Insérer des images

Insérer des images dans le texte

ins_doc/Joindre des documents

Joindre des documents multimédia

ins_upload/Installer des fichiers par FTP ou SSH

Installer des fichiers par FTP ou SCP

Collection d’images et de documents

Les mots-clés

mots/Principe des mots-clés

Les mots-clés

artmots/Les mots-clés

Les mots-clés

motsgroupes/Les groupes de mots

Les groupes de mots

Les sites référencés

reference/Référencer un site

Sites référencés

rubsyn/Sites syndiqués