[spip-dev] Suggestions pour spip.net

Dev
1

S'lt

On a déjà eu des discussion concernant la doc sur spip.net et comme là
on va devoir documenter une grosse partie en terme de fonctionnalités
(#BALISE, {critere}, ...)

-- Pré requis --
En gros ce qui va suivre ne concernera que
http://www.spip.net/ecrire/?exec=naviguer&id_rubrique=143 et les
traductions associées

-- Contexte --
1 /La logique veux que spip.net ne publie sa doc que sur les versions
stable et antérieure.
2/ Les articles sont structurés de telle façon que la documentation ne
peut se faire au fil de l'eau car cela impacterait une publication
anticipée, à l'encontre de 1/
3/ des concepts de #BALISE se retrouvent dans différents contexte et
dont le sens peux différer, ce qui empêche de proposer un article par
#BALISE
4/ une logique multilinguiste forte

-- Suggestion --
1/ Ne concerne que l'aspect Squelettes, #BALISE, <BOUCLE_>, {critere}
2/ On pourrait restructurer chaque boucle en rubrique avec un article
d'explication, l'article actuel et 2 sous rubriques (criteres et
balise)

Pour les articles d'explication, on aurait un squelette dédié qui
chargerai le texte et aussi la liste des articles publié dans les 2
sous rubriques.
Ainsi on retrouverait grosso modo l'existant.

Chaque critère et chaque balise pourront etre édités indépendamment,
on pourrait alors préparer les textes sans les publier.
Cela nous évitera d'avoir à n'avoir l'explication de certains balises
dans les billets d'annonce comme #ARRAY

On pourrait avoir d'autre rubrique autre que les boucles pour faire
des regroupement comme pour la famille des #FORMULAIRE_, ....

3/ Pour l'aspect multilinguisme ça pourrait simplifier aussi le
travail des traducteurs car là on peut travailler au fil de l'eau et
traduire dans le temps et sans pression une partie de la doc publique.
Lors des troglos, georges me disait qu'il fallait pas trop s'inquiéter
sur les perturbations que cela pourraient apporter, là c'est plus nous
qui nous montons une montagne que eux.
Bien sur il faut préparer le changement aux habitudes.

4/ le glossaire serait plus facilement mis à jour si on s'appuie sur
les titre des articles publiés qui porteront le nom de la balise,
critères, ...

Je veux bien continuer à travailler dessus, mais pas tout seul surtout
que deja un gros boulot de reflexion a été deja lancé, je ne fais que
suivre la voie tracée.

Km

2

Bonjour,

Si j'ai bien compris l'idée est de créer autant d'articles que de balises
et critères, puis de reconstruire la présentation actuelle avec un
squelette dédié.

Si c'est possible, je veux bien aider.

Est ce que cette mise en squelette permettrait d'ajouter des niveaux de
profondeurs dans les explications de la doc jusqu'à donner plusieurs
exemples de boucles quand c'est utile ?

Cordialement
Stanislas

3

Bonjour

Si j'ai bien compris l'idée est de créer autant d'articles que de balises
et critères, puis de reconstruire la présentation actuelle avec un
squelette dédié.

Si c'est possible, je veux bien aider.

Oui l'idée est là.

C'est de faire un article par balise, critere et d'afficher via
squelette dédié le tout.
Pour le moment je vois 2 cas de figure.

Soit :
Rubrique : BOUCLE
-- Article : Présentation (grosso modo l'article existant sans la
partie des criteres, balise,..)
--- Rubrique : BALISE
--- -- Article : #BALISE1 (reprise de l'explication de la balise1 pour
la boucle)
--- -- Article : ...
--- -- Article : #BALISEn (reprise de l'explication de la balisen pour
la boucle)
--- Rubrique : Critere
--- -- Article : {critere1}
--- -- Article : ...
--- -- Article : {criteren}

Soit :
Rubrique : BOUCLE
-- Article : Présentation (grosso modo l'article existant sans la
partie des criteres, balise,..)
-- Article : #BALISE1 (reprise de l'explication de la balise1 pour la boucle)
--- -- MotClef : Balise
-- Article : ...
--- -- MotClef : Balise
-- Article : #BALISEn (reprise de l'explication de la balisen pour la boucle)
--- -- MotClef : Balise
-- Article : {critere1}
--- -- MotClef : Critere
-- Article : ...
--- -- MotClef : Critere
-- Article : {criteren}
--- -- MotClef : Critere

Pour ma part j'opterai pour la solution 1, mais je crois que les 2
solutions sont quasi pareil

Pour le glossaire, je crois qu'on peut obtenir le meme résultat dans les 2 cas.

Est ce que cette mise en squelette permettrait d'ajouter des niveaux de
profondeurs dans les explications de la doc jusqu'à donner plusieurs
exemples de boucles quand c'est utile ?

ça semble possible, mais je ne m'etais pas posé la question

Km

4

Pour ma part j'opterai pour la solution 1,

d'accord :
- l'espace privé reste lisible
- une simple boucle rubriques suffira pour appeler les articles et on
pourra les numéroter pour les ordonner

Pour le glossaire, je crois qu'on peut obtenir le meme résultat dans les
2 cas.

je ne sais pas comment cela fonctionne aujourd'hui. cela demande une
intervention manuelle j'imagine (il faut mettre une ancre dans les
articles ?). alors que là on aurait un truc qui se bâtit
automatiquement... enfin je pense... :).

Est ce que cette mise en squelette permettrait d'ajouter des niveaux de
profondeurs dans les explications de la doc jusqu'à donner plusieurs
exemples de boucles quand c'est utile ?

ça semble possible, mais je ne m'etais pas posé la question

l'idée ce serait de trouver le truc qui ne change pas la présentation
actuelle mais propose un div caché jquerysé ou simplement un lien vers un
article qui détaille les explications dans le genre de la compilation
effectuée sur spip-contrib pour "doublons".

Il y a un certain nombre de balises et critères dont l'emploi n'est pas
évident a priori (ou complexe pour un non informaticien) qui mériteraient
ce traitement.

Stanislas

5

S'lt

Pour jouer il y a http://spipnet.spip.azerttyu.net/ c'est un vieux
dump de spip.net mais ça on peut tout casser :slight_smile:

Compte ftp et cie dispo mais sur demande, on va éviter d'ouvrir trop
de trou de sécurité betement sur une liste publique :stuck_out_tongue:

Km

6

mon mel : stanislas76(at)free(point)fr
quel est ton plan ?

Stanislas

7

S'lt

Bon le site demo est sur les rails.
Stanislas tu as les codes pour le ftp, tu admin et refenrencé comme
webmestre aussi.

Bon reste à voir avec le squelettes bien que posé, il semble exister
une subtilité que j'ai ratée

Km

8

S'lt à tous

Il y a 2 semaines stanislas à travailler sur spip.net pour tester la
nouvelle suggestion.

Ce n'est peut être pas encore parfait mais je crois que Stanislas a
réussi à prouver que c'était possible sans casser l'existant.

http://spipnet.spip.azerttyu.net/ecrire/?exec=articles&id_article=902

L'idée :
-* on fait un article par critère, balise, ...
-* on affecte les mots clef 'boucle' à ceux ci
-*dans l'article parent, on charge le modèle rubrique_balise,... en
précisant l'id_mot mot clef

L'article exemple montre le texte d'origine et les articles chargé par modèle.

Au passage si un critère a exactement le même descriptif pour
plusieurs cas d'utilisation grâce aux mot clef , il n'est pas
nécessaire de dupliquer l'information.

Km

Je pense qu'on peux commiter sur la zone ces apports et commencer à
l'appliquer sur le site. Cela n'est peut etre pas parfait mais je
crois bien qu'on peux dire :'ça marche'

9

Je pense qu'on peux commiter sur la zone ces apports et commencer à
l'appliquer sur le site. Cela n'est peut etre pas parfait mais je
crois bien qu'on peux dire :'ça marche'

Gogogo. Est-ce que ça change quelque chose pour les traducteurs ?
Peux-tu expliquer le mode d'emploi sur spip-trad ?

-- Fil

10

S'lt

Gogogo. Est-ce que ça change quelque chose pour les traducteurs ?

Oui dans le sens où on démultiplie les articles.
On aura donc un article sur la boucle(ARTICLES) et autant de sous
articles pour les critères, balise, ...

Le contexte de langue est toutefois transmis si je m'abuse aux
modèles. Donc une fois la version originale correctement saisie, les
traducteurs n'auront qu'à reprendre les articles et affecter la
nouvelle langue.

Peux-tu expliquer le mode d'emploi sur spip-trad ?

Des que je suis sur d'une procédure pérenne, je communique dessus.