Syncing docs (README + EXTENDING) re: Text/Label "paste"
This commit is contained in:
Bill Kendrick
parent
023fafe54f
commit
c7d449888d
29 changed files with 766 additions and 126 deletions
|
|
@ -5,7 +5,7 @@
|
|||
Copyright © 2002-2024 by divers contributeurs; voir AUTHORS.txt.
|
||||
https://tuxpaint.org/
|
||||
|
||||
octobre 10, 2024
|
||||
décembre 25, 2024
|
||||
|
||||
+-------------------------------------------------------------+
|
||||
| Table des matières |
|
||||
|
|
@ -1015,13 +1015,12 @@ jour de Makefile, pour s'assurer que les fichiers ".im" sont disponibles pour
|
|||
|
||||
Clavier virtuel sur écran
|
||||
|
||||
Depuis la version 0.9.22, les outils «Texte» et «Étiquette» de Tux Paint
|
||||
peuvent présenter un clavier à l'écran qui permet d'utiliser le pointeur (via
|
||||
une souris, des systèmes de suivi oculaire, etc.) pour saisir des caractères.
|
||||
Les fichiers qui décrivent la mise en page et les clés disponibles sont stockés
|
||||
dans le répertoire "osk" de Tux Paint . Chaque disposition de clavier est
|
||||
définie par un certain nombre de fichiers (dont certains peuvent être partagés
|
||||
par différentes dispositions).
|
||||
As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an
|
||||
on-screen keyboard that allows the pointer (via a mouse, touch screen,
|
||||
eye-tracking systems, etc.) to be used to input characters. Files that describe
|
||||
the layout and available keys are stored in Tux Paint "osk" directory. Each
|
||||
keyboard layout is defined by a number of files (some of which may be shared by
|
||||
different layouts).
|
||||
|
||||
Nous utiliserons le clavier QWERTY comme exemple :
|
||||
|
||||
|
|
@ -1036,9 +1035,9 @@ décrire l'agencement et la disposition des touches.
|
|||
keysymdefs keysymdef.h
|
||||
keyboardlist qwerty.layout default.layout
|
||||
|
||||
⚙ RemarqueLes lignes vides du fichier ".layout" sont ignorées, aussi bien que
|
||||
les lignes commençant par le caractère "#" ( livre/dièse)-- on peut l'utiliser
|
||||
pour ajouter des commentaires, comme dans l'exemple ci-dessus.
|
||||
⚙ Note: Blank lines within the ".layout" file will be ignored, as will any text
|
||||
following a "#" (pound/hash) character — it can be used to denote comments, as
|
||||
seen in the example below.
|
||||
|
||||
La ligne "keyboardlist" décrit les dispositions vers lesquelles on bascule
|
||||
lorsque l'utilisateur clique sur les boutons gauche et droit du clavier. (Voir
|
||||
|
|
@ -1057,6 +1056,9 @@ afficher sur la touche, selon les touches de modification qui ont été enfoncé
|
|||
(utilisez "1") ou [AltGr] (alt graphiques alternatifs) (utilisez "2"), ou pas
|
||||
du tout (utilisez "0").
|
||||
|
||||
The "NEWLINE" keyword is used to indicate the end of one row of the keyboard,
|
||||
and thus subsequent key layout descriptions will be beginning on a new row.
|
||||
|
||||
WIDTH 15
|
||||
HEIGHT 5
|
||||
|
||||
|
|
@ -1092,10 +1094,14 @@ du tout (utilisez "0").
|
|||
KEY 64 2.0 Alt Alt Alt Alt 0
|
||||
|
||||
# Espace
|
||||
KEY 65 7.0 SPACE SPACE SPACE SPACE 0
|
||||
KEY 65 5.0 SPACE SPACE SPACE SPACE 0
|
||||
|
||||
# AltGr
|
||||
KEY 108 2.0 AltGr AltGr AltGr AltGr 0
|
||||
|
||||
# Paste
|
||||
KEY 143 2.0 Paste Paste Paste Paste 0
|
||||
|
||||
# Flèche droite pour aller au clavier suivant
|
||||
KEY 1 1.0 -> -> -> -> 0
|
||||
|
||||
|
|
@ -1112,6 +1118,11 @@ utilisés sont décrits ci-dessous.
|
|||
* 2 — disposition précédente (pour le réglage "keyboardlist" du fichier
|
||||
d'agencement)
|
||||
|
||||
📜 Starting with Tux Paint 0.9.35, the XF86Paste keysym (value 143) can be used
|
||||
to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in
|
||||
the keyboard layout files. (Pasting via a physical keyboard is initiated using
|
||||
the [Control] + [V] key combination.
|
||||
|
||||
### Fichier keymap ("us-intl-altgr-dead-keys.keymap") ###
|
||||
|
||||
Ce fichier définit quels codes de touches numériques (vus dans les fichiers de
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@
|
|||
Copyright © 2002-2024 by divers contributeurs; voir AUTHORS.txt.
|
||||
https://tuxpaint.org/
|
||||
|
||||
octobre 25, 2024
|
||||
décembre 25, 2024
|
||||
|
||||
+-------------------------------------------------------+
|
||||
| Table des matières |
|
||||
|
|
@ -108,6 +108,9 @@ Voir COPYING.txt pour le texte complet de la licence GPL.
|
|||
Better behavior when clicking/tapping and dragging hue/saturation box and
|
||||
value slider.
|
||||
|
||||
→ Text clipboard paste support ←
|
||||
The "Text" and "Label" tools support pasting the copy/paste clipboard.
|
||||
|
||||
|
||||
Voir CHANGES.txt pour la liste complète des changements.
|
||||
|
||||
|
|
@ -519,6 +522,13 @@ e.Outils "Texte" et "Étiquette" ←
|
|||
ligne et vers la gauche. (Cela peut être utile pour créer une ligne de
|
||||
texte avec des couleurs, des polices, des styles et des tailles variés.)
|
||||
|
||||
Text from the clipboard (copy/paste buffer) can be inserted with the "Text"
|
||||
and "Label" tools by pressing the [Control] + [V] key combination on a
|
||||
physical keyboard, or clicking the "Paste" button in Tux Paint's on-screen
|
||||
keyboard. The text will wrap to the next line if it hits the right edge of
|
||||
the canvas. If the text hits the bottom of the canvas, the pasting will
|
||||
abort, truncating the text.
|
||||
|
||||
Cliquer ailleurs dans l'image alors que l'entrée de texte est toujours
|
||||
active entraîne le déplacement de la ligne de texte actuelle vers cet
|
||||
emplacement (et vous pouvez continuer à la modifier).
|
||||
|
|
@ -559,6 +569,9 @@ e.Outils "Texte" et "Étiquette" ←
|
|||
"Désactiver l'outil 'Label'" dans Tux Paint Config ou bien en exécutant
|
||||
Tux Paint en ligne de commande avec l'option "nolabel").
|
||||
|
||||
📜 The ability to paste text from the clipboard was added in Tux Paint
|
||||
0.9.35
|
||||
|
||||
|
||||
|
||||
→ Saisie de caractères internationaux ←
|
||||
|
|
@ -591,9 +604,39 @@ e.Outils "Texte" et "Étiquette" ←
|
|||
|
||||
→ Clavier virtuel sur écran ←
|
||||
|
||||
Un clavier virtuel sur écran (optionnel) est disponible pour les outils
|
||||
"Texte" et "Étiquette", qui peut présenter une palette de dispositions
|
||||
et de création de caractères (par ex "a" et "e" pour "æ").
|
||||
An optional on-screen keyboard is available for the Text and Label
|
||||
tools, which can provide a variety of layouts and character composition
|
||||
(e.g., composing "a" and "e" into "æ"). Run Tux Paint with the
|
||||
"--onscreen-keyboard" option, or enable that setting in Tux Paint's
|
||||
configuration file, to enable it. Multiple layouts are offered
|
||||
(currently "QWERTY" and "ABC"), which the user can switch between.
|
||||
Additional configuration options allow specifying a default layout, as
|
||||
well as preventing the layout from being changed.
|
||||
|
||||
The on-screen keyboard appears at the bottom or top of the Tux Paint
|
||||
window, obscuring part of the canvas, depending on where the text
|
||||
insertion cursor is placed. Along with alphabetic, numeric, and some
|
||||
punctuation keys, the keyboard provides:
|
||||
@ A "Backspace" key (⇐) to remove the previous character
|
||||
@ A "Carriage Return" ("Return"/"Enter") key (⏎) to end the current
|
||||
input and begin a new one on the following line (below and to the
|
||||
left)
|
||||
@ A "Tab" key (⇔) to end the current input and begin a new one at the
|
||||
current cursor position
|
||||
@ A "Shift" key (⇑) to shift alphabetic keys from lowercase to
|
||||
uppercase, access more punctuation, etc.
|
||||
@ A "Caps Lock" key (⤒) to toggle permanent shifting of alphabetic
|
||||
keys from lowercase to uppercase (click it again to disable caps
|
||||
lock)
|
||||
@ A "Compose" key ("Cmp"), to initiate character composition (e.g.,
|
||||
click "Cmp", "a", "e" to produce an "æ" character)
|
||||
@ An "Alternate Graphics" key ("AltGr") to access additional
|
||||
characters (e.g., "¿", "ß", etc.)
|
||||
@ An "Alternate" key ("Alt")
|
||||
@ A "Paste" key to paste the current clipboard's text into the Text
|
||||
or Label tool
|
||||
@ Left and right arrows (← & →) to access different on-screen
|
||||
keyboard layouts
|
||||
|
||||
⚙ Voir les documents "Options" et "Extension de Tux Paint" pour plus
|
||||
d'informations.
|
||||
|
|
|
|||
|
|
@ -100,7 +100,7 @@
|
|||
</p>
|
||||
|
||||
<p>
|
||||
octobre 10, 2024 </p>
|
||||
décembre 25, 2024 </p>
|
||||
</center>
|
||||
</header>
|
||||
|
||||
|
|
@ -1118,7 +1118,7 @@
|
|||
</header>
|
||||
|
||||
<p>
|
||||
Depuis la version 0.9.22, les outils «Texte» et «Étiquette» de Tux Paint peuvent présenter un clavier à l'écran qui permet d'utiliser le pointeur (via une souris, des systèmes de suivi oculaire, etc.) pour saisir des caractères. Les fichiers qui décrivent la mise en page et les clés disponibles sont stockés dans le répertoire "<code>osk</code>" de Tux Paint . Chaque disposition de clavier est définie par un certain nombre de fichiers (dont certains peuvent être partagés par différentes dispositions). </p>
|
||||
As of version 0.9.22, Tux Paint's 'Text' and 'Label' tools can present an on-screen keyboard that allows the pointer (via a mouse, touch screen, eye-tracking systems, etc.) to be used to input characters. Files that describe the layout and available keys are stored in Tux Paint "<code>osk</code>" directory. Each keyboard layout is defined by a number of files (some of which may be shared by different layouts). </p>
|
||||
<p>
|
||||
Nous utiliserons le clavier QWERTY comme exemple : </p>
|
||||
|
||||
|
|
@ -1142,7 +1142,7 @@
|
|||
</blockquote>
|
||||
|
||||
<p class="note">
|
||||
<span title="Configuration option">⚙</span> <strong>Remarque</strong>Les lignes vides du fichier "<code>.layout</code>" sont ignorées, aussi bien que les lignes commençant par le caractère "<code>#</code>" ( livre/dièse)-- on peut l'utiliser pour ajouter des commentaires, comme dans l'exemple ci-dessus. </p>
|
||||
<span title="Configuration option">⚙</span> <strong>Note:</strong> Blank lines within the "<code>.layout</code>" file will be ignored, as will any text following a "<code>#</code>" (pound/hash) character — it can be used to denote comments, as seen in the example below. </p>
|
||||
|
||||
<p>
|
||||
La ligne "<code>keyboardlist</code>" décrit les dispositions vers lesquelles on bascule lorsque l'utilisateur clique sur les boutons gauche et droit du clavier. (Voir ci-dessous.) </p>
|
||||
|
|
@ -1157,6 +1157,9 @@
|
|||
<p>
|
||||
Ceci décrit la taille du clavier (sous forme de grille L × H), et répertorie chaque touche avec son code numérique (voir le fichier "<code>keymap</code>", ci-dessous), la largeur à laquelle il doit être dessiné (généralement "<code>1.0</code>", pour en prendre un espace sur le clavier, mais dans l'exemple ci-dessous, notez que les touches "<code>TAB</code>" et "<code>SPACE</code>" sont beaucoup plus larges), le caractère ou le texte à afficher sur la touche, selon les touches de modification qui ont été enfoncées (une pour chacune : pas de modificateurs, <b><code>[Shift]</code></b> , <b><code>[AltGr]</code></b> et <b><code>[Shift]</code></b> + <b><code>[AltGr]</code></b> ), et enfin si la touche est affectée ou non par la touche <b><code>[CapsLock]</code></b> (utilisez "<code>1</code>") ou <b><code>[AltGr]</code></b> (alt graphiques alternatifs) (utilisez "<code>2</code>"), ou pas du tout (utilisez "<code>0</code>"). </p>
|
||||
|
||||
<p>
|
||||
The "<code>NEWLINE</code>" keyword is used to indicate the end of one row of the keyboard, and thus subsequent key layout descriptions will be beginning on a new row. </p>
|
||||
|
||||
<blockquote>
|
||||
<p>
|
||||
<code>WIDTH 15<br>
|
||||
|
|
@ -1193,10 +1196,14 @@
|
|||
KEY 64 2.0 Alt Alt Alt Alt 0<br>
|
||||
<br>
|
||||
# Espace<br>
|
||||
KEY 65 7.0 SPACE SPACE SPACE SPACE 0<br>
|
||||
KEY 65 5.0 SPACE SPACE SPACE SPACE 0<br>
|
||||
<br>
|
||||
# AltGr<br>
|
||||
KEY 108 2.0 AltGr AltGr AltGr AltGr 0<br>
|
||||
<br>
|
||||
# Paste<br>
|
||||
KEY 143 2.0 Paste Paste Paste Paste 0<br>
|
||||
<br>
|
||||
# Flèche droite pour aller au clavier suivant<br>
|
||||
KEY 1 1.0 -> -> -> -> 0</code>
|
||||
</p>
|
||||
|
|
@ -1221,6 +1228,10 @@
|
|||
<code>2</code> —
|
||||
disposition précédente (pour le réglage "<code>keyboardlist</code>" du fichier d'agencement) </li>
|
||||
</ul>
|
||||
|
||||
<p class="note">
|
||||
<span title="Version variation">📜</span> Starting with Tux Paint 0.9.35, the <code>XF86Paste</code> keysym (value 143) can be used to initiate a copy/paste clipboard buffer "paste" event. See the "Paste" key in the keyboard layout files. (Pasting via a physical keyboard is initiated using the <code>[Control]</code> + <code>[V]</code> key combination. </p>
|
||||
|
||||
</section><!-- H2: Keyboard layout file ("qwerty.h_layout") -->
|
||||
|
||||
<section><!-- H2: Keymap file ("us-intl-altgr-dead-keys.keymap") -->
|
||||
|
|
|
|||
|
|
@ -102,7 +102,7 @@
|
|||
</p>
|
||||
|
||||
<p>
|
||||
octobre 25, 2024 </p>
|
||||
décembre 25, 2024 </p>
|
||||
</center>
|
||||
</header>
|
||||
<table border="2"
|
||||
|
|
@ -230,6 +230,9 @@
|
|||
<dl>
|
||||
<dt>Improved color picker</dt>
|
||||
<dd>Better behavior when clicking/tapping and dragging hue/saturation box and value slider.</dd>
|
||||
|
||||
<dt>Text clipboard paste support</dt>
|
||||
<dd>The "Text" and "Label" tools support pasting the copy/paste clipboard.</dd>
|
||||
</dl>
|
||||
|
||||
<p>
|
||||
|
|
@ -819,6 +822,9 @@
|
|||
<p>
|
||||
Sinon, appuyez sur <strong><code>[Tab]</code></strong> et le texte sera inclus dans l'image, mais le curseur se déplacera vers la droite du texte, plutôt que vers le bas d'une ligne et vers la gauche. (Cela peut être utile pour créer une ligne de texte avec des couleurs, des polices, des styles et des tailles variés.) </p>
|
||||
|
||||
<p>
|
||||
Text from the clipboard (copy/paste buffer) can be inserted with the "Text" and "Label" tools by pressing the <strong><code>[Control]</code> + <code>[V]</code></strong> key combination on a physical keyboard, or clicking the "<strong>Paste</strong>" button in Tux Paint's on-screen keyboard. The text will wrap to the next line if it hits the right edge of the canvas. If the text hits the bottom of the canvas, the pasting will abort, truncating the text. </p>
|
||||
|
||||
<p>
|
||||
Cliquer ailleurs dans l'image alors que l'entrée de texte est toujours active entraîne le déplacement de la ligne de texte actuelle vers cet emplacement (et vous pouvez continuer à la modifier). </p>
|
||||
|
||||
|
|
@ -849,6 +855,9 @@
|
|||
|
||||
<p class="note">
|
||||
<span title="Configuration option">⚙</span> L' outil <strong>Étiquette</strong> peut être désactivé (par exemple, en sélectionnant "Désactiver l'outil 'Label'" dans Tux Paint Config ou bien en exécutant Tux Paint en ligne de commande avec l'option "<code>nolabel</code>"). </p>
|
||||
|
||||
<p class="note">
|
||||
<span title="Version variation">📜</span> The ability to paste text from the clipboard was added in Tux Paint 0.9.35 </p>
|
||||
</dd>
|
||||
|
||||
<dt>
|
||||
|
|
@ -886,7 +895,23 @@
|
|||
|
||||
<dd>
|
||||
<p>
|
||||
Un clavier virtuel sur écran (optionnel) est disponible pour les outils "Texte" et "Étiquette", qui peut présenter une palette de dispositions et de création de caractères (par ex "a" et "e" pour "æ"). </p>
|
||||
An optional on-screen keyboard is available for the Text and Label tools, which can provide a variety of layouts and character composition (e.g., composing "a" and "e" into "æ"). Run Tux Paint with the "<code>--onscreen-keyboard</code>" option, or enable that setting in Tux Paint's configuration file, to enable it. Multiple layouts are offered (currently "QWERTY" and "ABC"), which the user can switch between. Additional configuration options allow specifying a default layout, as well as preventing the layout from being changed. </p>
|
||||
|
||||
<p>
|
||||
The on-screen keyboard appears at the bottom or top of the Tux Paint window, obscuring part of the canvas, depending on where the text insertion cursor is placed. Along with alphabetic, numeric, and some punctuation keys, the keyboard provides: <ul>
|
||||
<li>A "Backspace" key (⇐) to remove the previous character</li>
|
||||
<li>A "Carriage Return" ("Return"/"Enter") key (⏎) to end the current input and begin a new one on the following line (below and to the left)</li>
|
||||
<li>A "Tab" key (⇔) to end the current input and begin a new one at the current cursor position</li>
|
||||
<li>A "Shift" key (⇑) to shift alphabetic keys from lowercase to uppercase, access more punctuation, etc.</li>
|
||||
<li>A "Caps Lock" key (⤒) to toggle permanent shifting of alphabetic keys from lowercase to uppercase (click it again to disable caps lock)</li>
|
||||
<li>A "Compose" key ("Cmp"), to initiate character composition (e.g., click "Cmp", "a", "e" to produce an "æ" character)</li>
|
||||
<li>An "Alternate Graphics" key ("AltGr") to access additional characters (e.g., "¿", "ß", etc.)</li>
|
||||
<li>An "Alternate" key ("Alt")</li>
|
||||
<li>A "Paste" key to paste the current clipboard's text into the Text or Label tool</li>
|
||||
<li>Left and right arrows (← & →) to access different on-screen keyboard layouts</li>
|
||||
</ul>
|
||||
</p>
|
||||
|
||||
<p class="note">
|
||||
<span title="Configuration option">⚙</span> Voir les documents "<a href="OPTIONS.html"><em>Options</em></a>" et "<a href="EXTENDING.html"><em>Extension de Tux Paint</em></a>" pour plus d'informations. </p>
|
||||
</dd>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue