[LyX master] linguistics manual: document shortcomings (and workarounds) of glosses

[Juergen Spitzmueller]

The branch, master, has been updated.

- Log -----------------------------------------------------------------

commit 46cdb3616cc09489cf4b7f1f3c41fc5539ea4a7d
Author: Juergen Spitzmueller <sp...@lyx.org>
Date:   Sat Jun 23 19:31:01 2012 +0200

    linguistics manual: document shortcomings (and workarounds) of glosses

diff --git a/lib/examples/de/linguistics.lyx b/lib/examples/de/linguistics.lyx
index e44d8e2..7cdb2ef 100644
--- a/lib/examples/de/linguistics.lyx
+++ b/lib/examples/de/linguistics.lyx
@@ -529,9 +529,18 @@ glt Do you have matches?
 
 \end_layout
 
+\begin_layout Subsection*
+Beschränkungen von LyX-Glossen
+\end_layout
+
 \begin_layout Standard
-Bitte beachten Sie auch, dass Schriftänderungen in den Glossen nicht möglich
- sind.
+Die Unterstützung für Glossen in LyX ist ziemlich basal und hat daher einige
+ Beschränkungen, die in zukünftigen LyX-Versionen möglicherweise behoben
+ werden:
+\end_layout
+
+\begin_layout Enumerate
+Schriftänderungen sind in den Glossen nicht möglich.
  Der Textstil-Dialog ist daher auch deaktiviert.
  Da Wörter in Glossen niemals getrennt werden, ist eine explizite Bestimmung
  der Sprache in der LaTeX-Ausgabe nicht nötig (und sie würde auch zu Fehlern
@@ -540,8 +549,8 @@ Bitte beachten Sie auch, dass Schriftänderungen in den 
Glossen nicht möglich
 covington
 \emph default
 -Paket dies nicht unterstützt).
- Dennoch mögen Sie vielleicht die Sprache in den Glossen festlegen wollen,
- damit die Rechtschreibprüfung in LyX richtig funktioniert.
+ Dennoch wollen Sie vielleicht die Sprache in den Glossen festlegen, damit
+ die Rechtschreibprüfung in LyX richtig funktioniert.
  Um das zu tun, müssen Sie folgendermaßen vorgehen: Markieren Sie den Text
  und führen Sie dann 
 \family sans
@@ -571,7 +580,11 @@ Minibuffer
 \begin_inset Quotes grs
 \end_inset
 
-), wobei Sie 
+, in den Sie dann 
+\family sans
+language <lang>
+\family default
+ eingeben), wobei Sie 
 \family sans
 <lang>
 \family default
@@ -588,8 +601,221 @@ english
 french
 \family default
 .
+ In der LaTeX-Ausgabe werden die Sprachumschaltungen nun zwar weiterhin
+ unterdrückt, aber die Rechtschreibprüfung erkennt die Sprache.
+\end_layout
+
+\begin_layout Enumerate
+Da der Inhalt von Glossen unverändert an LaTeX weitergegeben wird, passt
+ LyX die Textkodierung nicht an den Inhalt an.
+ Das heißt, dass Sie, wenn Sie in der Glosse Zeichen verwenden, die die
+ aktuelle Kodierung nicht abdeckt, eine Fehlermeldung bekommen werden.
+ Folgendermaßen können Sie das Problem umgehen:
+\end_layout
+
+\begin_deeper
+\begin_layout Itemize
+Geben Sie entweder den Text außerhalb der Glosse ein, öffnen Sie dann 
+\family sans
+Ansicht\SpecialChar \menuseparator
+Quelle ansehen
+\family default
+ und kopieren Sie den LaTeX-Code von dort in die Glosse,
+\end_layout
+
+\begin_layout Itemize
+oder markieren Sie die ganze Glosse (von außen) und stellen Sie über 
+\family sans
+Bearbeiten\SpecialChar \menuseparator
+Sprache\SpecialChar \menuseparator
+Weitere Sprachen\SpecialChar \ldots{}
+ 
+\family default
+die angemessene Sprache ein,
+\end_layout
+
+\begin_layout Itemize
+oder ändern Sie in 
+\family sans
+Dokument\SpecialChar \menuseparator
+Einstellungen\SpecialChar \ldots{}
+\SpecialChar \menuseparator
+Sprache
+\family default
+ die Kodierung auf 
+\emph on
+Unicode (utf8
+\emph default
+),
+\end_layout
+
+\begin_layout Itemize
+oder wählen Sie in 
+\family sans
+Dokument\SpecialChar \menuseparator
+Einstellungen\SpecialChar \ldots{}
+\SpecialChar \menuseparator
+Schriften
+\family default
+ 
+\emph on
+Nicht-TeX-Schriften verwenden (via XeTeX/LuaTeX)
+\emph default
+.
+\end_layout
+
+\end_deeper
+\begin_layout Enumerate
+Innerhalb von Glossen können Seiten umbrochen werden, was natürlich nicht
+ erwünscht ist.
+ Um dies zu umgehen, können Sie Glossen in Boxen packen (über 
+\family sans
+Einfügen\SpecialChar \menuseparator
+Box\SpecialChar \menuseparator
+Rahmenlos
+\family default
+).
+ Wenn Sie dies automatisch für alle Glossen im Dokument tun wollen, können
+ Sie den folgenden LaTeX-Code nach 
+\family sans
+Dokument\SpecialChar \menuseparator
+Einstellungen\SpecialChar \ldots{}
+\SpecialChar \menuseparator
+LaTeX-Vorspann
+\family default
+ kopieren:
+\end_layout
+
+\begin_deeper
+\begin_layout LyX-Code
+\begin_inset listings
+lstparams "basicstyle={\footnotesize},language={[LaTeX]TeX}"
+inline false
+status open
+
+\begin_layout Plain Layout
+% 
+Kein Seitenumbruch bei zweizeiligen Glossen
+\end_layout
+
+\begin_layout Plain Layout
+
+\backslash
+AtBeginDocument{%
+\end_layout
+
+\begin_layout Plain Layout
+
+\backslash
+@ifundefined{linggloss}{}{%
+\end_layout
+
+\begin_layout Plain Layout
+
+\backslash
+renewenvironment{linggloss}[1]{%
+\end_layout
+
+\begin_layout Plain Layout
+
+\backslash
+begin{minipage}{.7
+\backslash
+textwidth}
+\end_layout
+
+\begin_layout Plain Layout
+
+\backslash
+gll #1}{
+\backslash
+glend
+\backslash
+end{minipage}}}
+\end_layout
+
+\begin_layout Plain Layout
+}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout LyX-Code
+\begin_inset listings
+lstparams "basicstyle={\footnotesize},language={[LaTeX]TeX}"
+inline false
+status open
+
+\begin_layout Plain Layout
+
+% Kein Seitenumbruch bei dreizeiligen Glossen
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+AtBeginDocument{%
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+@ifundefined{lingglosss}{}{%
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+renewenvironment{linggloss}[1]{%
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+begin{minipage}{.7
+\backslash
+textwidth}
 \end_layout
 
+\begin_layout Plain Layout
+
+
+\backslash
+glll #1}{
+\backslash
+glend
+\backslash
+end{minipage}}}
+\end_layout
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Möglicherweise müssen Sie die Breite der Minipage (
+\family typewriter
+.7
+\backslash
+textwidth
+\family default
+ im Beispielcode) ändern, damit sie zur Seitenbreite Ihres Dokuments passt.
+\end_layout
+
+\end_deeper
 \begin_layout Section
 Tableaux für Optimalitätstheorie
 \end_layout
diff --git a/lib/examples/linguistics.lyx b/lib/examples/linguistics.lyx
index 267e65a..327088a 100644
--- a/lib/examples/linguistics.lyx
+++ b/lib/examples/linguistics.lyx
@@ -514,8 +514,17 @@ glt Do you have matches?
 
 \end_layout
 
+\begin_layout Subsection*
+Shortcomings of LyX's glosses
+\end_layout
+
 \begin_layout Standard
-Note that font changes are not allowed in glosses.
+LyX's glosse support is rather basic, and thus has some shortcomings, which
+ might be addressed in further releases:
+\end_layout
+
+\begin_layout Enumerate
+Font changes are not allowed in glosses.
  Hence, the 
 \family sans
 Character Style
@@ -558,9 +567,225 @@ french
 ngerman
 \family default
 .
- In the LaTeX output, this setting will be supressed.
+ In the LaTeX output, this setting will be suppressed.
 \end_layout
 
+\begin_layout Enumerate
+Since the content of glosses is passed verbatim to LaTeX, LyX does not adapt
+ the encoding to the contents.
+ That means that if you use characters in the glosse which are not covered
+ by the current encoding, you will run into an error message.
+ Here are the possible workarounds to this problem:
+\end_layout
+
+\begin_deeper
+\begin_layout Itemize
+Either enter the text outside the glosse, open 
+\family sans
+View\SpecialChar \menuseparator
+View Source
+\family default
+ and copy the LaTeX code into the glosse,
+\end_layout
+
+\begin_layout Itemize
+or mark the whole glosse (from outside) and set the appropriate language
+ via 
+\family sans
+Edit\SpecialChar \menuseparator
+Language\SpecialChar \menuseparator
+More Languages\SpecialChar \ldots{}
+
+\family default
+,
+\end_layout
+
+\begin_layout Itemize
+or set the document encoding to 
+\emph on
+Unicode (utf8)
+\emph default
+ via 
+\family sans
+Document\SpecialChar \menuseparator
+Settings\SpecialChar \ldots{}
+\SpecialChar \menuseparator
+Language
+\family default
+,
+\end_layout
+
+\begin_layout Itemize
+or check 
+\emph on
+Use non-TeX fonts (via XeTeX/LuaTeX)
+\emph default
+ in 
+\family sans
+Document\SpecialChar \menuseparator
+Settings\SpecialChar \ldots{}
+\SpecialChar \menuseparator
+Fonts
+\family default
+.
+\end_layout
+
+\end_deeper
+\begin_layout Enumerate
+Page breaks can occur within glosses, which is of course not desirable.
+ A workaround is to wrap glosses into boxes (via 
+\family sans
+Insert\SpecialChar \menuseparator
+Box\SpecialChar \menuseparator
+Frameless
+\family default
+).
+ If you want to automate this for all glosses, you can copy the following
+ code to 
+\family sans
+Document\SpecialChar \menuseparator
+Settings\SpecialChar \menuseparator
+LaTeX Preamble
+\family default
+:
+\end_layout
+
+\begin_deeper
+\begin_layout LyX-Code
+\begin_inset listings
+lstparams "basicstyle={\footnotesize},language={[LaTeX]TeX}"
+inline false
+status open
+
+\begin_layout Plain Layout
+
+% Do not break pages at two-line glosses
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+AtBeginDocument{%
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+@ifundefined{linggloss}{}{%
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+renewenvironment{linggloss}[1]{%
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+begin{minipage}{.7
+\backslash
+textwidth}
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+gll #1}{
+\backslash
+glend
+\backslash
+end{minipage}}}
+\end_layout
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout LyX-Code
+\begin_inset listings
+lstparams "basicstyle={\footnotesize},language={[LaTeX]TeX}"
+inline false
+status open
+
+\begin_layout Plain Layout
+
+% Do not break pages at three-line glosses
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+AtBeginDocument{%
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+@ifundefined{lingglosss}{}{%
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+renewenvironment{linggloss}[1]{%
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+begin{minipage}{.7
+\backslash
+textwidth}
+\end_layout
+
+\begin_layout Plain Layout
+
+
+\backslash
+glll #1}{
+\backslash
+glend
+\backslash
+end{minipage}}}
+\end_layout
+
+\begin_layout Plain Layout
+
+}
+\end_layout
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+You might have to adapt the minipage width (
+\family typewriter
+.7
+\backslash
+textwidth
+\family default
+ in the example code) to fit your actual page width.
+\end_layout
+
+\end_deeper
 \begin_layout Section
 Optimality Theory Tableaux
 \end_layout
@@ -1106,12 +1331,9 @@ tipa
 ]).
  Given that
 \emph on
- preview-lat
-\family sans
+ preview-latex
 \emph default
-e
-\family default
-x is installed and you have switched on instant preview (in
+ is installed and you have switched on instant preview (in
 \family sans
  Tools\SpecialChar \menuseparator
 Preferences\SpecialChar \menuseparator

-----------------------------------------------------------------------

Summary of changes:
 lib/examples/de/linguistics.lyx |  236 ++++++++++++++++++++++++++++++++++++++-
 lib/examples/linguistics.lyx    |  236 +++++++++++++++++++++++++++++++++++++-
 2 files changed, 460 insertions(+), 12 deletions(-)


hooks/post-receive
-- 
The LyX Source Repository