espoir/python-docs-fr
Fork 0
forked from AFPy/python-docs-fr
Code Pull requests Activity

Update README.rst Modifications du fichier README. closes #820

Browse source 
Essai de restituer plus clairement les infos concernant la section '::' et 'Compose'.
This commit is contained in:
HUC 2019-06-20 14:21:57 +02:00 • committed by Julien Palard
commit 2bda8a40ec
1 changed files with 56 additions and 20 deletions
Download patch file Download diff file Expand all files Collapse all files

76
README.rst
View file

@ -229,38 +229,74 @@ transformer en ``—`` en français.
Le cas de "::"
~~~~~~~~~~~~~~
Du point de vue du *reStructuredText*, ``::`` collé à la fin d'un mot
signifie "affiche ``:`` et introduit un bloc de code", mais un ``::``
après une espace signifie "introduit juste un bloc de code".
Du point de vue du langage *reStructuredText* (ou *rst*) utilisé dans la documentation :
Donc, dans un fichier rst anglais, nous voyons soit "bla bla::", soit
"bla bla. ::".
=> ``::`` collé à la fin d'un mot signifie "affiche ``:`` et introduit un bloc de code",
mais un ``::`` après une espace signifie "introduit juste un bloc de code".
Donc, dans du *rst*, en anglais, nous voyons soit "bla bla::", soit "bla bla. ::".
En français, nous mettons une espace insécable devant nos deux-points, comme :
"Et voilà :".
L'utilisation de l'espace insécable en rst est naturelle, vous n'aurez qu'à
écrire ``Et voilà ::``. Comme le ``::`` n'est pas précédé d'un espace normal,
L'utilisation de l'espace insécable en *rst* est naturelle, vous n'aurez qu'à
écrire ``Et voilà ::``. Le ``::`` n'est pas précédé d'un espace normal,
il affichera les deux-points et introduira le bloc de code, et c'est bon.
Si vous ne savez pas comment taper une espace insécable, il y a une astuce.
Traduisez ``deux-points deux-points`` par
``espace deux-points espace deux-points deux-points``. La balise
``espace deux-points`` donnera un rendu de votre espace et vos deux-points
comme le français l'exige, et la balise ``espace deux-points deux-points`` qui
suit n'affichera rien et introduira le bloc de code. Non, il n'insère
pas magiquement une espace insécable donc ce n'est toujours pas
vraiment du français valide. Oui, il vaut mieux apprendre à taper
les espaces insécables.
Si vous ne savez pas comment taper une espace insécable, il y a une astuce :
lisez celle de la touche Compose dans la section suivante ; sinon :
=> Traduisez ``deux-points deux-points`` par
``espace deux-points espace deux-points deux-points``.
Les caractères ``espace deux-points`` sont restitués tel quel,
c'est du français correct, et la balise ``espace deux-points deux-points`` qui
suit n'affichera rien et introduira le bloc de code.
Dans un ``.po`` ça donne : `` : ::``
Non ! Ça n'insère pas magiquement une espace insécable donc ce n'est toujours pas
vraiment du français valide.
Oui ! il vaut mieux apprendre à taper les espaces insécables.
Comment saisir des em-dash, des ellipses, des guillemets français, ou des espaces insécables ?
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
Malheureusement, cela dépend de votre système d'exploitation et de votre clavier.
Sous Linux, vous pouvez utilisez une `Touche de composition <https://fr.wikipedia.org/wiki/Touche_de_composition>`_, c'est
facile à configurer à l'aide de l'outil graphique de configuration de votre
clavier ou via ``dpkg-reconfigure keyboard-configuration``. Sous Windows, vous
=> Sous Linux/Unix/*BSD (tel OpenBSD), vous pouvez utilisez une
`Touche de composition <https://fr.wikipedia.org/wiki/Touche_de_composition>`_,
c'est facile à configurer à l'aide de l'outil graphique de configuration de votre
clavier ou via ``dpkg-reconfigure keyboard-configuration``
(pour Ubuntu ou Debian et distributions assimilées)
À minima, vous pouvez configurer votre fichier '~/.Xmodmap' pour ajouter l'équivalent de :
.. code-block:: shell
# key Compose
keycode 115 = Multi_key
Utilisez ``xev`` pour connaitre la bonne correspondance de la touche que vous
voulez assigner !
Ensuite, dans votre fichier '~/.xsession', ajoutez :
.. code-block:: shell
# Gestion des touches clavier
xmodmap $HOME/.Xmodmap
Sous X, avec un bureau graphique, tel que Gnome, ou Xfce, il faut aller modifier
dans les paramètres > clavier > Disposition : puis 'Touche composée'.
Pour finir, redémarrez votre session.
=> Sous Windows, vous
pouvez utiliser `wincompose <https://github.com/SamHocevar/wincompose>`_.
Avec une touche de composition (personnellement j'utilise ``alt-gr``,
@ -363,7 +399,7 @@ statement instruction
subprocess sous-processus
thread fil d'exécution
underscore tiret bas, *underscore*
expression expression
expression expression
========================== ===========================================
Historique du projet