[Spip Trad] Documentation de SPIP.

Bonjour,

En vue de certains messages que j’ai échangé sur le forum de SPIP, je pose la question suivante :

  • Serait-il possible de faire une consultation en ligne de l’aide intégrée à SPIP ? Consulter tout cela directement sur spip.net sans passer par l’interface privée de SPIP…

Possibilités :
1/ Dupliquer les articles dans la rubrique « Guide du rédacteur » ( http://www.spip.net/ecrire/?exec=naviguer&id_rubrique=483 ) de façon « brute »

  • Avantage(s) :

  • euh… je ne vois pas mis à part la visibilité pour un nouvel utilisateur qui n’a pas encore installé spip en local ou sur son serveur ;

  • on peut segmenter les longs articles de l’aide pour mieux « cibler » les besoins de lecture ;

  • Inconvénient(s) :

  • double mise à jour à faire lorsqu’on actualise l’aide selon les nouveautés ou les lacunes comblées.

2/ Créer un modèle qui permettrait d’appeler le texte ou l’élément désiré de tel ou tel article

  • Avantage(s) :

  • permettre une mise à jour du contenu en une seule fois et donc ne pas avoir une mise à jour lourde des articles le cas échéant (mais on recrée l’arborescence dans la rubrique Guide des rédacteurs) ;

  • Inconvénient(s) :

  • articles longs et peut-être moins accessible ;

  • est-ce que les ces articles seront pris en compte dans les recherches sur le site ?
    3/ d’autres solutions?

J’attend vos commentaires. Et si on trouve une solution pérenne qui convient à tout le monde, je m’y colle dans les jours qui viennent.

Teddy Payet

Le 4 mars 2010 à 12:49, TeddyP SPIP a écrit :

Bonjour,

En vue de certains messages que j'ai échangé sur le forum de SPIP, je pose la question suivante :
- Serait-il possible de faire une consultation en ligne de l'aide intégrée à SPIP ? Consulter tout cela directement sur spip.net sans passer par l'interface privée de SPIP...

mais c'est déjà le cas !

http://www.spip.net/aide/fr-aide.html
http://www.spip.net/aide/it-aide.html

etc, car c'est bien par une requête http anonyme que l'espace privé de chaque site SPIP va interroger www.spip.net.

Cela dit ton idée d'avoir un modèle ou une balise pour accéder à ça est intéresante.

Committo,Ergo:Sum

Oui, je sais que l’aide de l’espace privée est hébergée sur spip.net
Mais elle n’est pas consultable directement sur spip.net (arborescence), non?

Et c’est là qu’interviendrait ma suggestion… Soit, segmenter/dupliquer l’aide ; soit dupliquer grâce aux modèles les articles sans découpage…

Le 4 mars 2010 18:11, Committo,Ergo:sum <esj@rezo.net> a écrit :

Le 4 mars 2010 à 12:49, TeddyP SPIP a écrit :

Bonjour,

En vue de certains messages que j’ai échangé sur le forum de SPIP, je pose la question suivante :

  • Serait-il possible de faire une consultation en ligne de l’aide intégrée à SPIP ? Consulter tout cela directement sur spip.net sans passer par l’interface privée de SPIP…

mais c’est déjà le cas !

http://www.spip.net/aide/fr-aide.html
http://www.spip.net/aide/it-aide.html

etc, car c’est bien par une requête http anonyme que l’espace privé de chaque site SPIP va interroger www.spip.net.

Cela dit ton idée d’avoir un modèle ou une balise pour accéder à ça est intéresante.

Committo,Ergo:Sum

(Désolé pour double post)

J’ai regardé, pas accessible depuis le plan du site… Le seul endroit on parle de la consultation de l’aide est dans cet article (avec le lien en bas de page) :
http://www.spip.net/fr_article891.html

Mais, la visibilité n’est pas flagrante… Ne peut-on pas améliorer cela?..

Le 4 mars 2010 18:38, TeddyP SPIP <teddy.spip@gmail.com> a écrit :

Oui, je sais que l’aide de l’espace privée est hébergée sur spip.net
Mais elle n’est pas consultable directement sur spip.net (arborescence), non?

Et c’est là qu’interviendrait ma suggestion… Soit, segmenter/dupliquer l’aide ; soit dupliquer grâce aux modèles les articles sans découpage…

Le 4 mars 2010 18:11, Committo,Ergo:sum <esj@rezo.net> a écrit :

Le 4 mars 2010 à 12:49, TeddyP SPIP a écrit :

Bonjour,

En vue de certains messages que j’ai échangé sur le forum de SPIP, je pose la question suivante :

  • Serait-il possible de faire une consultation en ligne de l’aide intégrée à SPIP ? Consulter tout cela directement sur spip.net sans passer par l’interface privée de SPIP…

mais c’est déjà le cas !

http://www.spip.net/aide/fr-aide.html
http://www.spip.net/aide/it-aide.html

etc, car c’est bien par une requête http anonyme que l’espace privé de chaque site SPIP va interroger www.spip.net.

Cela dit ton idée d’avoir un modèle ou une balise pour accéder à ça est intéresante.

Committo,Ergo:Sum

Hello

Je reviens là-dessus:

Le 4 mars 2010 à 12:49, TeddyP SPIP a écrit :

En vue de certains messages que j'ai échangé sur le forum de SPIP, je pose la question suivante :
- Serait-il possible de faire une consultation en ligne de l'aide intégrée à SPIP ? Consulter tout cela directement sur spip.net sans passer par l'interface privée de SPIP...

...

Créer un modèle qui permettrait d'appeler le texte ou l'élément désiré de tel ou tel article

En fait on a déjà la balise AIDER qui affiche ce qui est retourné par la fonction inc_aider.
Qu'est-ce que tu souhaiterais de plus exactement ?

Committo,Ergo:Sum

En fait, ce que je voudrais c’est étoffer la doc sur spip.net avec les articles de l’aide en ligne… Actuellement, les visiteurs ne peuvent facilement trouver les articles de « AIDE » lors d’une recherche. Exemple :
http://www.spip.net/spip.php?page=recherche&recherche=raccourcis+typographique&debut_articles=20
Il n’y a pas ici l’article de l’aide traitant des raccourcis typographiques…

La fameuse balise AIDER, elle est renseignée où? Je ne savais pas qu’elle existait…

Le 5 mars 2010 12:18, Committo,Ergo:sum <esj@rezo.net> a écrit :

Hello

Je reviens là-dessus:

Le 4 mars 2010 à 12:49, TeddyP SPIP a écrit :

En vue de certains messages que j’ai échangé sur le forum de SPIP, je pose la question suivante :

  • Serait-il possible de faire une consultation en ligne de l’aide intégrée à SPIP ? Consulter tout cela directement sur spip.net sans passer par l’interface privée de SPIP…

Créer un modèle qui permettrait d’appeler le texte ou l’élément désiré de tel ou tel article

En fait on a déjà la balise AIDER qui affiche ce qui est retourné par la fonction inc_aider.
Qu’est-ce que tu souhaiterais de plus exactement ?

Committo,Ergo:Sum

Le 5 mars 2010 à 13:06, TeddyP SPIP a écrit :

La fameuse balise AIDER, elle est renseignée où? Je ne savais pas qu'elle existait...

AIDER en elle-même ne faisait pas grand chose en 2.0: seulement appeler la fonction inc_aider sur les arguments qu'elle reçoit.
Ces deux fonctions ont été pas mal changé pour la 2.1 à venir, mais ne sont documentée que dans leur code actuellement. S'il faut revoir l'organisation de la doc de SPIP là-dessus, c'est à mon avis dans le sens de ce qui est indiqué dans ces commentaires: cette aide en ligne concerne la signification des champs de saisie des formulaires de l'espace privé, il faut donc l'indexer d'une manière ou d'une autre à l'aide du nom du formulaire (i.e. du squelette quand il y en a un) et du nom de la saisie.

Committo,Ergo:Sum