Organisation du contenu

À quelques exceptions près, les pages du site web DoudouLinux sont toutes gérées grâce au logiciel de gestion de contenu Spip. Ce logiciel offre les fonctionnalités suivantes :

• rédaction en ligne des pages sous forme d’articles depuis le navigateur web (aucun logiciel externe nécessaire)
• gestion de la langue des contenus (site multilingue)
• gestion du cycle de publication des articles (en cours de rédaction, en relecture, publié)
• rangement des articles dans des rubriques, les rubriques servent ensuite de menu de navigation du site
• gestion des versions de chaque article, c’est-à-dire les traductions et l’historique de modification
• gestion des rédacteurs et de leurs droits

Les pages du site web correspondent à des articles ou à des rubriques dans la terminologie Spip. Un article est une page web standard. Les rubriques servent à grouper les articles par thème. Une page web est aussi associée à chaque rubrique afin d’en afficher le contenu et de pouvoir naviguer dans ses pages.

Les rubriques

Les rubriques fonctionnent comme des répertoires de fichiers : on peut ranger autant d’articles et de sous-rubriques qu’on veut dans une rubrique, de manière récursive. Sur le site web, les rubriques parentes de la rubrique courante sont affichées en haut de la page, sous l’entête du site, afin que le lecteur sache à tout moment dans quelle partie du site il se trouve. Par ailleurs les rubriques de la racine qui n’ont pas de rubrique parente sont utilisées sur DoudouLinux.org pour définir la langue du site et portent donc le nom de la langue.

Chaque rubrique possède un texte de description qui fonctionne comme le corps d’un article : il est affiché dans la page de la rubrique et fonctionne avec la syntaxe des textes d’articles bien que l’édition d’une rubrique ne se présente pas de la même manière. Le texte de description des rubriques est donc utilisé pour décrire précisément la partie du site DoudouLinux à laquelle la rubrique correspond.

Enfin un système d’héritage de la rubrique parente vers les rubriques enfants fait que la langue par défaut à l’intérieur d’une section complète ne peut pas être modifiée : à tout article d’une rubrique quelconque de la section Français sera associée la langue Français. Cependant nous constatons en pratique que lorsqu’on crée une nouvelle traduction d’un article existant déjà, celui-ci hérite de la langue de l’article de référence. Il faut donc modifier sa langue a posteriori.

Menus du site et rubriques

Les rubriques sont utilisées par Spip pour générer automatiquement des menus. Du coup l’organisation des rubriques d’une langue à l’autre doit être rigoureusement la même pour assurer l’homogénéité du site. Le lien plan du site pourra vous aider dans cette tâche. Les rubriques de référence sont celle de la section Français. Veuillez noter que lorsqu’une rubrique et ses sous-rubriques éventuelles ne contiennent aucun article publié, la rubrique n’apparaît pas dans les menus. C’est pourquoi lorsqu’on démarre une nouvelle langue, il n’y a aucun menu !

Le menu principal dans l’entête en haut de page est généré à partir de la liste des rubriques principales de la langue courante. Les rubriques principales sont celles qui sont directement rattachées à la rubrique de la langue. Le menu latéral, en haut à gauche de la page, est généré à partir de la rubrique dans laquelle le lecteur se trouve. Ce menu comporte les rubriques de niveau identique à la rubrique courante ainsi que les pages et les sous-rubriques de chacune de ces rubriques.

Ordre d’apparition dans les menus

Par défaut les articles et les rubriques apparaissent par ordre croissant de date de création, les plus récents au début, les moins récents à la fin. Pour éviter d’avoir à créer les articles et les rubriques en respectant l’ordre que l’on souhaite avoir à la fin, il est possible de les réorganiser après coup en les numérotant. Il suffit pour cela d’ajouter au début du titre de l’article ou de la rubrique un chiffre suivi d’un point et d’un espace. Par exemple « Organisation du contenu » deviendrait « 2. Organisation du contenu » si on souhaitait le faire apparaître en seconde position dans le menu.

Remarque : c’est surtout l’ordre des rubriques qui est important. Pour les articles il n’y a que dans la rubrique « Documentation » qu’il faut un peu faire attention à l’ordre. Ceci permet de présenter les pages d’aide avec une certaine logique dans la progression des informations données.

Les articles

Les articles sont rangés dans les rubriques. Il ne doit pas y avoir d’article à la racine d’une section, sans quoi la page n’apparaîtrait dans aucun menu [1]. Les seules exceptions sont la page téléchargement et la page dépôt Debian car elles sont systématiquement référencées en entête du site et au-dessus du menu de gauche : pas la peine d’en faire encore plus ! Tous les autres articles doivent donc être rangés au moins dans une des rubriques principales de la langue :

www.doudoulinux.org
  |
  |— English → home page
  |      `— (main sections)
  |             `— (articles)
  |
  |— Español → paginá inicial
  |      `— (rúbricas principales)
  |             `— (artículos)
  |
  |— Français → page d’accueil
  |      `— (rubriques principales)
  |             `— (articles)
  …

Pour le moment nous n’utilisons pas la fonctionnalités de marquage (tags) de Spip de sorte que les articles ne sont regroupés que via les rubriques.

Article de référence et traductions

Les articles d’une nouvelle langue ne doivent pas être créés ex nihilo mais doivent dériver de l’article initial d’une des deux langues de référence. La configuration du site fait que langue de référence est le français, c’est-à-dire que c’est la version réputée la plus à jour. Cependant lorsque la version anglaise existe, nous assurons régulièrement la synchronisation avec la version française de sorte que l’on peut considérer l’anglais comme étant aussi de référence. Pour créer une nouvelle traduction d’une page il faut consulter la page à traduire dans l’interface d’administration du site et dérouler la section « LANGUE ET TRADUCTIONS DE L’ARTICLE » afin de faire apparaître le bouton « Écrire une nouvelle traduction de cet article ».

Remarque : contrairement aux articles, il n’est pas possible de créer une nouvelle rubrique en tant que traduction d’une rubrique de référence, les rubriques sont toutes indépendantes les unes des autres.