OVH Cloud OVH Cloud

doc des fonctios en francais sur python

41 réponses
Avatar
Thierry B
Bonjour,

Y'a t'il une bone page qui explique en francais, la plupart des
fonctions de python (syntaxe)?

Pq j'avoue que des fois, c'est cho à comprendre, leurs explications qui
sont toutes en anglais, sur le site off :-(.

Merci
A+

10 réponses

1 2 3 4 5
Avatar
Do Re Mi chel La Si Do
Re

un peu de courage et un bon dico




Et beaucoup de temps.


Mais, le problème viendra après. Lorsqu'une nouvelle version de la doc
originale sortira. Comme les modifications/ajouts/suppressions ne seront pas
notées et/ou repérées, il faudra, au minimum, tout relire.
Alors que, si c'était bien organisé au départ, un toilettage suffirait. Pour
ça, il faudrait que les numérotations soient doublées par des invariants, et
des versions, pour chaque item. Mais, faire comprendre ça aux ricains, ce
n'est point gagné...


@-salutations

Michel Claveau



Avatar
William Dode
On 01-12-2005, Do Re Mi chel La Si Do wrote:
Re

un peu de courage et un bon dico




Et beaucoup de temps.


Mais, le problème viendra après. Lorsqu'une nouvelle version de la doc
originale sortira. Comme les modifications/ajouts/suppressions ne seront pas
notées et/ou repérées, il faudra, au minimum, tout relire.
Alors que, si c'était bien organisé au départ


Ca tombe bien c'est bien organisé dès le départ puisque la doc est gérée
avec subversion !

, un toilettage suffirait. Pour
ça, il faudrait que les numérotations soient doublées par des invariants, et
des versions, pour chaque item. Mais, faire comprendre ça aux ricains, ce
n'est point gagné...


@-salutations

Michel Claveau






--
William Dodé - http://flibuste.net




Avatar
Eric Masson
"Do Re Mi chel La Si Do" writes:

Alors que, si c'était bien organisé au départ, un toilettage suffirait. Pour
ça, il faudrait que les numérotations soient doublées par des invariants, et
des versions, pour chaque item. Mais, faire comprendre ça aux ricains, ce
n'est point gagné...


T'as entendu parler des vcs ?

J'ai du mal à croire que l'équipe de dev n'utilise pas un de ces outils
pour la gestion des docs.

Éric Masson

--
Demande éclaircissements: - que signifie "Suivi-à positionné sur fuad"?
"quoter" je présume voulant dire, raccourcir? "gâchi des ressources"
comment ça? C'est qui, quoi, Usenet.abus ? et vous-même qui êtes vous ?
-+- AH in: <http://www.le-gnu.net> - Questions pour un champion -+-

Avatar
Do Re Mi chel La Si Do
Bonsoir !


Ben, je prend un exemple :


Python 2.3.5 :
2.3.9 Other Built-in Types

devient, pour Python 2.4.2 :
2.3.10 Other Built-in Types


Un changement de numéro, sans autre repère, pourrait nuire fortement à la
maintenance d'une traduction du document.

Certes, je suppose que la documentation est gérée avec des outils
particuliers. Mais je doute que l'aspect "traduction incrémentale" ait été
prise en compte. AMHA, il a seulement été tenu compte de l'écriture +
génération des documents en sorties.


@-salutations

Michel Claveau
Avatar
Eric Brunel
On Thu, 1 Dec 2005 21:07:33 +0100, Do Re Mi chel La Si Do wrote:

Bonsoir !


Ben, je prend un exemple :


Python 2.3.5 :
2.3.9 Other Built-in Types

devient, pour Python 2.4.2 :
2.3.10 Other Built-in Types


... et qui est dans le source TeX libfuncs.tex de la doc:
section{Built-in Functions label{built-in-funcs}}
donc sans la moindre mention d'un quelconque numéro (cf. le répertoire Doc de la distribution source). <troll cause="vendredi">Il n'y a vraiment que dans Word que la numérotation automatique est tellement mal foutue que les gens finissent par coder leurs numéros de paragraphe à la main...</troll>

Un changement de numéro, sans autre repère, pourrait nuire fortement à la
maintenance d'une traduction du document.


Ben pas si on traduit les sources, non...

Certes, je suppose que la documentation est gérée avec des outils
particuliers. Mais je doute que l'aspect "traduction incrémentale" ait été
prise en compte. AMHA, il a seulement été tenu compte de l'écriture +
génération des documents en sorties.


Vus les sources, un petit diff textuel de base devrait permettre sans trop de problème de récupérer au moins les paragraphes modifiés. Mais le boulot initial est de toutes façons assez monstrueux, et ça prendra quand même du temps de maintenir les docs à jour, aussi bien faites soient-elles.
--
python -c "print ''.join([chr(154 - ord(c)) for c in 'U(17zX(%,5.zmz5(17;8(%,5.Z65'*9--56l7+-'])"

Avatar
Paul
Il y à un bon cours sur Python de 368 pages en français ici :
http://python.developpez.com/cours/TutoSwinnen/

Il y à aussi ce tutoriel Python de 228 pages en français :
http://python.developpez.com/cours/DiveIntoPython/
Avatar
Do Re Mi chel La Si Do
Tiens, le retour de Developpez.com.

En plus, ils ont allègrement récupéré "Dive into Python", et la (vieille et
partielle) traduction française.
A lire l'article de présentation, on pourrait même croire que c'est eux qui
sont à l'origine de ce document.

Je conseille aux lecteurs de rechercher, dans le présent newsgroup, les
messages qui parlent de ce site.


@-salutations

Michel Claveau
Avatar
Paul
Je ne comprends pas très bien tes allusions, je connais très bien l'équipe
de rédaction qui s'occupe de ce site (c'est une sympatique équipe de
bénévoles, voir http://club.developpez.com/club/,
et je suis certains qu'il n'auraient pas publié ces documents sans
l'autorisation des auteurs concernés.

Ca fait quelque temps que developpez.com, (qui je le rappelle est le site le
plus fréquenté des développeurs francophones) fait des efforts pour essayer
de publier des ressources sur Python (cours / tutoriels/ faq, etc), je peux
t'affirmer avec certitude que c'est une excellente chose pour faire
connaitre plus largement Python auprès des développeurs francophones, qui
fréquentent très massivement ce site.

Si il y à des erreurs dans les documents qu'ils publient, je supose que tu
es le bienvenu pour leur envoyer tes remarques, le responsable de la
rybrique python est affiché en bas de page de la rubrique :
http://python.developpez.com/.

Donc si tu as quelque chose à lui dire, envoi lui un email directement, et
si une quelquonque erreur à été fait, je ne voi pas pourquoi il ne te
donnerais pas satisfaction.
Avatar
Do Re Mi chel La Si Do
Bonsoir !


Pour t'éviter de chercher dans les archives de ce NG, je vais redire ce qui
m'est arrivé "là-bas" :

- suppression de messages, sans prévenir ;
- annulation de compte ;
- accusation de "vol de visiteurs", parce que j'avais donné l'adresse de
pages de mon site, qui traitaient du sujet en question ;
- suppression de liens donnés.

Précisions : il ne s'agissait pas de Python ; et, si je suis, de temps en
temps, un peu trolleur, je ne suis JAMAIS, ni injurieux, ni insultant. Et
j'ai parlé uniquement de mon cas.


@-salutations

Michel Claveau
Avatar
Paul
Donc ca n'à rien a voir avec le sujet.

Leur forum est modéré, leurs regles sont ici :
http://club.developpez.com/regles/, si tu as eu des problêmes avec leur
équipe de modération c'est bien domage mais c'est totalement HS ici.

Par ailleurs je trouve cela très domage, par exemple toi qui organise des
événements sur paradox, tu aurais certainement pu toucher une audience plus
large en fesant connaitre tes évenements sur www.developpez.com , sachant
qu'ils ont une audience d'environ 50 000 visiteurs par jours si j'ai bien
compris, voir pourquoi pas faire un événement en commun avec eux.

Mais je ne pense pas que de les "dénigrer" publiquement sur ce newsgroup ,
concernant des sujets qui te sont personnels, puisse améliorer la situation,
ca n'est pas très constructif.

De plus l'équipe de modération de developpez.com à changé récement, et il y
à un nouveau responsable de la modération : netah25 .

De par le fait je pense que tu parles probablement d'un "accrochage" avec un
modérateur qui n'est si ca se trouve meme plus dans l'équipe actuelle.
(l'équipe de rédaction et de modération est constituée de 200 personnes
environ).

Bref tous cela est HS.

Le sujet c'est de voir comment avoir plus de docs en français sur Python, et
accessoirement de mieux faire connaitre Python aux développeurs
francophones. Le succès de Python sur les francophones est loin de ce qu'il
est sur les anglophones, donc nous devons tous ensemble mieux faire
connaitre python et les ressources en français sur Python.
1 2 3 4 5