Bonjour à tous
Pour resituer, il y a quelque temps (troglos mai 2008) on avait émis
l'idée de restructurer la documentation concernant les balises, les
critères et filtres pour gagner en souplesse.
Remarques :
-* je parle {{d'élément}} pour parler indifféremment de balises/critères/filtre
-* j'utilise le terme {{d'objet/objet SPIP}}, pour définir la notion
générique ARTICLES/RUBRIQUES/....
{{{Problématique}}}
Dans les constats on pouvait lister :
-* La difficulté à préparer une documentation en amont de la
publication d'une nouvelle version stable
-** Exemples :
-*** l'arrivée des filtres |et, |ou, ..;
--*** #CONNECT
En l'état on était obligé :
- soit d'attendre que la nouvelle version officielle soit sortie pour
lancer les projets de documentation
- soit de publier une information non valide au vu de la version stable
Du coup on se retrouve dans tous les cas avec un documentation non
pertinente vis à vis de la version stable du moment.
-* Duplication d'une meme information dans plusieurs articles pour le
même élément.
-** Exemples :
-*** les filtres images (http://www.spip.net/fr_article3327.html,
http://www.spip.net/fr_article901.html)
-*** des balises perdues dans les annonces des sorties
(http://www.spip.net/fr_article3368.html#CHEMIN)
Ce qui amène le risque d'avoir des informations différentes sur le même élément
-* Difficulté à rédiger un article transversal
-** Exemples :
-*** images_* sans recréer toute une partie de la documentation
-*** Générer le glossaire depuis la liste des articles référencés (à terme)
On retrouve les problèmes liés de la duplication de l'information, le
risque d'oublier de document un élément dans tous les articles y
faisant référence.
Bon à cette étape j'espère vous avoir convaincu que pour le moment la
solution que nous avons n'est pas optimale.
Si c'est le cas, on peut essayer pour voir une autre solution 
Sinon
tant pis pour moi mais au moins j'aurais essayé 
{{{Une proposition d'amélioration}}}
La solution proposée :
-* maintient l'existant, si les traductions ne suivent et ben on ne perd rien
-* prend en compte la problématique du multilinguisme
-* permet d'afficher une explication dans la langue de référence si la
traduction n'est pas encore publiée
-* modularise les divers éléments SPIP pour pouvoir les traiter indépendamment
-* pouvoir rédiger plusieurs articles distincts sur un même élément si
la fonctionnalité est différente selon le contexte (grâce à
l'utilisation des mots clefs)
Evolutions imaginées :
-* affecter un mot clef pour la version SPIP pour chaque éléments et
permettre de n'afficher les elements valable que pour une version
donnée
-*
Bien sur on peut lister au moins comme défauts :
-* beaucoup de petits articles
-* la nécessité de mettre en place le concept "d'objet SPIP" comme
pour #TEXTE qui est signifie la même chose pour les différents objets
(ARTICLES, RUBRIQUES, ...)
-* le fait que les articles de références sont obligatoirement le
français (en tout cas avec le modèle existant)
On le constate avec http://www.spip.net/fr_article3856.html qui est
tout petit et qui n'est pas assez générique (on parle de ARTICLES et
non des objets en général).
{{{Le fonctionnement}}}
-* Pour les articles de références
-** Faire un article par balise/filtre/critères (se reporter à
http://www.spip.net/ecrire/?exec=naviguer&id_rubrique=543)
-** Le titre doit être le nom de l'élément explicité (dans l'idée de
les exploiter dans le glossaire)
-** Affecter les mots clefs qui vont bien (la boucle concernées pour
les balises et critère, les balises concernées pour les filtres)
-** Dans les articles de fond utiliser les modèles <criteresXX>,
<baliseXX> où XX est un id des mots clefs.
(http://www.spip.net/ecrire/?exec=articles&id_article=902)
-* Pour les traductions
-** Créer les rubriques obligatoirement nommée <code>balises</code> et
<code>critères</code>,
-** Rédiger les traductions dedans (pour prendre en compte le contexte
de langue)
-* Affichage des données
-** Le modèle parcours les articles correspondant au mot clef dans la
langue de référence (français)
-** Pour chaque article de référence, le modèle recherche la version traduite :
-*** si celle ci existe, on l'affiche
-*** sinon on affiche dans la langue de référence.
Les modèles ont été mis sur la zone
(http://zone.spip.org/trac/spip-zone/changeset/25536/). Ils sont à
améliorer.
{{{Démonstration}}}
J'ai fait le travail pour la boucles ARTICLE dans la version française
et anglaise pour les critères et les balises statiques.
Les balises et critères :
http://www.spip.net/ecrire/?exec=naviguer&id_rubrique=143
http://www.spip.net/ecrire/?exec=naviguer&id_rubrique=199
La boucle ARTICLES :
(fr) http://www.spip.net/ecrire/?exec=articles&id_article=902
(en) http://www.spip.net/ecrire/?exec=articles&id_article=2083
Comme vous pouvez le voir (avec les publications) le travail se fait
assez rapidement.
{{{Questions ??? }}}
Qu'en pensez vous ? Est ce que vous êtes d'accord pour tester ? Que
faudrait il faire pour améliorer cette suggestion ?
Km
PS : j'avais réouvert cette discussion dans un ancien fil, mais noyé
dans l'ensemble des publications il semble que ce soit plus perdu
qu'autre chose.
J'avais un doute sur le fait que les traducteurs