From bdd47943389b8950d61c3286318b67489085ad81 Mon Sep 17 00:00:00 2001 From: HucSte Date: Wed, 12 Jun 2019 20:59:45 +0200 Subject: [PATCH 1/8] =?UTF-8?q?Modifications=20du=20fichier=20README=C2=A0?= =?UTF-8?q?:=20essaie=20de=20restituer=20plus=20clairement=20les=20infos?= =?UTF-8?q?=20concernant=20la=20section=20'::'=20et=20'Compose'.?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.rst | 66 +++++++++++++++++++++++++++++++++++++++--------------- 1 file changed, 48 insertions(+), 18 deletions(-) diff --git a/README.rst b/README.rst index f932e1660..f04969e21 100644 --- a/README.rst +++ b/README.rst @@ -229,38 +229,68 @@ 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 *reStructuredText*, qui est le langage de sphynx, l'outil de + 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 un fichier rst anglais, 'rst' est le format de fichier du langage +*reStructuredText*, un format de fichier enrichi, 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, +é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 +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``. + +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. +suit n'affichera rien et introduira le bloc de code. + +Ce qui donnera le visuel suivant : `` : ::`` + +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. 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 `_, 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 `_, +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 : +``# key Compose +keycode 115 = Multi_key``. +Utilisez ``xdev`` pour connaitre la bonne correspondance de la touche que vous +voulez assigner ! + +Ensuite, dans votre fichier '~/.xsession', ajoutez : +``# 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 `_. Avec une touche de composition (personnellement j'utilise ``alt-gr``, @@ -363,7 +393,7 @@ statement instruction subprocess sous-processus thread fil d'exécution underscore tiret bas, *underscore* -expression expression +expression expression ========================== =========================================== Historique du projet From df8acb606257b3e37eb5dd1c387b259b63e7d5a9 Mon Sep 17 00:00:00 2001 From: HucSte Date: Thu, 13 Jun 2019 01:38:32 +0200 Subject: [PATCH 2/8] =?UTF-8?q?Modifications=20du=20fichier=20README=C2=A0?= =?UTF-8?q?:=20gestion=20de=20bloc=20de=20code=20=3F!?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.rst | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/README.rst b/README.rst index f04969e21..2e3689818 100644 --- a/README.rst +++ b/README.rst @@ -277,14 +277,18 @@ 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 : -``# key Compose -keycode 115 = Multi_key``. +``` +# key Compose +keycode 115 = Multi_key +``` Utilisez ``xdev`` pour connaitre la bonne correspondance de la touche que vous voulez assigner ! Ensuite, dans votre fichier '~/.xsession', ajoutez : -``# Gestion des touches clavier -xmodmap $HOME/.Xmodmap`` +``` +# 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'. From 12e64acaebd307322c55f2e6baeefc978dbac3bf Mon Sep 17 00:00:00 2001 From: HucSte Date: Thu, 13 Jun 2019 02:01:34 +0200 Subject: [PATCH 3/8] =?UTF-8?q?Modifications=20du=20fichier=20README=C2=A0?= =?UTF-8?q?:=20gestion=20de=20bloc=20de=20code=20correcte?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.rst | 15 +++++++-------- 1 file changed, 7 insertions(+), 8 deletions(-) diff --git a/README.rst b/README.rst index 2e3689818..47a90e26b 100644 --- a/README.rst +++ b/README.rst @@ -277,18 +277,17 @@ 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 : -``` -# key Compose -keycode 115 = Multi_key -``` +.. code-block:: shell + # key Compose + keycode 115 = Multi_key + Utilisez ``xdev`` pour connaitre la bonne correspondance de la touche que vous voulez assigner ! Ensuite, dans votre fichier '~/.xsession', ajoutez : -``` -# Gestion des touches clavier -xmodmap $HOME/.Xmodmap -``` +.. 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'. From 9e77c64ee18d99f8cfcded293f33947c23cb7362 Mon Sep 17 00:00:00 2001 From: HucSte Date: Thu, 13 Jun 2019 02:05:39 +0200 Subject: [PATCH 4/8] =?UTF-8?q?Modifications=20du=20fichier=20README=C2=A0?= =?UTF-8?q?:=20gestion=20de=20bloc=20de=20code=20correcte=20!?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.rst | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/README.rst b/README.rst index 47a90e26b..ce795ccd5 100644 --- a/README.rst +++ b/README.rst @@ -229,12 +229,10 @@ transformer en ``—`` en français. Le cas de "::" ~~~~~~~~~~~~~~ -Du point de vue du *reStructuredText*, qui est le langage de sphynx, l'outil de - documentation : +Du point de vue du *reStructuredText*, qui est le langage de sphynx, l'outil de documentation : -- ``::`` 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". +=> ``::`` 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 un fichier rst anglais, 'rst' est le format de fichier du langage *reStructuredText*, un format de fichier enrichi, nous voyons soit "bla bla::", @@ -277,7 +275,9 @@ 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 @@ -285,7 +285,9 @@ Utilisez ``xdev`` 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 From 20ff461c279cbbdedb3110b9f99571e0e2f12d31 Mon Sep 17 00:00:00 2001 From: HucSte Date: Sat, 15 Jun 2019 16:41:23 +0200 Subject: [PATCH 5/8] Fix: adding new ligne after codeblock --- README.rst | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.rst b/README.rst index ce795ccd5..a2f7b2b50 100644 --- a/README.rst +++ b/README.rst @@ -281,6 +281,7 @@ clavier ou via ``dpkg-reconfigure keyboard-configuration`` # key Compose keycode 115 = Multi_key + Utilisez ``xdev`` pour connaitre la bonne correspondance de la touche que vous voulez assigner ! @@ -291,6 +292,7 @@ Ensuite, dans votre fichier '~/.xsession', ajoutez : # 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. From 8af54d90351804b08e8a8104380b8f71bc0e6351 Mon Sep 17 00:00:00 2001 From: HUC Date: Sun, 16 Jun 2019 17:11:30 +0200 Subject: [PATCH 6/8] Update README.rst Co-Authored-By: Julien Palard --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index a2f7b2b50..3fef8473e 100644 --- a/README.rst +++ b/README.rst @@ -229,7 +229,7 @@ transformer en ``—`` en français. Le cas de "::" ~~~~~~~~~~~~~~ -Du point de vue du *reStructuredText*, qui est le langage de sphynx, l'outil de documentation : +Du point de vue du langage *reStructuredText* (ou *rst*) utilisé dans la documentation : => ``::`` 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". From 0e7106779e7f72c2c4ed4354a38d3302bdc9ff2a Mon Sep 17 00:00:00 2001 From: HUC Date: Sun, 16 Jun 2019 17:11:54 +0200 Subject: [PATCH 7/8] Update README.rst Co-Authored-By: Julien Palard --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 3fef8473e..091bfd44b 100644 --- a/README.rst +++ b/README.rst @@ -234,7 +234,7 @@ Du point de vue du langage *reStructuredText* (ou *rst*) utilisé dans la docume => ``::`` 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 un fichier rst anglais, 'rst' est le format de fichier du langage +Donc, dans du *rst*, en anglais, *reStructuredText*, un format de fichier enrichi, nous voyons soit "bla bla::", soit "bla bla. ::". From c1b1cca99189d8ffb5ac933aa505ac86d1620035 Mon Sep 17 00:00:00 2001 From: HUC Date: Sun, 16 Jun 2019 17:12:10 +0200 Subject: [PATCH 8/8] Update README.rst Co-Authored-By: Julien Palard --- README.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.rst b/README.rst index 091bfd44b..1c6520233 100644 --- a/README.rst +++ b/README.rst @@ -235,7 +235,7 @@ Du point de vue du langage *reStructuredText* (ou *rst*) utilisé dans la docume mais un ``::`` après une espace signifie "introduit juste un bloc de code". Donc, dans du *rst*, en anglais, -*reStructuredText*, un format de fichier enrichi, nous voyons soit "bla bla::", +nous voyons soit "bla bla::", soit "bla bla. ::". En français, nous mettons une espace insécable devant nos deux-points, comme :