SPIP-Contrib

SPIP-Contrib

عربي | Deutsch | English | Español | français | italiano | Nederlands

288 Plugins, 197 contribs sur SPIP-Zone, 212 visiteurs en ce moment

Accueil > Vie de SPIP et autour de SPIP > Présentation : Documentation et refonte du portail spip.net

Présentation : Documentation et refonte du portail spip.net

31 mai 2017 – par RastaPopoulos, tcharlss – commentaires

11 votes

Cette présentation a été faite durant la rencontre SPIP à Toulouse en mai 2017.

Elle propose de relancer le chantier de refonte de 2011 qui visait à refaire le portail spip.net et à revoir le rangement de la documentation.

Mieux et plus communiquer est un objectif que nous partageons. Il ne s’agit pas de faire du marketing (littéralement chercher à gagner des parts de marché), même si cela pourra être un « side effect » au passage. Non : il s’agit avant tout de s’adresser et d’accueillir poliment un grand nombre de personnes différentes, venant de plusieurs horizons.
Pas juste des devs, donc.
Et pas juste les gens qui connaissent déjà.

Pour cela, refaire du site officiel un véritable portail d’accueil et de redirection semble une des tâches les plus importantes. Actuellement, il s’agit trop d’un site de documentation pour connaisseureuses.

Nous invitons à relancer le chantier de refonte 2011-2012 dont le but était d’arrêter un moment de documenter, pour ranger autrement. Faire de spip.net un site très léger (à la louche 10-30 pages) donc facile à améliorer maintenant puis au fil du temps.

Voici une feuille de route possible.

  • vider spip.net du maximum, donc facile à améliorer maintenant puis au fil du temps
  • faire un utiliser.spip.net pour la doc d’utilisation de l’interface
  • integrer.spip.net pour la doc du langage de squelettes
  • harmoniser et automatiser ce qu’on doit faire sur les sites de doc dédiés quand on change de version…

Diapositives de la présentation.

Utilisez les flèches droite et gauche pour naviguer, et la flèche du bas sur certaines diapos qui ont des sous-chapitres.

IMG/html/documentation.html
Diapos de la présentation sur la refonte de spip.net

Vidéo de la présentation

Il s’agit d’une première version « brute de pomme ». La version finale comprenant la capture du vidéoprojecteur sera publiée plus tard.

Cette vidéo est également consultable sur medias.spip.net

Présentation : refonte de spip.net et rangement de la documentation
Vidéo de la présentation a été faite durant la rencontre SPIP à Toulouse en mai 2017.

Dernière modification de cette page le 31 mai 2017

Retour en haut de la page

Vos commentaires

  • Le 13 juin à 18:05, par Yohooo En réponse à : Présentation : Documentation et refonte du portail spip.net

    Décentraliser la création de la doc avec la création d’un plugin communautaire :

    Au delà de l’idée de spliter spip.net en 3 parties, pourquoi ne pas créer un plugin permettant de mutualiser une FAQ centrale à partir des articles d’aide utilisé par chaque administrateur de site ?

    Le plugin Aide à la redaction pourrait servir de point de départ.

    Ce plugin serait relié à un site central permettant de récupérer l’ensemble des contributions des administrateur. Il permettrait :
    -  Aux administrateurs d’un site de venir puiser dans les articles composant la FAQ centrale afin de répondre aux problématiques rencontrées par ses utilisateurs.
    -  Aux administrateurs de chaque site de proposer des nouvelles réponses aux problématiques rencontrés par les utilisateurs de leurs sites.

    Exemple :
    En tant qu’intégrateur, je consacre souvent une rubrique des sites réalisés à la doc. ( par exemple, ici ) certains articles se retrouvent sur plusieurs sites et j’aimerai les synchroniser entre-eux lorsque je les améliore. ( par exemple, cette notice d’aide à l’utilisation de formidable se retrouve ici ).

    Les articles composant la FAQ pourraient avoir plusieurs statuts :

    • Mutualisation descendante : l’article est publié sur le site, il se synchronise à chaque mise à jour sur le site central
    • Proposé à la Mutualisation : l’article est publié sur le site. Il va être pris en compte pour une modification du site global
    • Article spécifique au site : article non mutualisé

    par ailleurs, les articles pourraient être associé à deux autres types de statut :

    • Un premier type de statut nommé « plugin nécessaire à cette doc » permettant d’afficher certains articles sur une partie spécifique du site central.
    • Un second type de statut nommé « version de Spip » pourrait limiter la doc à une ou plusieurs version de spip

    Enfin, il serait peut-être opportun de créer des noisettes relatives aux plugins et aux versions de Spip pour faire apparaître certains paragraphes. par exemple :

    1. <spipsup3.0>
    2. L'ensemble des documents hébergés sur votre site sont visibles et modifiables dans la médiathèque. Pour y accéder, RDV dans {{Edition > Document}}
    3. </spipsup3.0>

    Télécharger

    Dynamique communautaire

    Ce type de plugin permettrait d’impulser une dynamique visant à la production communautaire d’une doc de spip. L’équipe d’admin du site central n’aurait plus qu’à valider et structurer un contenu arrivant directement sur le site d’aide et basé sur des problématiques concrètes.

    Les contributeurs réguliers seraient contactés pour devenir à leur tour administrateur du site.

    Z’en pensez quoi ?

    Répondre à ce message

Répondre à cet article

Qui êtes-vous ?

Pour afficher votre trombine avec votre message, enregistrez-la d’abord sur gravatar.com (gratuit et indolore) et n’oubliez pas d’indiquer votre adresse e-mail ici.

Ajoutez votre commentaire ici Les choses à faire avant de poser une question (Prolégomènes aux rapports de bugs. )
Ajouter un document

Retour en haut de la page

Ça discute par ici

  • Le plugin ZotSpip

    28 mai 2012 – 138 commentaires

    Synchronise Spip avec une bibliothèque (personnelle ou partagée) de références bibliographiques Zotero. Utilisez Zotero pour gérer / importer / rédiger vos références bibliographiques, puis incorporez vos références bibliographiques dans votre Spip avec (...)

  • ScolaSPIP 4

    19 janvier 2016 – 213 commentaires

    ScolaSPIP est plugin-squelette responsive personnalisable pour sites Web d’établissements scolaires basé sur SPIPr Présentation de ScolaSPIP Ce plugin pour SPIP 3 est développé par la Dane de l’académie de Versailles pour les webmestres de cette (...)

  • MediaBox

    10 mai 2010 – 514 commentaires

    Avertissement Le présent plugin est installé et activé par défaut sur toute les version de SPIP > 3.0. Inutile donc de l’installer manuellement sauf si vous utilisez SPIP 2.1. Aperçu La MediaBox est une Boîte multimédia polyvalente et (...)

  • Sommaire automatique

    31 janvier 2013 – 14 commentaires

    Ce plugin repère les intertitres des textes de vos articles et s’en sert pour génèrer un sommaire. Ce dernier peut être inséré automatiquement au début de chaque article, ou utilisé dans les squelettes pour générer un sommaire sur n’importe quel autre (...)

  • La Fabrique

    20 avril 2012 – 316 commentaires

    La Fabrique est un outil pour webmestres ou développeurs qui souhaitent créer des plugins. La Fabrique est capable de générer le code source minimal d’un plugin pour SPIP 3 (elle accélère donc le démarrage d’un plugin) et peut s’occuper également de (...)

Ça spipe par là