Skip to content
This repository has been archived by the owner. It is now read-only.

Priorités et qui fait quoi #32

Closed
JulienPalard opened this issue Jan 18, 2016 · 16 comments
Closed

Priorités et qui fait quoi #32

JulienPalard opened this issue Jan 18, 2016 · 16 comments

Comments

@JulienPalard
Copy link
Contributor

@JulienPalard JulienPalard commented Jan 18, 2016

J'ai obtenu les stats d'accès à docs.python.org, on peut en déduire un ordre de priorité que voici, choisissez vos section en partant par le haut de cette liste, et réservez les en commentant ce ticket (pour pas que deux personnes ne travaillent sur le même sujet) :

(Ce qui est terminé est coché, ce qui est réservé indiqué explicitement en gras)

  • library/functions.po
  • tutorial/datastructures.po
  • library/stdtypes.po Réservé par @JulienPalard
  • tutorial/inputoutput.po
  • library/string.po
  • library/re.po Réservé par @grenoya
  • library/datetime.po Réservé par @Nodraak
  • tutorial/errors.po
  • library/builtins.po
  • tutorial/controlflow.po
  • tutorial/classes.po
  • library/builtins.po
  • tutorial/modules.po
  • library/os.po
  • library/subprocess.po
  • library/math.po
  • library/csv.po Réservé par @Shloub
  • library/json.po
  • library/functions.po
  • library/random.po
  • library/exceptions.po
  • library/os.path.po
  • library/time.po
  • library/stdtypes.po
  • tutorial/introduction.po
  • library/constants.po
  • library/collections.po
  • library/itertools.po
  • tutorial/index.po
  • library/unittest.po
  • library/socket.po
  • library/multiprocessing.po
  • library/struct.po
  • library/xml.etree.elementtree.po
  • library/logging.po
  • library/datetime.po
  • library/argparse.po
  • library/threading.po
  • howto/regex.po Réservé par @crunchylian
  • tutorial/datastructures.po
  • tutorial/appetite.po
  • library/index.po
  • tutorial/controlflow.po
  • library/argparse.po
  • library/sys.po
  • howto/unicode.po

Hors top 50 des stats:

Pour travailler sur une section moi je m'y prend comme ça:

  • Extraire la section avec msggrep
  • La traduire avec Google Translate
  • Travailler
  • Merger

Extraire la section avec msggrep

Pour travailler dans library.po typiquement, ça peut être agréable d'en extraire une partie, et msggrep rend ça facile:

$ msggrep -N '../Doc/library/functions.rst' 3.6/library.po > functions.po

Traduire un .po avec Google Translate

L'avantage de "pré traduire" par Google Translate, c'est pour moi d'économiser des touches (je traduit sur téléphone) et parfois le vocabulaire que Google Translate trouve est intéressant et m'économise une coûteuse recherche dans ma tête.

L'astuce ici consiste à cacher les parties qu'on ne veut pas traduire à Google, du genre :func:str, car quand il traduit ça c'est chiant. Les traductions de Google sont toutes marquées, évidemment, fuzzy, pour ne pas les mélanger avec les vôtres, les vraies.

$ ./scripts/po2csv.py --untranslated-only --mangle functions.po functions.csv
$ # Upload in a Google Sheet
$ # Use googleTranslate(a1, "en", "fr") to translate them all
$ # Dowload it back as csv
$ ./scripts/csv2po.py --unmangle functions.csv functions.po
$ ./scripts/fixpo.py --only-fuzzy functions.po # To fix some typical Google Translate fuckeries

Merge

Moi personnellement je traduis dans le métro, donc j'utilise Vé sur Android, dropbox pour stocker les .po et dropsync pour les synchroniser.

Lorsque je veux merger, j'utilise replicate_translations.py pour merger mes traductions dans le vrai .po :

$ ./scripts/replicate_translations.py --files 3.6/library.po functions.po

Je teste voir si sphinx-doc ne geule pas à coup de make build RELEASE=3.6, si sphinx gueule je ne touche pas à 3.6/library.po mais à mon .po de travail que je re-merge via replicate_translations.po, comme ça mon .po de travail reste à jour, et je ne risque pas de me faire écraser mes fix au prochain merge.

Une fois le merge clean, je merge dans les autres versions :

$ ./scripts/replicate_translations.py
@JulienPalard JulienPalard changed the title Priorités dans `library.po` Priorités Feb 16, 2016
@JulienPalard JulienPalard changed the title Priorités Priorités et qui fait quoi Feb 16, 2016
@ewdurbin

This comment has been minimized.

Copy link

@ewdurbin ewdurbin commented Mar 10, 2016

top 50:

   1410 /2/tutorial/appetite.html"
   1456 /2/howto/unicode.html"
   1456 /3/tutorial/datastructures.html"
   1470 /2/library/sys.html"
   1480 /3/library/index.html"
   1546 /2/library/configparser.html"
   1583 /2/howto/regex.html"
   1681 /3/library/argparse.html"
   1696 /2/library/argparse.html"
   1852 /2/library/xml.etree.elementtree.html"
   1900 /2/library/threading.html"
   1964 /2/library/logging.html"
   1996 /3/tutorial/index.html"
   2000 /2.7/library/datetime.html"
   2163 /2/tutorial/introduction.html"
   2231 /2/library/unittest.html"
   2242 /2/library/socket.html"
   2306 /2/library/struct.html"
   2325 /2/library/multiprocessing.html"
   2335 /2/library/constants.html"
   2350 /2/library/sets.html"
   2426 /3/library/stdtypes.html"
   2451 /2/library/collections.html"
   2497 /3/search.html"
   2668 /2/library/itertools.html"
   2815 /2/library/os.path.html"
   2961 /2/library/exceptions.html"
   3111 /2/library/time.html"
   3150 /3/library/functions.html"
   3309 /2/library/subprocess.html"
   3403 /2/library/math.html"
   3889 /2/library/json.html"
   4108 /2/library/csv.html"
   4126 /2/library/random.html"
   4291 /2/tutorial/controlflow.html"
   4298 /2/library/os.html"
   4318 /2/tutorial/modules.html"
   4663 /3.4/library/builtins.html"
   4891 /2/tutorial/classes.html"
   5230 /2/search.html"
   5319 /3.5/library/builtins.html"
   6394 /2/library/datetime.html"
   6533 /2/tutorial/errors.html"
   6646 /2/library/re.html"
   6905 /2/library/string.html"
   7138 /2/library/stdtypes.html"
   8216 /2/tutorial/inputoutput.html"
   9819 /2/tutorial/datastructures.html"
  13332 /2/library/functions.html"
  26679 /2.7/library/__builtin__.html"

Total Line Count for sample (html only): 478170

@JulienPalard

This comment has been minimized.

Copy link
Contributor Author

@JulienPalard JulienPalard commented Mar 10, 2016

Grâce à @ewdurbin, nous avons quelques stats:

  • 88% Python 2 vs 12% Python 3, en espérant que ce soit des utilisateurs de python 3 qui lisent la doc de python 2 (qui doit être devant dans les SERPs.)
  • The top 50 pages que nous avons ici couvre 41% du traffic

Et voici, en s'abstrayant de la version de Python, les pages les plus lues dans l'ordre, en gras ce qui est déjà traduit

  • /library/builtin.html 5.48%
  • /library/functions.html 3.35%
  • /tutorial/datastructures.html 2.28%
  • /library/builtins.html 2.03%
  • /library/stdtypes.html 1.94%
  • /library/datetime.html 1.71%
  • /tutorial/inputoutput.html 1.67%
  • /search.html 1.58%
  • /library/string.html 1.40%
  • /library/re.html 1.35%
  • /tutorial/errors.html 1.33%
  • /tutorial/classes.html 0.99%
  • /tutorial/modules.html 0.88%
  • /library/os.html 0.88%
  • /tutorial/controlflow.html 0.87%
  • /library/random.html 0.84%
  • /library/csv.html 0.83%
  • /library/json.html 0.79%
  • /library/math.html 0.69%
  • /library/argparse.html 0.69%
  • /library/subprocess.html 0.67%
  • /library/time.html 0.63%
  • /library/exceptions.html 0.61%
  • /library/os.path.html 0.57%
  • /library/itertools.html 0.54%
  • /library/collections.html 0.50%
  • /library/multiprocessing.html 0.48%
  • /library/constants.html 0.48%
  • /library/sets.html 0.48%
  • /library/struct.html 0.47%
  • /library/socket.html 0.46%
  • /library/unittest.html 0.46%
  • /tutorial/introduction.html 0.44%
  • /tutorial/index.html 0.41%
  • /library/logging.html 0.39%
  • /library/threading.html 0.39%
  • /library/xml.etree.elementtree.html 0.38%
  • /howto/regex.html 0.32%
  • /library/configparser.html 0.32%
  • /library/index.html 0.30%
  • /library/sys.html 0.30%
  • /howto/unicode.html 0.30%
  • /tutorial/appetite.html 0.29%

Nous avons donc traduit à la grosse louche 21.6% du besoin des utilisateurs (des visites).

@JulienPalard

This comment has been minimized.

Copy link
Contributor Author

@JulienPalard JulienPalard commented Mar 14, 2016

En supprimant un biais statistique introduit par un crower qui tapait sur __builtin__.html, nous en sommes en fait à 18.6% de fait, voici les 20% les plus requêtés (ceux en gras sont faits (parmis nos 18.6% traduits, des pages ne sont pass dans ce top 20)):

  • 4.1% /library/functions.html
  • 2.78 /tutorial/datastructures.html
  • 2.45 /library/stdtypes.html
  • 2.35 /tutorial/inputoutput.html
  • 1.89 /search.html
  • 1.89 /
  • 1.87 /library/string.html
  • 1.69 /library/re.html
  • 1.61 /library/datetime.html
  • 1.49 /tutorial/controlflow.html
  • 1.40 /tutorial/errors.html
  • 1.33 /library/csv.html
  • 1.27 /library/os.html
  • 1.16 /tutorial/classes.html
  • 1.11 /library/random.html
  • 1.07 /library/json.html
  • 1.06 /library/subprocess.html
  • 1.01 /tutorial/
@RobinPetit

This comment has been minimized.

Copy link
Contributor

@RobinPetit RobinPetit commented Apr 13, 2016

Je signale que je me lance sur library.po : string.rst.

EDIT:Travail fini dans #40.

@poliorcetics

This comment has been minimized.

Copy link

@poliorcetics poliorcetics commented Apr 14, 2016

Je suis en train de beaucoup avancer sur la faq (je n'avais pas vu que quelqu'un l'avait déjà prise).

@JulienPalard

This comment has been minimized.

Copy link
Contributor Author

@JulienPalard JulienPalard commented Apr 14, 2016

@poliorcetics: Je n'ai pas de nouvelle depuis fin janvier (#31) sur la réservation de la faq, il y a peu de chance qu'il y ai conflit, @amaddah qu'en est-il ?

@amaddah

This comment has been minimized.

Copy link

@amaddah amaddah commented Apr 14, 2016

@JulienPalard ; yop, pas de soucis, je n'ai plus avancé sur la faq depuis fin janvier. Bon courage @poliorcetics

@RobinPetit

This comment has been minimized.

Copy link
Contributor

@RobinPetit RobinPetit commented Apr 14, 2016

J'ai fait library.po : cmath.rst, et je me lance sur library.po : math.rst.

@JulienPalard

This comment has been minimized.

Copy link
Contributor Author

@JulienPalard JulienPalard commented Apr 15, 2016

@RobinPetit wah nice, n'hésite pas à pull-request.

@Nodraak

This comment has been minimized.

Copy link
Contributor

@Nodraak Nodraak commented Apr 17, 2016

Bonjour,
Je m'occupe du module library/datetime

@RobinPetit

This comment has been minimized.

Copy link
Contributor

@RobinPetit RobinPetit commented Apr 18, 2016

Je me charge de library/os.

@grenoya

This comment has been minimized.

Copy link
Member

@grenoya grenoya commented Oct 19, 2016

@Nodraak : où en es tu avec datetime ? as tu besoin d'aide ?

@grenoya

This comment has been minimized.

Copy link
Member

@grenoya grenoya commented Oct 19, 2016

Je réserve library/re

@Nodraak

This comment has been minimized.

Copy link
Contributor

@Nodraak Nodraak commented Oct 20, 2016

@grenoya J'avais pas mal avancé avant l'été (je suis environ aux 3/4 de memoire), mais j'avoue que j'ai complétement oublié de finir. Tu peux trouver tout ce que j'ai fait sur mon fork, branch translation/datetime. Je viens de squash les commits, mais le rebase foire, j'essayerais de regarder et de terminer la traduction dès que possible :)

@crunchylian

This comment has been minimized.

Copy link

@crunchylian crunchylian commented Oct 22, 2016

Salut !
Je vais prendre le howto pour les regex. :)

@Shloub

This comment has been minimized.

Copy link

@Shloub Shloub commented Apr 3, 2017

Bonjour,

Je vais m'essayer à library/csv.po

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Projects
None yet
9 participants
You can’t perform that action at this time.