Aide à la rédaction des articles

publié le 21 avril 2018 |

Ceci est (modifiée) l’aide fournie à l’origine pour rédiger des articles. Lisez-là.


Sommaire de ce tutoriel
0. En guise d’intro
1. Bonnes pratiques
2. Rédaction (remarques valant pour toutes les rubriques) : les quelques modifs à ne pas faire / distinguer les liens / insérer une image / gérer les forums / les puces
3. Pages des émissions : le descriptif de l’émission / ses articles / son contact / ajouter un podcast / son fil d’infos
4. Infos FTP


0. En guise d’intro

Ici, on explique le fonctionnement propre au site de Canal Sud tel qu’il a été développé. Ce tutoriel n’a donc pas vocation à expliquer le fonctionnement général de Spip. Pour cela, vous trouverez des tutos très complets sur www.spip.net, via l’onglet Aide en haut à gauche de chaque page de la partie privée de ce site, et via les icônes  ? présentes sur de nombreux éléments.
Les liens verts sur cette page ne vous font pas sortir du tutoriel, mais vous permettent d’accéder plus vite à une sous-section. Les liens bleus pointent vers d’autres pages de ce site ou vers d’autres sites.
Vous pouvez aussi consulter info-spip, plus didactique, si vous êtes complètement débutant.e.

sommaire


1. Bonnes pratiques

 Ne travaillez jamais à l’arrache, crevé.e ou décalqué.e. Préférez différer vos publications jusqu’au moment vous serez sûr.e.s de pouvoir travailler avec attention et minutieusement.

 soignez le contenu rédactionnel et la cohérence de vos codes en eux-mêmes avant tout. Les mises en formes alambiquées et autre fioritures sont toujours disruptives vis à vis d’un effort à diffuser de l’information avec clarté et fiabilité.

 évitez les articles compilant un nombre élevé de podcast : préférez toujours faire plusieurs articles car plus un article comporte d’objets externes, plus les erreurs de pointage vers les bons documents deviennent compliquées et fastidieuses à gérer...

 prenez le temps de bien décrire explicitement les contenus de vos podcast et émissions : ces informations seront exploitées par les moteurs de recherche pour élargir l’audience de vos productions. N’hésitez pas à mesure à revenir sur vos productions précédentes pour en améliorer l’accessibilité sur Internet.

 De manière générale, aussi bien dans le code que dans la rédaction, on s’efforce de respecter les standards recommandés par le W3C et les bonnes pratiques du web définies par l’Opquast (Open Quality Standards), par exemple :

  • on ne force pas la navigation de l’internaute (les liens s’ouvrent dans la même fenêtre)
  • on signale les liens sortants (voir plus bas)
  • on ne lui fait pas clignoter ou défiler en permanence un texte ou une image devant les yeux, ou un son dans les oreilles, sans qu’il puisse l’interrompre.
  • on ne lui crie pas dessus (pas de majuscules inutiles)
  • ...

Pour plus d’infos là-dessus, voir la sympathique page de micr0lab sur ces bonnes pratiques.

 En cas de modification du directeur de la publication, du développeur, de l’hébergement ou des adresses, mettre à jour l’article « Ce site », qui porte les mentions légales.

sommaire


2. Rédaction

 NE METTEZ SURTOUT PAS DE LIENS EXTERNES SEULS SANS LES CODES SPIP APPROPRIÉS AUTOUR DANS VOS ARTICLES !
Un lien externe c’est toujours au minimum [->http://adresse.domaine]

 Les liens s’animent au survol en passant en majuscules. Il est donc important de ne pas mettre de liens directement en majuscules : 1. parce que c’est une des bonnes pratiques du web, 2. pour la cohérence de la charte graphique générale, et 3. parce que le lien ne pourrait plus s’animer au survol.

 Distinguer liens entrants / liens sortants : une icône de flêche s’affiche automatiquement après les liens commençant par http:// ou www.. Il est donc très important de n’utiliser que les raccourcis internes de Spip lorsqu’on fait un lien vers une autre partie du site.
Par exemple, on mettra [une émission sur le même thème->art212], et surtout pas [une émission sur le même thème->http://www.canasud.net/spip.php?art212] ni de <a href=""></a>



 Insérer une image. Pour créer une vignette cliquable à partir d’une image de grande taille et donc donner la possibilité de l’afficher en taille réelle, ajouter un titre au document et utiliser le code <imgX> , où X est le numéro de l’image. Pour réduire automatiquement une image (500 px de large maximum) sans la rendre cliquable, utiliser le code <embX> , où X est le numéro de l’image.
 titrez systématiquement vos images afin de permettre aux internautes ne pouvant pas les voir d’avoir une idée de ce qu’elles représentent.

sommaire


 Les forums sont modérés a priori. Pour modifier ce réglage, allez dans l’onglet Configuration > Forum.
 Pour publier ou supprimer les messages en attente de validation, aller dans l’onglet Activité > Suivre/gérer les forums.
 Pour enlever la possibilité de commenter un article, lui ajouter le mot-clé Noforum

sommaire



 Les puces : lorsque vous faites une liste sur le mode

- bla
- blabla
- blablabla

les tirets sont automatiquement remplacés par des icônes d’onde sonore dans la partie publique (des triangles s’affichent lorsque vous êtes dans l’interface privée) :

bla
blabla
blablabla

sommaire



3. Pages des émissions

Chaque émission a les droits d’administration sur sa propre rubrique seulement : elle ne pourra publier un article que s’il est correctement placé dans sa rubrique. Il est important (voir pourquoi) que l’émission ait un seul auteur et qu’il soit administrateur de cette rubrique.

 Nom et "descriptif rapide" de la rubrique : apparaissent dans la grille, ainsi que dans la page "de A à Z". Attention : le descriptif doit être bref (quelques mots)... Si jamais vous avez besoin d’expliciter, remplir le champ suivant :
 Texte de la rubrique : permet de présenter l’émission de manière plus complète. S’affiche en haut de la page de la rubrique.
 Le mot-clé "Emission archivée" : permet d’archiver une émission qui n’est plus active mais dont les articles resteront disponibles pour mémoire, avec une icône ad hoc.

Sur la page d’accueil de chaque émission s’affichent le résumé de ses derniers articles. Si un podcast est en ligne, il est préférable de le placer en haut d’article, afin qu’il s’affiche correctement dans le résumé (le résumé se coupant automatiquement après un certain nombre de signes, s’il coupe au milieu du player, celui-ci ne pourra pas s’afficher).


Articles :

  • Auteur : il reprend le titre de l’émission, donc identique au nom de sa rubrique. Par défaut, il est pré-rempli, lors de la création d’un nouvel article, selon le login utilisé pour se connecter (on peut le changer si besoin).
  • Mots-clés, importants à renseigner :
    • Les mots-clés "Thèmes" : en choisir au moins un par article. Ils permettent un bon référencement de l’émission sur le site, notamment dans la page "archives sonores"
    • Les mot-clés "Durée" : permettent l’affichage de la durée sur la page "archives sonores".
    • Le mot-clé "Noforum" : permet de désactiver la possibilité de commenter un article.

sommaire


Le contact s’affiche automatiquement sous forme de formulaire sur la page publique de l’auteur dès lors que celui-ci a renseigné un email dans le champ dédié sur sa page auteur privée.

Attention : il est important qu’un seul auteur corresponde à une rubrique d’émission, et que cet auteur soit l’administrateur de cette seule rubrique (celle de son émission) : c’est comme cela que le site va savoir quel contact d’auteur afficher. Concrètement, pour créer une nouvelle émission :
 créer une sous-rubrique de la rubrique Programme
 créer un auteur, et sur sa fiche auteur préciser qu’il est administrateur restreint à cette sous-rubrique.
 publier au moins un article dans cette sous-rubrique et lui affecter cet auteur.



Ajouter un podcast : pour ajouter un fichier son à un article (et afficher du coup automatiquement son émission sur la page « Archives sonores » et dans les flux de podcast du site) :
0. pour une toute première mise en ligne de pocast (il ne sera pas nécessaire de repasser par ce 0. ensuite) : sur la page de l’article, on sélectionne « Ajouter une image ou un document depuis le serveur » -> une bulle d’aide indique qu’un sous-dossier au nom du login a été créé sur le serveur (patientez une minute le temps que Spip crée automatiquement le sous-dossier) : "En tant qu’administrateur, vous pouvez installer (par FTP) des fichiers dans le dossier tmp/upload/monlogin/ pour ensuite les sélectionner directement ici"
1. par FTP, on place le fichier (nécessairement mp3) dans le dossier correspondant à son login dans /tmp/upload (upload/monlogin/)
2. sur la page de l’article, on sélectionne « Ajouter une image ou un document depuis le serveur », on peut choisir son fichier dans la liste déroulante, on valide
3. si l’on veut que le player s’affiche : on insère dans l’article le code <embX>, où X est le n° du document. Si l’on veut que seule l’icône mp3 (sans player) s’affiche, on utilise le code <docX>, où X est le n° du document.
4. si l’on a choisi <embX>, et que l’on veut que le lien "télécharger le mp3" s’affiche automatiquement sous le player, on sélectionne « Modifier » le document puis on lui donne un titre
5. une fois qu’un fichier son est associé à un article publié, il est copié automatiquement dans /IMG/mp3/ : pour alléger le serveur et libérer de l’espace web, un administrateur peut sans aucun risque le supprimer du dossier /tmp/upload/
6. On modifie ensuite le document en lui conférant un titre l’identifiant sans ambiguité : titre de l’émission, date et détails si l’émission est découpée en séquences
sommaire



Fil d’infos (flux rss) : chaque nouvel article publié par l’émission est automatiquement référencé, par ordre de date décroissante, dans sa propre rubrique + dans la colonne de droite de la rubrique "accueil" pour les plus récents. Pour que ce flux de nouveautés fonctionne, il est impératif d’écrire des articles nouveaux (donc ni des sous-rubriques, ni la modification d’une seul et même article en permanence).


4. Infos FTP

Pour accéder directement au dossier tmp/upload/ qui permet de mettre des fichiers lourds en ligne. Ce compte restreint ne permet pas de faire les mises à jour de Spip ou autres interventions sur la structure même du site.

Hôte : www.canalsud.net
Identifiant : canalsud

sommaire