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 varios colaboradores; see AUTHORS.txt.
|
||||
https://tuxpaint.org/
|
||||
|
||||
10 de Outubro de 2024
|
||||
25 de Decembro de 2024
|
||||
|
||||
+-------------------------------------------------------------+
|
||||
| Índice |
|
||||
|
|
@ -981,13 +981,12 @@ de execución.
|
|||
|
||||
Teclado en pantalla
|
||||
|
||||
A partir da versión 0.9.22, as ferramentas «Texto» e «Etiqueta» de Tux Paint
|
||||
poden presentar un teclado en pantalla que permite utilizar o punteiro
|
||||
(mediante un rato, sistemas de seguimento de ollos, etc.) para introducir
|
||||
caracteres. Os ficheiros que describen o deseño e as claves dispoñíbeis
|
||||
almacénanse no directorio «osk» de Tux Paint. Cada deseño de teclado está
|
||||
definido por varios ficheiros (algúns dos cales poden ser compartidos por
|
||||
diferentes deseños).
|
||||
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).
|
||||
|
||||
Usaremos o teclado QWERTY como exemplo:
|
||||
|
||||
|
|
@ -1004,7 +1003,7 @@ describir a disposición e as asignacións de teclas.
|
|||
|
||||
⚙ 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 above.
|
||||
seen in the example below.
|
||||
|
||||
A liña «keyboardlist» describe a que esquemas cambiar, cando o usuario preme
|
||||
nos botóns esquerdo e dereito do teclado. (Ver máis abaixo.)
|
||||
|
|
@ -1021,6 +1020,9 @@ modificadores,[Maiúsculas],[AltGr] e [Maiúsculas] + [AltGr]) e, finalmente, se
|
|||
a tecla está afectada ou non pola tecla [BloqMaiús] (use «1») ou a tecla
|
||||
[AltGr] (gráficos alternativos) ( use «2»), ou non (use «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
|
||||
|
||||
|
|
@ -1056,10 +1058,14 @@ a tecla está afectada ou non pola tecla [BloqMaiús] (use «1») ou a tecla
|
|||
KEY 64 2.0 Alt Alt Alt Alt 0
|
||||
|
||||
# Espazo
|
||||
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
|
||||
|
||||
# A frecha cara á dereita cambiará ao seguinte teclado
|
||||
KEY 1 1.0 -> -> -> -> 0
|
||||
|
||||
|
|
@ -1076,6 +1082,11 @@ actualmente descríbense a continuación.
|
|||
* 2 — disposición anterior (segundo o axuste «keyboardlist» do ficheiro de
|
||||
disposición)
|
||||
|
||||
📜 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.
|
||||
|
||||
### Ficheiro do mapa do teclado («us-intl-altgr-dead-keys.keymap») ###
|
||||
|
||||
Este ficheiro define que códigos das teclas numéricas (vistos nos ficheiros de
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@
|
|||
Copyright © 2002-2024 by varios colaboradores; see AUTHORS.txt.
|
||||
https://tuxpaint.org/
|
||||
|
||||
25 de Outubro de 2024
|
||||
25 de Decembro de 2024
|
||||
|
||||
+--------------------------------------------------------+
|
||||
| Índice |
|
||||
|
|
@ -104,6 +104,9 @@ Consulte o texto completo da licenza GPL en COPYING.txt.
|
|||
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.
|
||||
|
||||
|
||||
See CHANGES.txt for the complete list of changes.
|
||||
|
||||
|
|
@ -497,6 +500,13 @@ e.Ferramentas «Texto» e «Etiquetas» ←
|
|||
esquerda. (Isto pode ser útil para crear unha liña de texto con cores,
|
||||
tipos de letra, estilos e tamaños mesturados.)
|
||||
|
||||
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.
|
||||
|
||||
Ao premer noutro lugar da imaxe mentres a entrada de texto aínda está
|
||||
activa, a liña de texto actual moverase a esa posición (onde pode continuar
|
||||
editándoa).
|
||||
|
|
@ -535,6 +545,9 @@ e.Ferramentas «Texto» e «Etiquetas» ←
|
|||
«Desactivar a ferramenta "Etiqueta"» en Tux Paint Config. ou executando
|
||||
Tux Paint coa opción «nolabel»).
|
||||
|
||||
📜 The ability to paste text from the clipboard was added in Tux Paint
|
||||
0.9.35
|
||||
|
||||
|
||||
|
||||
→ Introdución de caracteres internacionais ←
|
||||
|
|
@ -571,7 +584,37 @@ e.Ferramentas «Texto» e «Etiquetas» ←
|
|||
|
||||
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 "æ").
|
||||
(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
|
||||
|
||||
⚙ See the "Options" and "Extending Tux Paint" documentation for more
|
||||
information.
|
||||
|
|
|
|||
|
|
@ -100,7 +100,7 @@
|
|||
</p>
|
||||
|
||||
<p>
|
||||
10 de Outubro de 2024 </p>
|
||||
25 de Decembro de 2024 </p>
|
||||
</center>
|
||||
</header>
|
||||
|
||||
|
|
@ -1118,7 +1118,7 @@
|
|||
</header>
|
||||
|
||||
<p>
|
||||
A partir da versión 0.9.22, as ferramentas «Texto» e «Etiqueta» de Tux Paint poden presentar un teclado en pantalla que permite utilizar o punteiro (mediante un rato, sistemas de seguimento de ollos, etc.) para introducir caracteres. Os ficheiros que describen o deseño e as claves dispoñíbeis almacénanse no directorio «<code>osk</code>» de Tux Paint. Cada deseño de teclado está definido por varios ficheiros (algúns dos cales poden ser compartidos por diferentes deseños). </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>
|
||||
Usaremos o teclado QWERTY como exemplo: </p>
|
||||
|
||||
|
|
@ -1142,7 +1142,7 @@
|
|||
</blockquote>
|
||||
|
||||
<p class="note">
|
||||
<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 above. </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>
|
||||
A liña «<code>keyboardlist</code>» describe a que esquemas cambiar, cando o usuario preme nos botóns esquerdo e dereito do teclado. (Ver máis abaixo.) </p>
|
||||
|
|
@ -1157,6 +1157,9 @@
|
|||
<p>
|
||||
Isto describe o tamaño do teclado (como unha reixa de «largo × alto») e lista cada tecla co seu código numérico (ver o ficheiro «<code>keymap</code>», máis abaixo), o largo no que debería debuxarse (normalmente «<code>1.0</code>», para ocupar un espazo no teclado, pero no seguinte exemplo, teña en conta que as teclas «<code>TAB</code>» e «<code>SPACE</code>» son moito máis largas), o carácter ou o texto que se amosará na tecla, dependendo das teclas modificadoras premido (unha para cada unha: sen modificadores,<b><code>[Maiúsculas]</code></b>,<b><code>[AltGr]</code></b> e <b><code>[Maiúsculas]</code></b> + <b><code>[AltGr]</code></b>) e, finalmente, se a tecla está afectada ou non pola tecla <b><code>[BloqMaiús]</code></b> (use «<code>1</code>») ou a tecla <b><code>[AltGr]</code></b> (gráficos alternativos) ( use «<code>2</code>»), ou non (use «<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>
|
||||
# Espazo<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>
|
||||
# A frecha cara á dereita cambiará ao seguinte teclado<br>
|
||||
KEY 1 1.0 -> -> -> -> 0</code>
|
||||
</p>
|
||||
|
|
@ -1221,6 +1228,10 @@
|
|||
<code>2</code> —
|
||||
disposición anterior (segundo o axuste «<code>keyboardlist</code>» do ficheiro de disposición) </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>
|
||||
25 de Outubro de 2024 </p>
|
||||
25 de Decembro de 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>
|
||||
Como alternativa, prema <strong><code>[Tab]</code></strong> e o texto será debuxado na imaxe, mais o cursor moverase á dereita do texto, no canto de baixar unha liña e á esquerda. (Isto pode ser útil para crear unha liña de texto con cores, tipos de letra, estilos e tamaños mesturados.) </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>
|
||||
Ao premer noutro lugar da imaxe mentres a entrada de texto aínda está activa, a liña de texto actual moverase a esa posición (onde pode continuar editándoa). </p>
|
||||
|
||||
|
|
@ -849,6 +855,9 @@
|
|||
|
||||
<p class="note">
|
||||
<span title="Configuration option">⚙</span> A ferramenta <strong>Etiqueta</strong> pódese desactivar (p. ex.: seleccionando «Desactivar a ferramenta "Etiqueta"» en <em>Tux Paint Config.</em> ou executando <em>Tux Paint</em> coa opción «<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>
|
||||
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 "æ"). </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> See the "<a href="OPTIONS.html"><em>Options</em></a>" and "<a href="EXTENDING.html"><em>Extending Tux Paint</em></a>" documentation for more information. </p>
|
||||
</dd>
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue