[spip-dev] [Spip] Documentation, pari un peu fou...

Bonjour à tous,

Je ne sais pas quelle mouche m’a piquée ce matin (en hiver en plus…), mais je me propose de feuilleter le fichier ecrire/inc/filtres.php et peut-être aussi ecrire/inc/filtres_images.php pour y référencer les différents filtres de SPIP. De ce fait, je voudrai savoir si c’est ok pour tout le monde si je renseigne cela sur spip.net?

Mais voilà, je ne saurai pas non plus toutes les fonctions (En ce fait, ceux à quoi ils vont servir, pour leur nom pas de soucis, c’est marqué en noir et blanc — sauf si vous avez un éditeur de codes qui colorise vos codes…).
Mon but est de référencer “tous” les filtres de SPIP pour augmenter le glossaire: http://www.Spip.net/@ et de faire le lien par la suite avec http://doc.spip.org/
Ce qui fait, que parfois, il n’y aura pas l’explication de l’utilisation de ce filtre… Tant que je ne saurai pas son utilisation, je ne pourrai pas l’écrire. Mais, encore une fois, c’est pour référencer les filtres.

Quand pensez-vous?

Exemple (parmis tant d’autres) de fonction inconnue de ma part: supprimer_caracteres_illegaux et corriger_caracteres

Cordialement,

Teddy.

Teddy Payet a écrit :

Quand pensez-vous?

Ben, tout est déjà là :
http://doc.spip.org/filtres-php

et là :
http://doc.spip.org/filtres_images-php

C'est automatique. C'est le principe de base de doc.spip.org.

Après il faut documenter au mieux chaque fonction (c'est un wiki).

Oui, mais je n’ai pas tout trouver (je n’ai pas tous les exemples en tête).

Mais c’est aussi pour alimenter spip.net. Les gens (dont moi) n’ont pas encore le réflexe d’aller sur doc.spip.org
De ce fait, je voudrai enrichir les filtres référencés sur spip.net

2008/11/28 RastaPopoulos <vincent@ldd.fr>

Teddy Payet a écrit :

Quand pensez-vous?

Et sinon, je pense un peu tout le temps. Mais surtout quand je suis sous une bonne douche chaude. Ou la nuit.

Bonjour à tous,

Je ne sais pas quelle mouche m'a piquée ce matin (en hiver en plus...), mais
je me propose de feuilleter le fichier ecrire/inc/filtres.php et peut-être
aussi ecrire/inc/filtres_images.php pour y référencer les différents filtres
de SPIP. De ce fait, je voudrai savoir si c'est ok pour tout le monde si je
renseigne cela sur spip.net?

Mais voilà, je ne saurai pas non plus toutes les fonctions (En ce fait, ceux
à quoi ils vont servir, pour leur nom pas de soucis, c'est marqué en noir et
blanc — sauf si vous avez un éditeur de codes qui colorise vos codes...).
Mon but est de référencer "tous" les filtres de SPIP pour augmenter le
glossaire: Glossaire - SPIP et de faire le lien par la suite avec
http://doc.spip.org/
Ce qui fait, que parfois, il n'y aura pas l'explication de l'utilisation de
ce filtre... Tant que je ne saurai pas son utilisation, je ne pourrai pas
l'écrire. Mais, encore une fois, c'est pour référencer les filtres.

Quand pensez-vous?

Go go go !!!

Une Leffe pour ce mec

Oui, mais je n'ai pas tout trouver (je n'ai pas tous les exemples en tête).

Mais c'est aussi pour alimenter spip.net. Les gens (dont moi) n'ont pas
encore le réflexe d'aller sur doc.spip.org
De ce fait, je voudrai enrichir les filtres référencés sur spip.net

Dans ce cas, la première chose à faire, c'est te créer un compte sur le site :
http://www.spip.net/spip.php?page=identifiants&focus=nom_inscription&mode=1comite

Ensuite, tu peux créer les articles pour les filtres non encore référencé,

Et si tu veux ajouter de la documentation à un filtre, envoie un
message à l'auteur qui a commencer à faire la documentation du filtre
pour voir si il peu t'ajouter en tant qu'auteur. Tu devrais ainsi
pouvoir modifier la doc existante pour ce filtre.

Seb

2008/11/28 RastaPopoulos <vincent@ldd.fr>

Teddy Payet a écrit :

Quand pensez-vous?

Et sinon, je pense un peu tout le temps. Mais surtout quand je suis sous une bonne douche chaude. Ou la nuit.

Ah? Toi aussi?

Yep. Ça c’est fait depuis longtemps. (j’avais perdu mon login/password; j’ai redemandé le tout par le formulaire adéquate.)

Donc, pour commencer, je vais lister tous les filtres qui sont déjà présent sur spip.net et le comparer à ce qui est écrit dans les fichiers filtres.php et filtres_images.php

Une remarque en passant, sur doc.spip.org, on fait référence à filtres_mini.php mais apparemment ce fichier n’existerait plus. Est-ce exact?

Teddy.

Yep. Ça c'est fait depuis longtemps. (j'avais perdu mon login/password; j'ai
redemandé le tout par le formulaire adéquate.)

Donc, pour commencer, je vais lister tous les filtres qui sont déjà présent
sur spip.net et le comparer à ce qui est écrit dans les fichiers filtres.php
et filtres_images.php

Une remarque en passant, sur doc.spip.org, on fait référence à
filtres_mini.php mais apparemment ce fichier n'existerait plus. Est-ce
exact?

Oui, c'est mis à jour par rapport à la version de dev via un bot.
Et ce bot n'efface pas les rubriques des fichiers dans ils n'existent
plus pour ne pas "éffacer de doc".

RastaPopoulos a écrit :

Teddy Payet a écrit :

Quand pensez-vous?

Ben, tout est déjà là :
http://doc.spip.org/filtres-php
http://doc.spip.org/filtres_images-php

Moi j'en pense que la moindre des choses serait de mettre
un lien de Glossaire - SPIP
vers ces adresses.

Sinon c'est de la crypto doc
(pour initied only).

JL

JLuc a écrit :

Sinon c'est de la crypto doc

Tout à fait, voire de la kapténa doc.

De mon coté j'ai créé une page sur le wiki qui permet de lister des manques connus de la doc actuelle, ou l'on pourra se référer si l'on souhaite participer à un effort de documentation.

Ne pas hésiter à ajouter des entrées sur cette page, ni à prendre en charge une de ces entrées pour la traiter en terme de doc.

BoOz

Yep. Ça c'est fait depuis longtemps. (j'avais perdu mon login/password; j'ai
redemandé le tout par le formulaire adéquate.)

Donc, pour commencer, je vais lister tous les filtres qui sont déjà présent
sur spip.net et le comparer à ce qui est écrit dans les fichiers filtres.php
et filtres_images.php

........

Bonjour,

Mon "but" n'est pas de referencer tous les filtres de la galaxie Spip et de ses plugins mais juste ceux du "core" de spip. Les plugins c'est sur spip-contrib qu'on fait ça me semble-t-il...

Cordialement,

Teddy Payet
http://www.maloya.org/
http://www.vileso-studio.com/

Oups me suis plante de lien (un copier residuel) ce sont bien des
filtres qui sont dans le core
http://trac.rezo.net/trac/spip/browser/spip/ecrire/public/references.php#L408

a+

Denooz Sébastien a écrit :

Go go go !!!

Une Leffe pour ce mec

c'est pas une bière ! c'est une Leffe !