From a81bedaa87ae18ec5748fb59808cf19ef2657160 Mon Sep 17 00:00:00 2001 From: Juergen Spitzmueller Date: Tue, 23 Jul 2019 07:36:53 +0200 Subject: [PATCH] Correct visual/logic cursor description --- lib/doc/UserGuide.lyx | 98 +++++++++++++++++++++------ lib/doc/de/UserGuide.lyx | 80 ++++++++++++++++++---- src/frontends/qt/ui/PrefLanguageUi.ui | 4 +- 3 files changed, 143 insertions(+), 39 deletions(-) diff --git a/lib/doc/UserGuide.lyx b/lib/doc/UserGuide.lyx index 097bbfa300..c18fb9ed9d 100644 --- a/lib/doc/UserGuide.lyx +++ b/lib/doc/UserGuide.lyx @@ -8483,12 +8483,14 @@ Verbatim \end_layout \begin_layout Verbatim + This is Verbatim. \end_layout \begin_layout Verbatim \noindent \align block + The following 2 lines are empty: \end_layout @@ -8501,6 +8503,7 @@ The following 2 lines are empty: \end_layout \begin_layout Verbatim + Almost everything is allowed in Verbatim:"%&$§#~'` \backslash }][{| @@ -8524,6 +8527,7 @@ Verbatim \end_layout \begin_layout Verbatim* + This is Verbatim*. \end_layout @@ -29894,7 +29898,10 @@ Appendix \begin_inset CommandInset ref LatexCommand ref -reference "chap:Credits" +reference "chap:Units-available-in" +plural "false" +caps "false" +noprefix "false" \end_inset @@ -49938,14 +49945,20 @@ Command \begin_inset space ~ \end_inset -end Counterpart to +end +\change_deleted -712698321 1563857836 +Counterpart to \family sans Command start \family default . -\change_inserted -712698321 1563708846 -Use this if the language switch needs to be explicitly ended, as in +\change_inserted -712698321 1563857869 +Use this if the language switch set in +\family sans +Command start +\family default + needs to be explicitly ended, as in \series bold babel \series default @@ -49954,6 +49967,7 @@ babel \backslash begin{otherlanguage*}\SpecialChar ldots +\SpecialChar allowbreak \backslash end{otherlanguage*} @@ -49963,14 +49977,15 @@ end{otherlanguage*} \change_deleted -712698321 1563708866 Some packages, like the default, don't have an end command since the start command toggles the package on and off -\change_inserted -712698321 1563711115 +\change_inserted -712698321 1563858041 Empty by default, as \family typewriter \backslash selectlanguage{$$lang} \family default - does not need to be explicitly ended (it is valid until the next + does not need to be explicitly ended (the switch remains valid until the + next \family typewriter \backslash @@ -49980,7 +49995,7 @@ selectlanguage{$$lang} \change_unchanged . -\change_inserted -712698321 1563708925 +\change_inserted -712698321 1563857868 Note that with \series bold polyglossia @@ -50350,26 +50365,50 @@ RTL \change_inserted -712698321 1563710286 scripts with right-to-left direction (e.g., Arabic, Hebrew or Farsi). -\change_deleted -712698321 1563710294 +\change_deleted -712698321 1563857456 , you can define if the left and right arrow keys move the cursor visually to the left or right, respectively, or logically. -\change_unchanged +\change_inserted -712698321 1563859701 + +\end_layout + +\begin_deeper +\begin_layout Standard \family sans Logical \family default - means that the cursor is moved to the left -\change_deleted -712698321 1563710342 -when -\change_inserted -712698321 1563710342 -if -\change_unchanged - pressing the right arrow key -\change_inserted -712698321 1563712351 -(so right arrow key means: move forward), and to the right if pressing the - left arrow key (which then means: move backward). - This setting might be useful in texts that mix left-to-right and right-to-left + means that the cursor +\change_inserted -712698321 1563859940 +follows the logic of the text direction, and the arrows' direction relates + to the directionality of the main paragraph language. + E. +\begin_inset space \thinspace{} +\end_inset + +g., in embedded right-to-left text in a left-to-right paragraph (say, Hebrew + embedded in English), the cursor starts at the right (that is, at the +\emph on +beginning +\emph default + of the embedded passage in the right-to-left logic) when coming from the + left. + The meaning of the key is thus swapped for that part; right arrow in this + specific case always means: move +\emph on +forward +\emph default + in text (even if this means: +\emph on +move left +\emph default +). + +\change_deleted -712698321 1563857456 +is moved to the left when pressing the right arrow key +\change_inserted -712698321 1563859705 +This setting might be useful in texts that mix left-to-right and right-to-left scripts, since the cursor then follows a coherent \begin_inset Quotes eld \end_inset @@ -50380,16 +50419,31 @@ text logic . +\end_layout + +\begin_layout Standard + +\change_inserted -712698321 1563860084 + \family sans Visual \family default means: always move to the direction towards which the arrows really point. -\change_deleted -712698321 1563710407 + In this case, in embedded right-to-left text in a left-to-right paragraph, + the cursor starts at the left (in the text logic: +\emph on +from the end +\emph default +) when coming from the left. + The visual meaning of the key is thus maintained in all cases, at the expense + of the text logic. +\change_deleted -712698321 1563857456 and the cursor is inside text in an RTL language. -\change_inserted -712698321 1563710219 +\change_inserted -712698321 1563858627 \end_layout +\end_deeper \begin_layout Subsubsection \change_inserted -712698321 1563710235 diff --git a/lib/doc/de/UserGuide.lyx b/lib/doc/de/UserGuide.lyx index 6850370440..5a35933f5f 100644 --- a/lib/doc/de/UserGuide.lyx +++ b/lib/doc/de/UserGuide.lyx @@ -8636,10 +8636,12 @@ Unformatiert \end_layout \begin_layout Verbatim + Dies ist Unformatiert. \end_layout \begin_layout Verbatim + Die folgenden 2 Zeilen sind leer: \end_layout @@ -8652,6 +8654,7 @@ Die folgenden 2 Zeilen sind leer: \end_layout \begin_layout Verbatim + Fast alles ist in Unformatiert erlaubt:"%&$§#~'` \backslash }][{| @@ -8675,6 +8678,7 @@ Unformatiert \end_layout \begin_layout Verbatim* + Dies ist Unformatiert*. \end_layout @@ -46967,7 +46971,7 @@ Befehl \begin_inset space ~ \end_inset -Ende ist das Gegenstück zu +Ende Verwenden Sie dies, wenn eine Sprachumschaltung, die Sie mit \family sans Befehl \begin_inset space ~ @@ -46975,19 +46979,19 @@ Befehl Anfang \family default -. - Verwenden Sie dies, wenn eine Sprachumschaltung explizit beendet werden - muss, wie das beispielsweise im alternativen Babel-Befehl + vorgenommen haben, explizit beendet werden muss, so wie das beispielsweise + im Fall des alternativen Babel-Befehls \family typewriter \backslash begin{otherlanguage*}\SpecialChar ldots +\SpecialChar allowbreak \backslash end{otherlanguage*} \family default - der Fall ist. - Standardmäßig ist dieses Feld leer, da + nötig ist. + In der Voreinstellung ist dieses Feld leer, da \family typewriter \backslash @@ -47138,24 +47142,70 @@ Rechts-nach-links-Cursor-Navigation legt fest, wie sich der Cursor beim Hebräisch, Arabisch oder Farsi) verhält, wenn sie die Pfeil-rechts- oder Pfeil-links-Taste drücken. +\end_layout + +\begin_deeper +\begin_layout Standard + \family sans Logisch \family default - bedeutet, dass der Cursor nach links bewegt wird, wenn Sie die Pfeil-rechts-Tas -te drücken (diese bedeutet dann also immer: bewege den Cursor vorwärts), - und nach rechts, wenn Sie die Pfeil-links-Taste drücken (die dann immer - bedeutet: bewege den Cursor rückwärts). - Diese Einstellung ist vor allem in sinnvoll, die rechts- und linksläufige - Schriften mischen, da die Cursorbewegung dann einer einheitlichen Textlogik - folgt. + bedeutet, dass der Cursor der Logik der Textrichtung folgt; die Pfeiltasten + richten sich dabei nach der Textrichtung der Hauptsprache des Absatzes. + Beispielsweise startet der Cursor in hebräischen Textpassagen, die in einen + deutschsprachigen Absatz eingebettet sind, wenn Sie von links her kommen, + rechts (also am Anfang der hebräischen Passage nach der linksläufigen Textlogik +). + Somit wird die Bedeutung der Pfeiltaste temporär vertauscht: +\emph on +rechts +\emph default + heißt nicht +\begin_inset Quotes gls +\end_inset + +rechts +\begin_inset Quotes grs +\end_inset + +, sondern (in diesem speziellen Fall) +\begin_inset Quotes gls +\end_inset + +vorwärts +\begin_inset Quotes grs +\end_inset + +. + Diese Einstellung ist vor allem in Dokumenten sinnvoll, die rechts- und + linksläufige Schriften mischen, da die Cursorbewegung dann einer einheitlichen + Textlogik folgt. +\end_layout + +\begin_layout Standard + \family sans Visuell \family default - bedeutet, dass sich der Cursor in die Richtung bewegt, in die auch die - Pfeile zeigen + bedeutet, dass sich der Cursor immer in die Richtung bewegt, in die auch + die Pfeile zeigen. + In diesem Fall würde bei einer eingebettetem hebräischen Passage in einem + deutschsprachigen Absatz der Cursor links (in der linksläufigen Logik: + von +\begin_inset Quotes gls +\end_inset + +hinten +\begin_inset Quotes grs +\end_inset + +) anfangen, wenn Sie von links kommen. + Somit wird die visuelle Bedeutung der Tasten stets eingehalten, zu Lasten + der Textlogik. \end_layout +\end_deeper \begin_layout Subsubsection Lokale Einstellungen \end_layout diff --git a/src/frontends/qt/ui/PrefLanguageUi.ui b/src/frontends/qt/ui/PrefLanguageUi.ui index 0255531076..e18695e18e 100644 --- a/src/frontends/qt/ui/PrefLanguageUi.ui +++ b/src/frontends/qt/ui/PrefLanguageUi.ui @@ -236,7 +236,7 @@ - Right arrow key is interpreted as "move forwards", left arrow key as "move backwards" + The cursor follows the logic of the text direction (e.g., in embedded right-to-left text in a left-to-right paragraph, the cursor starts at the right when coming from the left) &Logical @@ -249,7 +249,7 @@ - Right arrow key is interpreted as "move right", left arrow key as "move left" + The cursor follows the visual direction (e.g., in embedded right-to-left text in a left-to-right paragraph, the cursor starts at the left when coming from the left) &Visual -- 2.39.5