Traduction de la documentation - fonctions déjà définies dans SPIP

Bonjour à tous,

Dans l’article 19. Les filtres de SPIP, à la fin de l’article, on dit:
On peut ainsi appeler n'importe quelle fonction php, ou s'appuyer sur des fonctions définies dans SPIP ou dans <code>mes_fonctions.php3</code>, pour peu qu'elles respectent l'ordre des arguments (le texte à traiter doit être impérativement le premier argument). Par exemple, pour couper le texte à une longueur donnée (50 caractères), on pourra utiliser <code>[(#TEXTE|couper{50})]</code>.

Bon, j’aimerais savoir si la fonction couper{50} est une des fonctions définies dans SPIP ou si elle est une fonction personnalisée dans mes_fonctions.php3.
En outre, où est-ce que je peux trouver une liste des fonctions déjà définies dans SPIP? (pour éviter de poser une question chaque fois que je trouve ces fonctions...:-))))
Merci,
Fausto

Ciao Fausto,

Outre les fonctions PHP que l'on peut utiliser directement dans
les squelettes, Spip en défini quelques unes, dont celles dans
ecrire/inc_filtres.php3.

Mais desfois ça ne suffit pas, alors Spip nous permet d'ajouter
des fonctions "maison" dans mes_fonctions.php3. L'avantage d'y
placer nos fonctions maisons, c'est que Spip n'écrasera pas nos
modifications après une mise à jour.

Ainsi, si on écrit [(#BALISE|filtre)], on ira d'abord chercher
dans mes_fonctions.php3 voir si la fonction "filtre" existe,
puis dans Spip tel que ecrire/inc_filtres.php3 (ça peut être à
peu près n'importe où, mais c'est plus logique dans inc_filtres),
puis dans PHP comme tel.

Dans la doc, la notion de "filtre" fait pas mal toujours référence
à ce processus (du moins, si moi-même j'ai bien compris :slight_smile:

mathieu

Le 2004-10-23, à 17:13:38 +0200, Fausto Barbarito (mc2234@mclink.it) écrit:

Bonjour à tous,

Dans l’article 19. Les filtres de SPIP, à la fin de l’article, on dit:
On peut ainsi appeler n'importe quelle fonction php, ou s'appuyer sur des
fonctions définies dans SPIP ou dans <code>mes_fonctions.php3</code>, pour
peu qu'elles respectent l'ordre des arguments (le texte à traiter doit être
impérativement le premier argument). Par exemple, pour couper le texte à
une longueur donnée (50 caractères), on pourra utiliser
<code>[(#TEXTE|couper{50})]</code>.

Bon, j’aimerais savoir si la fonction couper{50} est une des fonctions
définies dans SPIP ou si elle est une fonction personnalisée dans
mes_fonctions.php3.
En outre, où est-ce que je peux trouver une liste des fonctions déjà
définies dans SPIP? (pour éviter de poser une question chaque fois que je
trouve ces fonctions...:-))))
Merci,
Fausto

--
Mathieu Lutfy <mathieu@bidon.ca> http://www.bidon.ca
GPG 0x5F5BCEB4 0D3B 1AEE EF9B FB34 2FE7 80EC 8E8D F00A 5F5B CEB4

Merci Mathieu,
mais je voudrais savoir si "couper" peut etre traduit ou non. Selon les indications d'ARNO* e de Jim je ne dois pas traduire "couper", mais dans la traduction anglaise du meme article ce filtre a été traduit avec "cut". Donc je me demande s'il est une fonction déjà définie (et donc non traduisible) ou s'il est une fonction "maison", et donc on peut la traduire (en italien, anglais, espagnol...)
Mais si j'ai bien compris, j'irai voir le fichier inc_filtres.php3.
Amicalement,
Fausto
(qui ne dors pas jusqu'il a terminé de traduire la documentation... :-)))) )

At 18.37 23/10/2004 +0300, Mathieu Lutfy wrote:

Ciao Fausto,

Outre les fonctions PHP que l'on peut utiliser directement dans
les squelettes, Spip en défini quelques unes, dont celles dans
ecrire/inc_filtres.php3.

Mais desfois ça ne suffit pas, alors Spip nous permet d'ajouter
des fonctions "maison" dans mes_fonctions.php3. L'avantage d'y
placer nos fonctions maisons, c'est que Spip n'écrasera pas nos
modifications après une mise à jour.

(snip)

"couper", mais dans la
traduction anglaise du meme article ce filtre a été traduit
avec "cut".

Ah bon? Merci, Fausto. Je vais voir cela (pour l'anglais). {couper} existe
bien quelque part dans Spip, et donc ne devrait pas être traduit. A cet
endroit de la doc il aurait été plus clair de donner l'exemple d'un filtre
"maison".
Peut-être à l'origine ce filtre était donné comme exemple d'un filtre
maison, ensuite il a été entégré dans Spip, je ne sais pas.

(qui ne dors pas jusqu'il a terminé de traduire la
documentation... :-)))) )

Mais on le voit bien !

Paolo

Le 2004-10-24, à 02:56:23 +0200, Fausto Barbarito (mc2234@mclink.it) écrit:

Merci Mathieu,
mais je voudrais savoir si "couper" peut etre traduit ou non. Selon les
indications d'ARNO* e de Jim je ne dois pas traduire "couper", mais dans la
traduction anglaise du meme article ce filtre a été traduit avec "cut".

Oops, j'avais donné de mauvaises directions. D'une part, couper() est
effectivement une fonction de Spip, son nom ne devrait donc pas être
traduit. On peut re-définir son nom si on veut, mais pour un novice qui
se réfère à la doc, vaudrait mieux éviter cette idée.

Concernant l'article en anglais, je pense que c'est une erreur. Pour
éviter toute confusion, selon moi il vaudrait mieux décrire "couper()"
dans la section "Filtres de texte" de l'article, et utiliser pour
exemple la fonction décrite vers la fin de l'article: filtre(arg1, arg2)
qui devient [(#TEXTE|filtre{arg2})] dans un squelette.

Dans les autres langues on pourrait alors écrire "function my_filter(..)"
puis [(#TEXTE|my_filter{arg2}], par exemple.

Pour référence:
http://www.spip.net/ecrire/articles.php3?id_article=901 (fr)

Qu'en pensez-vous?

D'autre part, je me suis trompé sur le fichier, cette fonction est
dans ecrire/inc_texte.php3. Si un traducteur doit commencer à chercher
dans ces fichiers à chaque fois qu'il y a des ambiguïtés, ça risque
d'être très pénible. Vaut mieux continuer de demander ici car en même
temps, ça permet de réparer si nécessaire la doc de référence :slight_smile:

mathieu

Donc je me demande s'il est une fonction déjà définie (et donc non
traduisible) ou s'il est une fonction "maison", et donc on peut la traduire
(en italien, anglais, espagnol...)
Mais si j'ai bien compris, j'irai voir le fichier inc_filtres.php3.
Amicalement,
Fausto
(qui ne dors pas jusqu'il a terminé de traduire la documentation... :-)))) )

At 18.37 23/10/2004 +0300, Mathieu Lutfy wrote:
>Ciao Fausto,
>
>Outre les fonctions PHP que l'on peut utiliser directement dans
>les squelettes, Spip en défini quelques unes, dont celles dans
>ecrire/inc_filtres.php3.
>
>Mais desfois ça ne suffit pas, alors Spip nous permet d'ajouter
>des fonctions "maison" dans mes_fonctions.php3. L'avantage d'y
>placer nos fonctions maisons, c'est que Spip n'écrasera pas nos
>modifications après une mise à jour.

(snip)

_______________________________________________
spip-trad@rezo.net - http://listes.rezo.net/mailman/listinfo/spip-trad
http://www.spip.net/
irc://irc.freenode.net/spip

--
Mathieu Lutfy <mathieu@bidon.ca> http://www.bidon.ca
GPG 0x5F5BCEB4 0D3B 1AEE EF9B FB34 2FE7 80EC 8E8D F00A 5F5B CEB4

Le 2004-10-24, à 09:11:49 +0200, Paolo (paolo2@taize.fr) écrit:

Ah bon? Merci, Fausto. Je vais voir cela (pour l'anglais). {couper} existe
bien quelque part dans Spip, et donc ne devrait pas être traduit. A cet
endroit de la doc il aurait été plus clair de donner l'exemple d'un filtre
"maison".
Peut-être à l'origine ce filtre était donné comme exemple d'un filtre
maison, ensuite il a été entégré dans Spip, je ne sais pas.

Puisque je t'ai vu te connecter, puis disparaître, j'ai décidé
de faire la modification suivante:

"For example, the PHP function <code>htmlspecialchars</code> can
be used as <code>[(#TEXTE|htmlspecialchars)]</code>."

Il y a surement une fonction PHP plus appropriée, mais j'ai
rarement à me servir d'autre chose que les fonctions fournies
par Spip :slight_smile:

Et j'ai ajouté dans la section "Text filters":

- couper cuts a text to a specified number of characters. The default
  length is 50 caracters, but you can specify a different length by
  using the following syntax: [(#TEXTE|couper{50})], for example.

http://www.spip.net/ecrire/articles_versions.php3?id_article=2465

mathieu

--
Mathieu Lutfy <mathieu@bidon.ca> http://www.bidon.ca
GPG 0x5F5BCEB4 0D3B 1AEE EF9B FB34 2FE7 80EC 8E8D F00A 5F5B CEB4

Mathieu écrit :

Puisque je t'ai vu te connecter, puis disparaître,

Nous sommes autrement occupés ici le dimanche matin :slight_smile:

j'ai décidé
de faire la modification suivante:

"For example, the PHP function <code>htmlspecialchars</code> can
be used as <code>[(#TEXTE|htmlspecialchars)]</code>."

Magnifique!

- couper cuts a text to a specified number of characters. The default
  length is 50 caracters, but you can specify a different length by
  using the following syntax: [(#TEXTE|couper{50})], for example.

Oui... seulment "50" n'est pas différent de 50 !
J'ai remodifié à 80.
|couper coupe plus intelligemment que seulement compter le nombre de
caractères (ne coupe pas les mots par exemple, évite de prendre la moitié
d'un tag HTML...) et ce sera peut-être d'en faire mention dans la doc, mais
comme je ne sais pas exactemment ce qu'il fait, je ne sais pas quoi mettre.

Paolo

Le 2004-10-24, à 11:41:49 +0200, Paolo (paolo2@taize.fr) écrit:

Nous sommes autrement occupés ici le dimanche matin :slight_smile:

J'hésitais à faire la modif ou non, car mon anglais/français
sont très rouillés ces temps-ci. Mais parfaitement d'accord
pour dire qu'un dimanche matin sert à autre chose :slight_smile:

Magnifique!
Oui... seulment "50" n'est pas différent de 50 !
J'ai remodifié à 80.
|couper coupe plus intelligemment que seulement compter le nombre de
caractères (ne coupe pas les mots par exemple, évite de prendre la moitié
d'un tag HTML...) et ce sera peut-être d'en faire mention dans la doc, mais
comme je ne sais pas exactemment ce qu'il fait, je ne sais pas quoi mettre.

Je pense que c'est une bonne idée de le mentionner. J'ai fait la
modif suivante:

- {{couper}} cuts a text to no more than a specified number of
  characters. ->>It avoids cutting a word in two, removes formatting
  elements and adds “<code>(...)</code>” if necessary to show that the
  text was abridged.<<- The default length is 50 characters, but you
  can specify a different length by using the following syntax:
  <code>[(#TEXTE|couper{80})]</code>, for example.

Merci Paolo et George pour les corrections. Vivement le travail
collaboratif avec Spip :slight_smile:

mathieu

--
Mathieu Lutfy <mathieu@bidon.ca> http://www.bidon.ca
GPG 0x5F5BCEB4 0D3B 1AEE EF9B FB34 2FE7 80EC 8E8D F00A 5F5B CEB4