Carnet Wiki

Refonte de spip.net

Version 18 — Janvier 2011 RastaPopoulos

Modifier la structuration du contenu puis sa présentation pour se faire de nouveaux amis.

Constat

Actuellement, le site c’est surtout pour les copains : ceux qui connaissent déjà SPIP et qui viennent alors chercher de la documentation, qui sur l’utilisation, qui sur les squelettes.

Or spip.net est avant tout l’URL officielle du logiciel, donc celle où arrivent aussi ceux qui ne connaissent pas encore. J’insiste : qui ne connaissent pas DU TOUT.

Il faut donc réorganiser le contenu pour mieux séparer les différentes zones, et dans un deuxième temps réfléchir à comment ce sera présenté à l’écran. Dans l’ordre !

Tâches à faire

TâcheÉtat
Étudier les sites des autres communautés Terminé
Déduire de l’étude un plan général qui fonctionne Terminé
Faire rentrer l’existant dans le nouveau plan Terminé
Ranger le site selon la nouvelle structure En cours (local)
Passer en squelette Z Terminé

|[Définir |[Définir les grandes zones qu’on veut afficher->#zones]|En |En cours|
|[Contenu |
|[Contenu de la barre de navigation principale->#barrenav]
|En cours |
|Personnalisation par langue de la barre de navigation|Terminé</strike >|
faire |
|Étudier et lister les spécificités (rubriques, mots-clés) des squelettes actuels|À faire|
|Implémenter les choix ergonomiques définis précédemment|À faire|
|Faire un thème tout bête avec les couleurs actuelles pour le moment|À faire|

Quelques notes d’analyse

Si l’on regarde différents sites de communautés de logiciels libres, on remarque qu’ils ont des différences, mais que dans les gros sites il y a des points qui reviennent régulièrement.

Alors oui on peut se poser la question : est-ce que cela revient parce que c’est la mode, ou parce que ça marche ? On peut tout de même penser qu’il y a des choses qui fonctionnent, et qui peuvent alors être considérées comme des bonnes pratiques ergonomiques pour diriger un visiteur d’un site de logiciel libre au bon endroit lors de sa première visite.

On retrouve notamment :

  • Présentation du logiciel : « about » dans les sites anglophones, c’est quoi, ça sert à quoi, liste des fonctionnalités, visuels, exemples de site
  • Documentation : il est important ici de d’abord rester dans l’abstrait ! En effet, si au départ il y avait peu de choses, au fil du temps on se retrouve avec moult types de documentations différentes. Il est alors vain de vouloir les afficher directement toutes sur la page d’accueil. Il vaut mieux une entrée sobre et compréhensible par tous « Documentation » qui affichera alors une page qui, elle, redirigera vers les différents types de documentation.
  • La communauté et/ou Contribuer, qui peuvent être la même entrée ou deux entrées différentes, suivant le nombre de choses à placer.

Proposition générale non détaillée

Voici un plan pour les grandes zones. Le but serait de tout faire rentrer dedans. Les titres sont volontairement différents de l’existant pour bien montrer de quoi on parle.

  • Présentation du logiciel
    • Ça sert à quoi
    • Lister les fonctionnalités
    • Exemples de sites qui pètent
    • Historique
    • Ça marche comment
  • Documentation
    • Guide d’installation
    • Guide d’administration
    • Guide de rédaction
    • Guide pour créer ses squelettes
    • Guide pour les développeurs => vers site externe « programmer »
    • Doc automatique du code / API => vers site externe « doc.spip »
    • Vidéos / Screencasts / etc => vers site externe « medias.spip »
  • Aide
  • Comment contribuer
    • Rapporter des bugs => vers les tickets
    • Aider les utilisateurs => vers « forums.spip » + les listes + IRC
    • Compléter la documentation => ce site + « programmer »
    • Traduire => traduire SPIP + traduire les documentations
    • Développer des choses
      • Pour les plugins => vers « spip-contrib » + « programmer » + la liste « spip-zone »
      • Pour le noyau => vers la liste « spip-dev »

Comme on le voit, certains sites sont cités dans plusieurs endroits : c’est normal. En effet ce n’est pas forcément du même point de vue : comment trouver de l’aide ou comment soi-même apporter de l’aide (contribuer) aux autres. Dans tous les cas, ces points redondants sont des liens vers d’autres sites, et non du contenu interne à spip.net.

Plan complet

Nous allons maintenant détailler le plan pour faire rentrer l’existant dans la structure générale.
Attention, l’arborescence ne préjuge pas du tout des objets utilisés : rubriques, site externe, articles, ou sections d’un même article.

Légende : en normal, les entrées qui ne bougent pas, en italique ce qui est déplacé, en gras les nouveautés.

  • C’est quoi SPIP ?
    • Présentation
    • Fonctionnalités (possibilité de détailler dans plusieurs pages)
    • Captures d’écran
    • Exemples de sites
    • Essayer SPIP
    • Télécharger (le guide d’installation fera un lien dessus mais ça fait partie des pages « de base »)
  • Documentation
    • Documentation de base
      • Comprendre SPIP (les mots et concepts importants)
        • Les grands mots importants : espace public, espace privé, des types de comptes (webmaster, admin, rédac, visiteur), le mot « squelette » = template
        • Comment ça marche dans les grandes lignes : le contenu en base, puis compilation des squelettes, le cache, le PHP, etc
      • Installation et mise à jour
      • Les versions
      • Administrer le site
      • Guide du rédacteur
      • Les squelettes SPIP (anciennement Webmestres)
    • Pour les développeurs
      • Programmer avec SPIP => titre + description + lien vers site externe
      • Documentation du code => vers site externe
    • Tutoriels
      • Des tutoriels sur des cas d’utilisation précis (faire ceci, faire cela)
      • Vidéos, screencasts et autres => lien vers Medias.SPIP
  • Contribuer
    • Rapporter un problème => explication et lien vers les tickets + vers Contrib pour les plugins
    • Compléter les documentations => spip.net et programmer
    • Traduire => traduire SPIP, traduire les plugins, traduire les documentations
    • Aider les autres => répondre aux questions sur les forums, sur les listes
    • Ergonomie, graphisme et communication
      • Ergonomie et graphisme dans l’espace privé
      • Logo des plugins
      • Ergonomie et graphisme des sites de la communauté : spip.net, spip-blog, contrib
    • Construire avec nous
      • Développement de SPIP => pas juste le code : PHP, CSS, ergonomie du privé !
      • Développement des plugins
  • Être aidé (= la communauté, anciennement Questions&Réponses)
    • Sur SPIP
      • Forums.SPIP
      • Liste User
    • Sur les plugins
      • SPIP-Contrib => les forums des plugins
      • Liste SPIP-Zone
    • Pour tous
      • Canal IRC
      • Trouvez des gens => lien vers SPIP-Party

Les grandes zones

Voici la liste des choses qui doivent se retrouver sur toutes les pages :

  • Le logo SPIP
  • Une barre de navigation principale
  • Les langues disponibles
  • Des outils pratiques (recherche, glossaire, etc)
  • La recherche
  • Le chemin
  • Le contenu
  • La sous-navigation
  • Différents rappels permanents dans le pied (mini plan, pas juste 3 liens)

La barre de navigation principale

Ce menu correspond aux choses que l’on veut rendre immédiatement accessible d’un seul clic depuis toutes les pages du site. Ce sont donc soit les grands secteurs importants (documentation), soit des pages précises (télécharger).

  • Commencez rapidement : page de résumé qui en un coup d’œil donne accès au plus important
  • Télécharger : page de téléchargement
  • Documentation : vers le sommaire de la documentation
  • Trouver de l’aide : où trouver la communauté
  • Contribuer : tous les outils pour soi-même participer

Compatibilité : pour permettre une compatibilité avec l’existant, il ne faut rien rendre obligatoire pour les autres langues du site. Pour cela on peut imaginer le comportement suivant :

  1. Une barre de navigation par défaut affiche les sous-rubriques racines d’un secteur de langue. C’est le comportement actuel, donc les gens ne seront pas perdus.
  2. Mais s’il existe un menu du plugin Menus, identifié barrenav-<lang>, alors c’est ce menu qui sera utilisé en remplacement. Permettant ainsi de personnaliser la navigation de manière précise pour chaque langue, suivant l’étendu de son contenu.