From: Juergen Spitzmueller Date: Sun, 21 Jul 2019 12:37:41 +0000 (+0200) Subject: UserGuide: update prefs language documentation X-Git-Url: https://git.lyx.org/gitweb/?a=commitdiff_plain;h=072fc7a315e98130f8721820986cd92b39356099;p=features.git UserGuide: update prefs language documentation --- diff --git a/lib/doc/UserGuide.lyx b/lib/doc/UserGuide.lyx index fd9c622aef..e410fff055 100644 --- a/lib/doc/UserGuide.lyx +++ b/lib/doc/UserGuide.lyx @@ -1,5 +1,5 @@ #LyX 2.4 created this file. For more info see https://www.lyx.org/ -\lyxformat 580 +\lyxformat 583 \begin_document \begin_header \save_transient_properties true @@ -66,7 +66,9 @@ logicalmkup \font_default_family default \use_non_tex_fonts false \font_sc false -\font_osf false +\font_roman_osf false +\font_sans_osf false +\font_typewriter_osf false \font_sf_scale 100 100 \font_tt_scale 100 100 \use_microtype false @@ -49727,6 +49729,16 @@ literal "false" \end_inset +\change_inserted -712698321 1563708959 + +\end_layout + +\begin_layout Subsubsection + +\change_inserted -712698321 1563708986 +LaTeX Language Support +\change_unchanged + \end_layout \begin_layout Description @@ -49815,14 +49827,63 @@ Command \begin_inset space ~ \end_inset -start If a special \SpecialChar LaTeX +start +\change_deleted -712698321 1563708374 +If a special \SpecialChar LaTeX -package is needed to write in a certain document language, - you can here specify the command to start the package. - An example is the start command + you can h +\change_inserted -712698321 1563708374 +H +\change_unchanged +ere +\change_inserted -712698321 1563708377 + you +\change_unchanged + +\change_deleted -712698321 1563708382 +specify +\change_inserted -712698321 1563708384 +customize +\change_unchanged + the command +\change_inserted -712698321 1563708639 +that is used to switch to a different language +\change_deleted -712698321 1563708410 +to start the package +\change_unchanged +. + +\change_inserted -712698321 1563708611 +This might be useful if you want to use a different command with +\series bold +babel +\series default + (which provides several alternative commands with different behavior), + or if you use a custom language package with specific commands, such as + +\series bold +Arab\SpecialChar TeX + +\series default + +\begin_inset CommandInset citation +LatexCommand cite +key "Arabic" +literal "true" + +\end_inset + +, which needs +\change_deleted -712698321 1563708616 +An example is +\change_unchanged +the start command \family sans \backslash begin{arabtext} +\change_deleted -712698321 1563708621 + \family default that is needed to write Arabic using the package \series bold @@ -49837,18 +49898,39 @@ literal "true" \end_inset + +\change_unchanged . The default is the \series bold babel \series default command -\family sans +\family typewriter \backslash selectlanguage{$$lang} +\change_inserted -712698321 1563708571 + +\family default +, whereby +\family sans +$$lang \family default + is a placeholder that is substituted with the respective language name + in the \SpecialChar LaTeX + output +\change_unchanged . + +\change_inserted -712698321 1563708571 + Note that with +\series bold +polyglossia +\series default +, this setting is ignored. +\change_unchanged + \end_layout \begin_layout Description @@ -49861,11 +49943,56 @@ end Counterpart to Command start \family default . - Some packages, like the default, don't have an end command since the start - command toggles the package on and off. + +\change_inserted -712698321 1563708846 +Use this if the language switch needs to be explicitly ended, as in +\series bold +babel +\series default +'s alternative command +\family typewriter + +\backslash +begin{otherlanguage*}\SpecialChar ldots + +\backslash +end{otherlanguage*} +\family default +. + +\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 +Empty by default, as +\family typewriter + +\backslash +selectlanguage{$$lang} +\family default + does not need to be explicitly ended (it is valid until the next +\family typewriter + +\backslash +selectlanguage{$$lang} +\family default +) +\change_unchanged +. + +\change_inserted -712698321 1563708925 + Note that with +\series bold +polyglossia +\series default +, this setting is ignored. +\change_unchanged + \end_layout \begin_layout Description + +\change_deleted -712698321 1563708996 Default \begin_inset space ~ \end_inset @@ -49879,6 +50006,8 @@ separator Defines the default decimal point for use in tables (decimal point \end_layout \begin_layout Description + +\change_deleted -712698321 1563708996 Default \begin_inset space ~ \end_inset @@ -49889,6 +50018,8 @@ length unit Defines the unit that is used as default for lengths in \SpecialChar LyX 's dialogs. +\change_unchanged + \end_layout \begin_layout Description @@ -49900,24 +50031,99 @@ languages \begin_inset space ~ \end_inset -globally When this option is set, the languages used in the document will - be added as options to the document class options, so that they can be - used by all \SpecialChar LaTeX --packages. - Otherwise they will only be used as options for the +globally +\change_deleted -712698321 1563709051 +When +\change_inserted -712698321 1563709052 +If +\change_unchanged + this option is set, the languages used in the document will be added +\change_deleted -712698321 1563709127 +as options +\change_unchanged +to the document class options +\change_inserted -712698321 1563709259 + rather than the language package options. +\change_deleted -712698321 1563709186 +, +\change_unchanged + +\change_deleted -712698321 1563709191 +so that they can be used by all \SpecialChar LaTeX +-packages +\change_inserted -712698321 1563709305 +Since the document class passes all options in gets to all loaded \SpecialChar LaTeX +-packages, + all language-aware packages will be informed about the used languages this + way +\change_unchanged +. + +\change_deleted -712698321 1563709264 +Otherwise they will only be used as options for the \series bold babel \series default package. +\change_unchanged + \end_layout \begin_layout Description + +\change_deleted -712698321 1563709314 Auto \begin_inset space ~ \end_inset -begin When this option is set, documents start with the chosen document - language. +begin +\change_inserted -712698321 1563709328 +Set +\begin_inset space ~ +\end_inset + +document +\begin_inset space ~ +\end_inset + +language +\begin_inset space ~ +\end_inset + +explicitly +\change_unchanged + +\change_deleted -712698321 1563709331 +When +\change_inserted -712698321 1563709331 +If +\change_unchanged + this option is set, +\change_inserted -712698321 1563709808 +the language switch defined in +\family sans +Command +\begin_inset space ~ +\end_inset + +start +\family default + is output at the beginning of the document, thereby explicitly switching + to the document language. + This assures that the correct language is used in any case. + This might be needed if you use a non-default +\family sans +Command +\begin_inset space ~ +\end_inset + +start +\family default + or if a package resets the document language. + If not set, the language that is active at document start is used (this + usually should be the document language). +\change_deleted -712698321 1563709548 +documents start with the chosen document language. When this option is not set, the \family sans Command @@ -49937,23 +50143,55 @@ Command start \family default than the default. +\change_unchanged + \end_layout \begin_layout Description + +\change_deleted -712698321 1563709354 Auto \begin_inset space ~ \end_inset -end Counterpart to +end +\change_inserted -712698321 1563709358 +Unset +\begin_inset space ~ +\end_inset + +document +\begin_inset space ~ +\end_inset + +language +\begin_inset space ~ +\end_inset + +explicitly +\change_unchanged + Counterpart to +\change_deleted -712698321 1563709361 + \family sans Auto \begin_inset space ~ \end_inset begin +\change_inserted -712698321 1563709392 +Set document language explicitly +\change_unchanged + \family default . - When it is not set, the + +\change_deleted -712698321 1563709618 +When it is not +\change_inserted -712698321 1563709618 +If +\change_unchanged + set, the \family sans Command \begin_inset space ~ @@ -49961,7 +50199,30 @@ Command end \family default - is set to the end of the document. + is +\change_deleted -712698321 1563709625 +set +\change_inserted -712698321 1563709626 +output +\change_unchanged + +\change_inserted -712698321 1563709628 +at +\change_deleted -712698321 1563709628 +to +\change_unchanged + the end of the document. +\change_inserted -712698321 1563709816 + +\end_layout + +\begin_layout Subsubsection +\paragraph_spacing single + +\change_inserted -712698321 1563709833 +Editor Settings +\change_unchanged + \end_layout \begin_layout Description @@ -49969,15 +50230,81 @@ Mark \begin_inset space ~ \end_inset + +\change_inserted -712698321 1563709847 +additional +\change_deleted -712698321 1563709845 foreign +\change_unchanged + +\begin_inset space ~ +\end_inset + +languages +\change_inserted -712698321 1563709877 +If set, all +\change_deleted -712698321 1563709877 +T +\change_inserted -712698321 1563709878 +t +\change_unchanged +ext +\change_deleted -712698321 1563709882 +marked formatted +\change_unchanged +in a language different +\change_deleted -712698321 1563709886 +from +\change_inserted -712698321 1563709886 +to +\change_unchanged + the document language will be +\change_inserted -712698321 1563709907 +marked (by default with a blue +\change_unchanged +underline +\change_deleted -712698321 1563709911 +d in blue +\change_inserted -712698321 1563709911 +) +\change_unchanged +. +\change_inserted -712698321 1563709927 + +\end_layout + +\begin_layout Description + +\change_inserted -712698321 1563711969 +Respect \begin_inset space ~ \end_inset -languages Text marked formatted in a language different from the document - language will be underlined in blue. +OS +\begin_inset space ~ +\end_inset + +keyboard +\begin_inset space ~ +\end_inset + +language If set, \SpecialChar LyX + will switch the input language if the keyboard map is + switched via the operating system. + This is particularly useful if you switch between languages with different + scripts (e. +\begin_inset space \thinspace{} +\end_inset + +g., English and Hebrew: in this case, switching the keyboard to Hebrew will + automatically switch the input language to Hebrew as well, and vice versa). +\change_unchanged + \end_layout \begin_layout Description + +\change_deleted -712698321 1563709926 Enable \begin_inset space ~ \end_inset @@ -49988,17 +50315,117 @@ RTL support Enables the use of languages, written from right to left (RTL), like Arabic, Hebrew or Farsi. +\change_unchanged + \end_layout \begin_layout Description -Cursor + +\change_inserted -712698321 1563710132 +Right-to-left +\begin_inset space ~ +\end_inset + + +\change_deleted -712698321 1563710132 +C +\change_inserted -712698321 1563710132 +c +\change_unchanged +ursor \begin_inset space ~ \end_inset -movement When writing RTL, you can define if the left and right arrow keys - move the cursor visually to the left or right, respectively, or logically. - Logical means that the cursor is moved to the left when pressing the right - arrow key and the cursor is inside text in an RTL language. +movement +\change_inserted -712698321 1563710265 +Here you can define how cursor movement (with the arrow keys) behaves +\change_deleted -712698321 1563710266 +W +\change_inserted -712698321 1563710267 +w +\change_unchanged +hen writing +\change_deleted -712698321 1563710171 +RTL +\change_inserted -712698321 1563710286 +scripts with right-to-left direction (e.g., Arabic, Hebrew or Farsi). + +\change_deleted -712698321 1563710294 +, you can define if the left and right arrow keys move the cursor visually + to the left or right, respectively, or logically. + +\change_unchanged + +\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 + scripts, since the cursor then follows a coherent +\begin_inset Quotes eld +\end_inset + +text logic +\begin_inset Quotes erd +\end_inset + +. + +\family sans +Visual +\family default + means: always move to the direction towards which the arrows really point. +\change_deleted -712698321 1563710407 +and the cursor is inside text in an RTL language. +\change_inserted -712698321 1563710219 + +\end_layout + +\begin_layout Subsubsection + +\change_inserted -712698321 1563710235 +Local Preferences +\end_layout + +\begin_layout Description + +\change_inserted -712698321 1563709001 +Default +\begin_inset space ~ +\end_inset + +decimal +\begin_inset space ~ +\end_inset + +separator Defines the default decimal point for use in tables (decimal point + alignment). +\end_layout + +\begin_layout Description + +\change_inserted -712698321 1563709001 +Default +\begin_inset space ~ +\end_inset + +length +\begin_inset space ~ +\end_inset + +unit Defines the unit that is used as default for lengths in \SpecialChar LyX +'s dialogs. +\change_unchanged + \end_layout \begin_layout Subsection diff --git a/lib/doc/de/UserGuide.lyx b/lib/doc/de/UserGuide.lyx index 0c8ffd5fa9..3c100b9a3f 100644 --- a/lib/doc/de/UserGuide.lyx +++ b/lib/doc/de/UserGuide.lyx @@ -1,5 +1,5 @@ #LyX 2.4 created this file. For more info see https://www.lyx.org/ -\lyxformat 580 +\lyxformat 583 \begin_document \begin_header \save_transient_properties true @@ -73,7 +73,9 @@ logicalmkup \font_default_family default \use_non_tex_fonts false \font_sc false -\font_osf false +\font_roman_osf false +\font_sans_osf false +\font_typewriter_osf false \font_sf_scale 100 100 \font_tt_scale 100 100 \use_microtype false @@ -46834,6 +46836,10 @@ literal "false" \end_layout +\begin_layout Subsubsection +LaTeX-Sprachunterstützung +\end_layout + \begin_layout Description Sprachpaket legt fest, welches \SpecialChar LaTeX -Paket für die Sprachunterstützung geladen @@ -46903,21 +46909,25 @@ Befehl \begin_inset space ~ \end_inset -Anfang Wenn ein besonderes \SpecialChar LaTeX --Paket benötigt wird, um in einer gewissen Dokumentsp -rache zu schreiben, können Sie hier den Befehl zum Start des Paketes eingeben. - Ein Beispiel ist der Befehl +Anfang Hier können Sie den Befehl anpassen, der verwendet wird, um zu einer + anderen Sprache umzuschalten. + Das kann nützlich sein, wenn Sie mit \series bold - -\backslash -begin{arabtext} +babel \series default -, der gebraucht wird, um mithilfe des Paketes + einen alternativen Befehl verwenden möchten ( +\series bold +babel +\series default + bietet verschiedene Alternativen mit jeweiligen Spezifika) oder wenn Sie + ein besonderes \SpecialChar LaTeX +-Paket benötigen, um in einer bestimmten Dokumentsprache + schreiben zu können, etwa \series bold Arab\SpecialChar TeX \series default - Arabisch zu schreiben, siehe + \begin_inset CommandInset citation LatexCommand cite key "Arabic" @@ -46925,18 +46935,35 @@ literal "true" \end_inset -. +, welches den Befehl +\family typewriter + +\backslash +begin{arabtext} +\family default + zur Sprachumschaltung nutzt. Standard ist der \series bold babel \series default -Befehl -\series bold +\family typewriter \backslash selectlanguage{$$lang} +\family default +, wobei +\family typewriter +$$lang +\family default + ein Platzhalter ist, der in der \SpecialChar LaTeX +-Ausgabe mit der eigentlichen Sprache ersetzt + wird. + Bitte beachten Sie, dass diese Einstellung mit +\series bold +polyglossia \series default -. + ignoriert wird.. \end_layout \begin_layout Description @@ -46953,21 +46980,35 @@ Befehl Anfang \family default . - Einige Pakete wie das Standardpaket haben keinen Endbefehl, weil der Startbefeh -l das Paket an- und abschaltet. -\end_layout + Verwenden Sie dies, wenn eine Sprachumschaltung explizit beendet werden + muss, wie das beispielsweise im alternativen Babel-Befehl +\family typewriter -\begin_layout Description -Standard-Dezimaltrenner Legen Sie hier den Standard-Dezimaltrenner fest, - welcher für die Ausrichtung am Dezimalzeichen in Tabellen verwendet wird. - Voreingestellt ist der Punkt, im Deutschen wird in der Regel aber ein Komma - verwendet. -\end_layout +\backslash +begin{otherlanguage*}\SpecialChar ldots -\begin_layout Description -Standard-Längeneinheit Legt die Einheit fest, die als Voreinstellung für - Längen in \SpecialChar LyX -’ Dialogen verwendet wird. +\backslash +end{otherlanguage*} +\family default + der Fall ist. + Standardmäßig ist dieses Feld leer, da +\family typewriter + +\backslash +selectlanguage{$$lang} +\family default + nicht explizit beendet werden muss (es ist aktiv bis zum nächsten +\family typewriter + +\backslash +selectlanguage{$$lang} +\family default +). + Bitte beachten Sie, dass diese Einstellung mit +\series bold +polyglossia +\series default + ignoriert wird. \end_layout \begin_layout Description @@ -46979,21 +47020,27 @@ global \begin_inset space ~ \end_inset -definieren Wenn diese Option gesetzt wird, werden die im Dokument benutzten - Sprachen zu den Klassenoptionen des Dokuments hinzugefügt, sodass sie von - allen \SpecialChar LaTeX --Paketen benutzt werden können. - Sonst werden sie nur als Optionen von -\family typewriter -babel -\family default - benutzt. +definieren Wenn diese Option ausgewählt wird, werden die im Dokument benutzten + Sprachen zu den Klassenoptionen des Dokuments hinzugefügt, sonst werden + sie nur als Optionen zum Sprachpaket hinzugefügt. + Da die Dokumentklasse alle Optionen an die Pakete weitergibt, können Sie + so sicherstellen, dass \SpecialChar LaTeX +-Pakete, die sich je nach Sprache unterschiedlich + verhalten, wissen, welche Sprache aktiv ist. \end_layout \begin_layout Description -Auto-Beginn Wenn diese Option gesetzt wird, starten die Dokumente mit der - gewählten Dokumentsprache. - Wenn nicht, wird der Befehl +Dokumentsprache +\begin_inset space ~ +\end_inset + +explizit +\begin_inset space ~ +\end_inset + +aktivieren Wenn diese Option ausgewählt ist, wird am Anfang des Dokuments + die Dokumentsprache dadurch noch einmal explizit aktiviert, dass der in + \family sans \series bold Befehl @@ -47003,10 +47050,10 @@ Befehl Anfang \family default \series default - explizit an den Anfang der \SpecialChar LaTeX --Ausgabe des Dokuments geschrieben. - Damit wird sichergestellt, dass die richtige Sprache benutzt wird, wenn - Sie in + festgelegte Befehl explizit ausgegeben wird. + Dadurch können Sie sicherstellen, dass die Dokumentsprache in jedem Fall + aktiv ist. + Das kann nötig werden, wenn Sie in \family sans \series bold Befehl @@ -47016,22 +47063,27 @@ Befehl Anfang \family default \series default -nicht die Standardeinstellung benutzen. +nicht die Standardeinstellung benutzen oder aber wenn die Sprache durch + ein Paket umgeschaltet wird. + Wenn dies nicht gesetzt wird, ist am Dokumentbeginn die Sprache aktiv, + die zuletzt aktiviert wurde (im Normalfall ist das die Dokumentsprache). \end_layout \begin_layout Description -Auto-Ende ist das Gegenstück zu -\family sans -\series bold -Auto +Dokumentsprache +\begin_inset space ~ +\end_inset + +explizit \begin_inset space ~ \end_inset -Beginn +deaktivieren ist das Gegenstück zu +\family sans +Dokumentsprache explizit aktivieren \family default -\series default . - Wenn es nicht gesetzt ist, wird der + Wenn dies ausgewählt ist, wird der \family sans \series bold Befehl @@ -47041,11 +47093,19 @@ Befehl Ende \family default \series default - ans Ende des Dokuments geschrieben. + am Ende des Dokuments ausgegeben. +\end_layout + +\begin_layout Subsubsection +Editor-Einstellungen \end_layout \begin_layout Description -Fremdsprachen +Zusätzliche +\begin_inset space ~ +\end_inset + +Sprachen \begin_inset space ~ \end_inset @@ -47054,30 +47114,44 @@ markieren Wenn Sie dies ankreuzen, werden Texte in einer anderen Sprache \end_layout \begin_layout Description -Rechts-nach-links-Sprachunterstützung für die entsprechenden Sprachen wie - Arabisch, Hebräisch, Persisch. -\end_layout +Tastatursprache +\begin_inset space ~ +\end_inset -\begin_layout Description -RNL-Unterstützung +des \begin_inset space ~ \end_inset -aktivieren aktiviert Unterstützung für Sprachen, die von rechts nach links - geschrieben werden. +Betriebssystems +\begin_inset space ~ +\end_inset + +respektieren Wenn dies aktiviert ist, schaltet \SpecialChar LyX + die Eingabesprache um, wenn + die Tastaturtabelle über das Betriebssystem umgeschaltet wurde. + Das ist besonders dann nützlich, wenn Sie zwischen Sprachen mit verschiedenen + Schriftsystemen oder Alphabeten umschalten (beispielsweise zwischen Deutsch + und Hebräisch: In diesem Fall wird, sobald Sie die Tastatur auf Hebräisch + umschalten, automatisch die Eingabesprache ebenfalls nach Hebräisch umgeschalte +t, und umgekehrt). \end_layout \begin_layout Description -Cursorbewegung legt fest, wie der Cursor sich bei RNL-Sprachen verhält, - wenn sie die Pfeil-rechts- oder Pfeil-links-Taste drücken. +Rechts-nach-links-Cursor-Navigation legt fest, wie sich der Cursor beim + Schreiben von Sprachen mit rechtslaufenden Schriften (bspw. + Hebräisch, Arabisch oder Farsi) verhält, wenn sie die Pfeil-rechts- oder + Pfeil-links-Taste drücken. \family sans Logisch \family default bedeutet, dass der Cursor nach links bewegt wird, wenn Sie die Pfeil-rechts-Tas -te drücken, während sich der Cursor in einer RNL-Passage befindet. - Diese Einstellung ist vor allem in gemischten Texten (RNL und LNR) sinnvoll, - da die Cursorbewegung dann einer einheitlichen Textlogik folgt. +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 linkslaufende + Schriften mischen, da die Cursorbewegung dann einer einheitlichen Textlogik + folgt. \family sans Visuell @@ -47086,6 +47160,23 @@ Visuell Pfeile zeigen \end_layout +\begin_layout Subsubsection +Lokale Einstellungen +\end_layout + +\begin_layout Description +Standard-Dezimaltrenner Legen Sie hier den Standard-Dezimaltrenner fest, + welcher für die Ausrichtung am Dezimalzeichen in Tabellen verwendet wird. + Voreingestellt ist der Punkt, im Deutschen wird in der Regel aber ein Komma + verwendet. +\end_layout + +\begin_layout Description +Standard-Längeneinheit Legt die Einheit fest, die als Voreinstellung für + Längen in \SpecialChar LyX +’ Dialogen verwendet wird. +\end_layout + \begin_layout Subsection Rechtschreibprüfung \end_layout