traduction du début du dossier extending #173

Merged
mdk merged 8 commits from ChristopheNan/python-docs-fr:extending1 into 3.11 2023-11-26 15:15:54 +00:00
Collaborator
No description provided.
ChristopheNan added 1 commit 2023-07-26 20:57:45 +00:00
ci/woodpecker/pr/woodpecker Pipeline failed Details
b18460fcf4
traduction du début du dossier extending
ChristopheNan added 1 commit 2023-07-27 05:31:09 +00:00
ci/woodpecker/pr/woodpecker Pipeline was successful Details
ed14b93e57
typographie
mdk reviewed 2023-07-27 15:38:40 +00:00
@ -32,2 +30,2 @@
"Elles peuvent définir de nouveaux types natifs, et peuvent appeler des "
"fonctions de bibliothèques C ou faire des appels systèmes."
"savez programmer en C. Ces :dfn:`modules d'extension` permettent deux choses "
"qui ne sont pas possibles directement en Python : Ils peuvent définir de "
Owner

s/Ils/ils/

s/Ils/ils/
ChristopheNan marked this conversation as resolved
mdk reviewed 2023-07-27 15:43:49 +00:00
@ -471,0 +462,4 @@
"être enlevée du module par du code externe, une référence à la classe est "
"nécessaire pour assurer qu'elle ne sera pas supprimée par le ramasse-"
"miettes, entraînant que :c:data:`SpamError` devienne un pointeur dans le "
"vide. Si cela se produisait, le C code qui lève cette exception peut "
Owner

s/C code/code C/

s/C code/code C/
ChristopheNan marked this conversation as resolved
mdk reviewed 2023-07-27 15:45:12 +00:00
@ -607,3 +602,3 @@
#: extending/extending.rst:338
msgid ""
"The :const:`METH_KEYWORDS` bit may be set in the third field if keyword "
"The :c:macro:`METH_KEYWORDS` bit may be set in the third field if keyword "
Owner

Pourquoi un changement dans le msgid? recherché-remplacé ?

Pourquoi un changement dans le msgid? recherché-remplacé ?
Author
Collaborator
Hum, bizarre ce diff ! https://git.afpy.org/AFPy/python-docs-fr/src/branch/3.11/extending/extending.po#L611
Author
Collaborator

Il y a moyen de voir si le msgid provient bien de la révision afa24d52b821 ?
142fb63d76/Makefile (L23)

Il y a moyen de voir si le msgid provient bien de la révision afa24d52b821 ? https://git.afpy.org/AFPy/python-docs-fr/src/commit/142fb63d7657b3c8ecb32701ce4d6e08a89f0511/Makefile#L23
Author
Collaborator

Le problème était de mon côté.
J'ai fusionné upstream 3.11 et corrigé les fuzzys sur extending/extending.po

Le problème était de mon côté. J'ai fusionné upstream 3.11 et corrigé les fuzzys sur extending/extending.po
ChristopheNan marked this conversation as resolved
mdk reviewed 2023-07-27 16:03:21 +00:00
@ -669,3 +661,1 @@
"(un tableau de structures :c:type:`PyMethodDef`) trouvée dans la définition "
"du module. :c:func:`PyModule_Create` renvoie un pointeur vers l'objet module "
"qu'il crée. Il peut s'interrompre avec une erreur fatale pour certaines "
"fois, :c:func:`PyInit_spam` est appelée. (Voir ci-dessous pour les "
Owner

J'ai entendu un jour qu'on ne pouvais mettre une phrase entière entre parenthèses. J'ignore la légitimité de la chose.

Selon le Lexiques des règles typographiques en usage à l'imprimerie nationale :

Les parenthèses servent à intercaler dans une phrase […]

Ça sous-entends vaguement que non, on ne peut pas les utiliser pour mettre des phrases dedans.

Dans Petites leçons de typographie :

Toutefois on ne met pas, en début de phrase, de virgule jouant le
rôle de parenthèse ouvrante et on ne met pas, en fin de phrase, de
virgule jouant le rôle de parenthèse fermante.

Ce qui semble admettre, au moins, la présence d'une parenthèse en début de phrase (sans explicitement autoriser qu'elle aille jusqu'à la fin !).

Dans le même ouvrage on trouve :

Notons que l’habitude, américaine, de mettre des notes entière-
ment entre parenthèses et de les considérer comme une phrase
n’a, en général, pas de raison d’être en français. Exemple :

Mauvais : … et le temps d’exécution est négligeable. (On ne tient
pas compte du cas où v = 0.) Si…
Bon : … et le temps d’exécution est négligeable (on ne tient
pas compte du cas où v = 0). Si…
Mieux : … et le temps d’exécution est négligeable ; on ne tient
toutefois pas compte du cas où v = 0. Si…

J'ai entendu un jour qu'on ne pouvais mettre une phrase entière entre parenthèses. J'ignore la légitimité de la chose. Selon le Lexiques des règles typographiques en usage à l'imprimerie nationale : > Les parenthèses servent à intercaler dans une phrase […] Ça sous-entends vaguement que non, on ne peut pas les utiliser pour mettre des phrases dedans. Dans [Petites leçons de typographie](http://jacques-andre.fr/faqtypo/lessons.pdf) : > Toutefois on ne met pas, en début de phrase, de virgule jouant le rôle de parenthèse ouvrante et on ne met pas, en fin de phrase, de virgule jouant le rôle de parenthèse fermante. Ce qui semble admettre, au moins, la présence d'une parenthèse en début de phrase (sans explicitement autoriser qu'elle aille jusqu'à la fin !). Dans le même ouvrage on trouve : > Notons que l’habitude, américaine, de mettre des notes entière- ment entre parenthèses et de les considérer comme une phrase n’a, en général, pas de raison d’être en français. Exemple : > > **Mauvais** : … et le temps d’exécution est négligeable. (On ne tient pas compte du cas où v = 0.) Si… **Bon** : … et le temps d’exécution est négligeable (on ne tient pas compte du cas où v = 0). Si… **Mieux** : … et le temps d’exécution est négligeable ; on ne tient toutefois pas compte du cas où v = 0. Si…
Author
Collaborator

Oui, je suis moins rigoureux avec le temps. Je vais inclure les parenthèses dans les phrases où c'est « facile ».

Oui, je suis moins rigoureux avec le temps. Je vais inclure les parenthèses dans les phrases où c'est « facile ».
ChristopheNan marked this conversation as resolved
ChristopheNan added 1 commit 2023-07-27 20:39:53 +00:00
ci/woodpecker/pr/woodpecker Pipeline was successful Details
4aa99c4fdf
relecture mdk
ChristopheNan added 1 commit 2023-07-29 09:02:19 +00:00
ci/woodpecker/pr/woodpecker Pipeline was successful Details
165a6105b9
fusion upstream 3.11
mdk added 1 commit 2023-10-06 13:57:00 +00:00
ci/woodpecker/pr/woodpecker Pipeline was successful Details
6b31cae83e
Merge branch '3.11' into extending1
mdk reviewed 2023-11-25 10:59:40 +00:00
mdk left a comment
Owner

review partielle

review partielle
@ -745,0 +739,4 @@
"Il y a encore deux choses à faire avant de pouvoir utiliser votre nouvelle "
"extension : la compiler et la lier au système Python. Si vous utilisez le "
"chargement dynamique, les détails peuvent dépendre du style de chargement "
"dynamique utilisé par votre système ; voir les chapitres sur la construction "
Owner

s/construction/compilation/ ?

s/construction/compilation/ ?
ChristopheNan marked this conversation as resolved
@ -754,1 +755,4 @@
msgstr ""
"Si vous ne pouvez pas utiliser le chargement dynamique, ou si vous voulez "
"faire de votre module une partie permanente de l'interpréteur Python, vous "
"devez modifier la configuration de la configuration et reconstruire "
Owner

s/configuration de la configuration/configuration/ ?

s/configuration de la configuration/configuration/ ?
ChristopheNan marked this conversation as resolved
@ -764,0 +772,4 @@
"et reconstruisez l'interpréteur en exécutant :program:`make` dans le "
"répertoire de niveau supérieur. Vous pouvez également exécuter :program:"
"`make` dans le sous-répertoire :file:`Modules/`, mais vous devez d'abord "
"reconstruire le :file:`Makefile` en exécutant :program:`make` Makefile "
Owner

en exécutant :program:`make` Makefileen exécutant ':program:`make` Makefile' ?

``en exécutant :program:`make` Makefile`` → ``en exécutant ':program:`make` Makefile'`` ?
Author
Collaborator

Mis entre guillemets français.

Mis entre guillemets français.
ChristopheNan marked this conversation as resolved
@ -767,3 +780,4 @@
"If your module requires additional libraries to link with, these can be "
"listed on the line in the configuration file as well, for instance:"
msgstr ""
"Si votre module nécessite des bibliothèques supplémentaires à lier, celles-"
Owner

Si votre module nécessite des bibliothèques supplémentaires à lierSi votre module nécessite d'être lié à des bibliothèques supplémentaires ?

`Si votre module nécessite des bibliothèques supplémentaires à lier` → `Si votre module nécessite d'être lié à des bibliothèques supplémentaires` ?
ChristopheNan marked this conversation as resolved
@ -768,2 +781,4 @@
"listed on the line in the configuration file as well, for instance:"
msgstr ""
"Si votre module nécessite des bibliothèques supplémentaires à lier, celles-"
"ci peuvent également être répertoriées sur la ligne du fichier de "
Owner
- ci peuvent également être répertoriées sur la ligne du fichier de
+ ci peuvent être ajoutées à la fin de la ligne de votre module dans le fichier de
```diff - ci peuvent également être répertoriées sur la ligne du fichier de + ci peuvent être ajoutées à la fin de la ligne de votre module dans le fichier de ```
ChristopheNan marked this conversation as resolved
@ -785,0 +803,4 @@
"appeler des fonctions Python depuis C. C'est notamment le cas pour les "
"bibliothèques qui gèrent les fonctions dites de « rappel » (*callback* en "
"anglais). Si une interface C utilise des rappels, l'équivalent Python doit "
"souvent fournir un mécanisme de rappel au programmeur Python ; "
Owner

s/programmeur/développeur/ ?

s/programmeur/développeur/ ?
ChristopheNan marked this conversation as resolved
mdk reviewed 2023-11-25 16:31:27 +00:00
@ -1086,2 +1163,4 @@
"crashes."
msgstr ""
"Chaque bloc de mémoire alloué avec :c:func:`malloc` doit finalement être "
"redonné au pool de mémoire disponible par exactement un appel à :c:func:"
Owner
- "redonné au pool de mémoire disponible par exactement un appel à :c:func:"
+ "libéré par exactement un appel à :c:func:" 

juste pour éviter d'utiliser pool ?

```diff - "redonné au pool de mémoire disponible par exactement un appel à :c:func:" + "libéré par exactement un appel à :c:func:" ``` juste pour éviter d'utiliser `pool` ?
ChristopheNan marked this conversation as resolved
ChristopheNan added 1 commit 2023-11-25 16:33:42 +00:00
mdk reviewed 2023-11-25 16:39:42 +00:00
@ -1105,0 +1202,4 @@
"telles fuites, une fois introduites, passent souvent inaperçues pendant "
"longtemps : la sortie d'erreur n'est prise que dans une petite fraction de "
"tous les appels, et la plupart des machines modernes ont beaucoup de mémoire "
"virtuelle, de sorte que la fuite ne devient apparente que dans un processus "
Owner

"fonction de fuite" → "cette fonction" ?

"fonction de fuite" → "cette fonction" ?
ChristopheNan marked this conversation as resolved
mdk reviewed 2023-11-25 17:07:15 +00:00
@ -1184,6 +1288,11 @@ msgid ""
"collect` function), as well as configuration interfaces and the ability to "
"disable the detector at runtime."
msgstr ""
Owner

Le détecteur de cycle est capable de détecter les cycles du ramasse-miettes

Ce n'est pas ce que je comprend en lisant gcmodule.c, donc je pense que "The cycle detector is able to detect garbage cycles" veut plutôt dire "le détecteur de cycle est capable de détecter les cycles dans les ordures".

Je peux essayer de proposer :

Le détecteur de cycle est capable de détecter les cycles isolés, et peut récupérer la mémoire afférente.

> Le détecteur de cycle est capable de détecter les cycles du ramasse-miettes Ce n'est pas ce que je comprend en lisant `gcmodule.c`, donc je pense que "The cycle detector is able to detect garbage cycles" veut plutôt dire "le détecteur de cycle est capable de détecter les cycles dans les ordures". Je peux essayer de proposer : > Le détecteur de cycle est capable de détecter les cycles isolés, et peut récupérer la mémoire afférente.
ChristopheNan marked this conversation as resolved
ChristopheNan added 1 commit 2023-11-25 18:38:26 +00:00
mdk reviewed 2023-11-25 21:24:55 +00:00
@ -1293,2 +1412,4 @@
"reference to a cached item."
msgstr ""
"La plupart des fonctions qui renvoient une référence à un objet transmettent "
"la propriété avec la référence. En particulier, toutes les fonctions dont la "
Owner

Je vois propriété et possession utilisé de manière synonyme. Je suis pour éviter les répétitions en français, mais j'ai aussi peur que "propriété" soit mal interprété (ça fait penser à autre chose, synonyme d'attribut). Est-ce qu'on ne devrait pas uniformiser et parler de possession partout ? Dommage que la doc de rust ne soit pas traduite en français :D

Je vois `propriété` et `possession` utilisé de manière synonyme. Je suis pour éviter les répétitions en français, mais j'ai aussi peur que "propriété" soit mal interprété (ça fait penser à autre chose, synonyme d'attribut). Est-ce qu'on ne devrait pas uniformiser et parler de possession partout ? Dommage que la doc de rust ne soit pas traduite en français :D
ChristopheNan marked this conversation as resolved
mdk reviewed 2023-11-25 22:26:23 +00:00
@ -1324,0 +1464,4 @@
"indépendant. Il existe exactement deux exceptions importantes à cette "
"règle : :c:func:`PyTuple_SetItem` et :c:func:`PyList_SetItem`. Ces fonctions "
"s'approprient l'élément qui leur est transmis, même en cas d'échec ! (Notez "
"que :c:func:`PyDict_SetItem` et les amis ne prennent pas la possession de "
Owner

s/et les amis/et companie/ ? :D

s/et les amis/et companie/ ? :D
ChristopheNan marked this conversation as resolved
ChristopheNan added 1 commit 2023-11-26 09:30:06 +00:00
mdk reviewed 2023-11-26 15:11:52 +00:00
@ -1436,3 +1597,3 @@
msgstr ""
"Le deuxième cas de problèmes liés à une référence empruntée est une variante "
"impliquant des fils de discussion. Normalement, plusieurs threads dans "
"impliquant des fils d'exécution. Normalement, plusieurs threads dans "
Owner

Haha :_)))

Haha :_)))
mdk approved these changes 2023-11-26 15:15:39 +00:00
mdk merged commit 6e3ce23f62 into 3.11 2023-11-26 15:15:54 +00:00
Sign in to join this conversation.
No reviewers
mdk
No Milestone
No project
No Assignees
2 Participants
Notifications
Due Date
The due date is invalid or out of range. Please use the format 'yyyy-mm-dd'.

No due date set.

Dependencies

No dependencies set.

Reference: AFPy/python-docs-fr#173
No description provided.