From d0209eb2865f96ae4b6e1d4d1ffad5b994b25b5b Mon Sep 17 00:00:00 2001
From: =?utf8?q?Uwe=20St=C3=B6hr?= <uwestoehr@lyx.org>
Date: Mon, 10 Feb 2014 01:15:52 +0100
Subject: [PATCH] UserGuide.lyx: add info about widows and orphans

(thanks Helmut for this info)
- German UserGuide.lyx: add missing section about proper names
---
 lib/doc/UserGuide.lyx    |  52 ++++---
 lib/doc/de/UserGuide.lyx | 325 +++++++++++++++++++++++++++++++++++++--
 lib/doc/es/UserGuide.lyx |  41 +++--
 lib/doc/fr/UserGuide.lyx |  42 +++--
 lib/doc/ja/UserGuide.lyx |  38 ++++-
 5 files changed, 435 insertions(+), 63 deletions(-)

diff --git a/lib/doc/UserGuide.lyx b/lib/doc/UserGuide.lyx
index 363acf5917..4f7cee704e 100644
--- a/lib/doc/UserGuide.lyx
+++ b/lib/doc/UserGuide.lyx
@@ -16689,7 +16689,7 @@ name "sub:LyX's-Proper-Names"
 
 \begin_layout Standard
 You will certainly have noticed that the word “LaTeX” always appears with
- characters in different sizes and heights.
+ characters in different sizes and positions.
  LaTeX is the name of the program used by LyX and is therefore recognized
  as a proper name when you type it in LyX as 
 \begin_inset Quotes eld
@@ -16715,16 +16715,8 @@ eX
 status collapsed
 
 \begin_layout Plain Layout
-The braces in TeX Code are here to avoid that the 
-\begin_inset Quotes eld
-\end_inset
-
-command
-\begin_inset Quotes erd
-\end_inset
-
- appear as proper name in the output, see the last paragraph of this section.
- To create proper names omit the TeX Code.
+The braces in TeX Code are here to avoid that the Text appears as proper
+ name in the output, see the last paragraph of this section.
 \end_layout
 
 \end_inset
@@ -17028,10 +17020,9 @@ Typography ! Widows and orphans
 In the early days of word processors, page breaks went wherever the page
  happened to end.
  There was no regard for what was actually going on in the text.
- You may remember once printing out a document, only to find the heading
- for a new section printed at the very bottom of the page, the first line
- of a new paragraph all alone at the bottom of a page, or the last line
- of a paragraph at the top of a new page.
+ For example the heading for a new section was printed at the very bottom
+ of the page, the first line of a new paragraph all alone at the bottom
+ of a page, or the last line of a paragraph at the top of a new page.
  These bits of text became known as 
 \emph on
 widows
@@ -17050,13 +17041,28 @@ Clearly, LyX can avoid breaking pages after a section heading.
  of a paragraph all alone at the top or bottom of a page? There are rules
  built into LaTeX governing page breaks, and some of those rules are there
  specifically to prevent widows and orphans.
- This is the advantage LyX has in using LaTeX as its backend.
-\end_layout
+ If they appear nevertheless and you don't like them, you can add the commands
+\begin_inset Newline newline
+\end_inset
 
-\begin_layout Standard
-We cannot go into how TeX and LaTeX decide to break a page, or how you can
- tweak that behavior.
- Some LaTeX books listed in the bibliography (such as
+
+\series bold
+
+\backslash
+widowpenalty=10000
+\begin_inset Newline newline
+\end_inset
+
+
+\backslash
+clubpenalty=10000
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+to the LaTeX preamble of your document to avoid them.
+ Some LaTeX books (such as
 \begin_inset space ~
 \end_inset
 
@@ -17078,8 +17084,8 @@ key "latexguide"
 
 \end_inset
 
-) may have more information.
- You will almost never need to worry about this, however.
+) have more information about the technical details of LaTeX's page break
+ mechanism.
 \end_layout
 
 \begin_layout Chapter
diff --git a/lib/doc/de/UserGuide.lyx b/lib/doc/de/UserGuide.lyx
index e568065c5c..7f2bf147ec 100644
--- a/lib/doc/de/UserGuide.lyx
+++ b/lib/doc/de/UserGuide.lyx
@@ -557,6 +557,48 @@ Neu
 konfigurieren
 \family default
  neu konfigurieren.
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Plain Layout
+Die zwei geschweiften Klammern in der TeX-Code-Box verhindern, dass der
+ Begriff 
+\begin_inset Quotes gld
+\end_inset
+
+LaTeX
+\begin_inset Quotes grd
+\end_inset
+
+ mit hoch- und tiefgestellten Zeichen ausgegeben wird.
+ Mehr zu TeX-Code ist in Abschnitt
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sec:TeX-Code"
+
+\end_inset
+
+ zu finden; die Ausgabe von Eigennamen wie LaTeX ist in Abschnitt
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sub:LyXs-Eigennamen"
+
+\end_inset
+
+ beschrieben.
+\end_layout
+
+\end_inset
+
+
 \begin_inset Index idx
 status collapsed
 
@@ -17693,6 +17735,237 @@ fest
 .
 \end_layout
 
+\begin_layout Subsection
+LyXs Eigennamen
+\begin_inset Index idx
+status collapsed
+
+\begin_layout Plain Layout
+LyX ! Eigennamen
+\end_layout
+
+\end_inset
+
+
+\begin_inset CommandInset label
+LatexCommand label
+name "sub:LyXs-Eigennamen"
+
+\end_inset
+
+
+\end_layout
+
+\begin_layout Standard
+Sie haben sicherlich bemerkt, dass das Wort 
+\begin_inset Quotes gld
+\end_inset
+
+LaTeX
+\begin_inset Quotes grd
+\end_inset
+
+ immer mit Zeichen in verschiedener Größe und Positionen ausgegeben wird.
+ LaTeX ist der Name des Programms, das von LyX verwendet wird und wird daher
+ als Eigenname erkannt, wenn man in LyX 
+\begin_inset Quotes gld
+\end_inset
+
+LaT
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+{}
+\end_layout
+
+\end_inset
+
+eX
+\begin_inset Quotes grd
+\end_inset
+
+ schreibt.
+\begin_inset Note Note
+status collapsed
+
+\begin_layout Plain Layout
+Die geschweiften Klammern in TeX-Code sind hier dazu da, zu verhindern,
+ dass der Text als Eigenname ausgegeben wird, siehe den letzten Absatz dieses
+ Abschnitts.
+\end_layout
+
+\end_inset
+
+ Beachten Sie die Reihenfolge der hoch- und tiefgestellten Zeichen! LyX
+ erkennt die folgenden Eigennamen:
+\end_layout
+
+\begin_layout Description
+LyX Das Programm um das es hier geht; schreiben Sie 
+\begin_inset Quotes gld
+\end_inset
+
+L
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+{}
+\end_layout
+
+\end_inset
+
+yX
+\begin_inset Quotes grd
+\end_inset
+
+ um in zu erzeugen.
+\end_layout
+
+\begin_layout Description
+TeX Das Programm, dass von LaTeX verwendet wird; schreiben Sie 
+\begin_inset Quotes gld
+\end_inset
+
+T
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+{}
+\end_layout
+
+\end_inset
+
+eX
+\begin_inset Quotes grd
+\end_inset
+
+ um in zu erzeugen.
+\end_layout
+
+\begin_layout Description
+LaTeX Das Programm, dass von LyX verwendet wird; schreiben Sie 
+\begin_inset Quotes gld
+\end_inset
+
+LaT
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+{}
+\end_layout
+
+\end_inset
+
+eX
+\begin_inset Quotes grd
+\end_inset
+
+ um in zu erzeugen.
+\end_layout
+
+\begin_layout Description
+LaTeX2e Die aktuelle Version von LaTeX; schreiben Sie 
+\begin_inset Quotes gld
+\end_inset
+
+LaT
+\begin_inset ERT
+status collapsed
+
+\begin_layout Plain Layout
+
+{}
+\end_layout
+
+\end_inset
+
+eX2e
+\begin_inset Quotes grd
+\end_inset
+
+ um in zu erzeugen.
+\end_layout
+
+\begin_layout Standard
+Sie wundern sich vielleicht warum die LaTeX-Version 
+\begin_inset Quotes gld
+\end_inset
+
+2
+\begin_inset Formula $\epsilon$
+\end_inset
+
+
+\begin_inset Quotes grd
+\end_inset
+
+ ist.
+ Es ist eine alte Tradition in der TeX-Welt, dass man für Programme verrückte
+ Versionsnummern vergibt.
+ Zum Beispiel konvergiert die Versionsnummer von TeX zur Zahl 
+\begin_inset Formula $\pi$
+\end_inset
+
+: Die aktuelle Version ist 
+\begin_inset Quotes gld
+\end_inset
+
+TeX-3.141592
+\begin_inset Quotes grd
+\end_inset
+
+, die vorherige war 
+\begin_inset Quotes gld
+\end_inset
+
+TeX-3.14159
+\begin_inset Quotes grd
+\end_inset
+
+.
+\end_layout
+
+\begin_layout Standard
+Wenn Sie keine Eigennamen ausgeben wollen, z.
+\begin_inset space \thinspace{}
+\end_inset
+
+B.
+ in Abschnittsüberschriften, können Sie zwei leere geschweifte Klammern
+ in TeX-Code in das Wort einfügen.
+ In LyX sieht das dann so aus: 
+\begin_inset Graphics
+	filename ../clipart/LaTeX.png
+	scale 80
+
+\end_inset
+
+.
+\begin_inset Newline newline
+\end_inset
+
+Für mehr über TeX-Code siehe Abschnitt
+\begin_inset space ~
+\end_inset
+
+
+\begin_inset CommandInset ref
+LatexCommand ref
+reference "sec:TeX-Code"
+
+\end_inset
+
+.
+\end_layout
+
 \begin_layout Subsection
 Einheiten
 \begin_inset Index idx
@@ -17845,11 +18118,14 @@ name "sub:Schusterjungen-und-Hurenkinder"
 In den frühen Tagen der Textverarbeitungen passierten Seitenumbrüche genau
  dort, wo die Seiten zu Ende waren.
  Es spielte keine Rolle, worum es im Text eigentlich ging.
- Sie werden sich sicher erinnern, dass Sie nach dem Drucken eines Dokumentes
- feststellten, dass die Überschrift eines neuen Abschnittes oder die erste
- Zeile eines neuen Absatzes allein auf der letzten Zeile einer Seite standen,
- oder dass die letzte Zeile eines Absatzes die erste Zeile einer neuen Seite
- bildete.
+ So stand z.
+\begin_inset space \thinspace{}
+\end_inset
+
+B.
+ die Überschrift eines neuen Abschnittes oder die erste Zeile eines neuen
+ Absatzes allein auf der letzten Zeile einer Seite, oder die letzte Zeile
+ eines Absatzes bildete erste Zeile einer neuen Seite.
  Diese Dinge nennt man 
 \emph on
 Schusterjungen
@@ -17862,23 +18138,41 @@ Hurenkinder
 \end_layout
 
 \begin_layout Standard
-Klar, dass LyX vermeiden kann, eine Seite direkt nach der Abschnittsüberschrift
+\noindent
+Natürlich kann LyX vermeiden, eine Seite direkt nach der Abschnittsüberschrift
  umzubrechen.
  Das ist ein Vorteil von Absatzumgebungen.
  Aber was ist mit Schusterjungen und Hurenkindern? LaTeX hat Regeln, um
  mit Seitenumbrüchen fertig zu werden, und einige von ihnen sind speziell
  dazu da, um Schusterjungen und Hurenkinder zu verhindern.
- Das ist 
-\emph on
-ein
-\emph default
- Vorteil, dass LyX LaTeX im Hintergrund hat.
+ Wenn Schusterjungen trotzdem auftreten und Sie stören, können Sie im LaTeX-Vors
+pann Ihres Dokuments die Befehle
+\begin_inset Newpage newpage
+\end_inset
+
+
 \end_layout
 
 \begin_layout Standard
-Wir können es nicht näher erläutern, wie TeX und LaTeX Seitenumbrüche festlegen
- oder wie man das Verhalten beeinflussen kann.
- Einige LaTeX-Bücher im Literaturverzeichnis (zum Beispiel
+\noindent
+
+\series bold
+
+\backslash
+widowpenalty=10000
+\begin_inset Newline newline
+\end_inset
+
+
+\backslash
+clubpenalty=10000
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+hinzufügen um diese zu vermeiden.
+ Einige LaTeX-Bücher (zum Beispiel
 \begin_inset space \space{}
 \end_inset
 
@@ -17900,8 +18194,7 @@ key "latexguide"
 
 \end_inset
 
-) mögen mehr darüber enthalten.
- Auf jeden Fall müssen Sie sich fast nie darum kümmern.
+) enthalten mehr zu den technischen Details zu LaTeXs Seitenumbruch.
 \end_layout
 
 \begin_layout Chapter
diff --git a/lib/doc/es/UserGuide.lyx b/lib/doc/es/UserGuide.lyx
index 411cb8c2dd..897a8fce27 100644
--- a/lib/doc/es/UserGuide.lyx
+++ b/lib/doc/es/UserGuide.lyx
@@ -17127,7 +17127,6 @@ status collapsed
 \begin_layout Plain Layout
 Las llaves en código TeX impiden que «comando» aparezca como nombre propio
  en la salida; véase el último párrafo de esta sección.
- Para generar nombres propios omite el código TeX.
 \end_layout
 
 \end_inset
@@ -17448,13 +17447,36 @@ Sin duda, LyX puede impedir los saltos de página detrás de un encabezado
  deja una línea de un párrafo aislada al principio o al final de una página?
  LaTeX incorpora reglas que gobiernan los saltos de página, y algunas de
  ellas están pensadas precisamente para evitar las líneas viudas o huérfanas.
- Esta es una de las ventajas que obtiene LyX del empleo de LaTeX como soporte.
-\end_layout
+ 
+\lang english
+If they appear nevertheless and you don't like them, you can add the commands
+\lang spanish
 
-\begin_layout Standard
-No es posible explicar aquí la forma en que TeX y LaTeX deciden dónde saltar
- una página , o en cómo ajustar esta característica.
- Algunos libros sobre LaTeX listados en la bibliografía [como
+\begin_inset Newline newline
+\end_inset
+
+
+\series bold
+
+\backslash
+widowpenalty=10000
+\begin_inset Newline newline
+\end_inset
+
+
+\backslash
+clubpenalty=10000
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+
+\lang english
+to the LaTeX preamble of your document to avoid them
+\lang spanish
+.
+ Algunos libros sobre LaTeX [como
 \begin_inset space ~
 \end_inset
 
@@ -17476,8 +17498,9 @@ key "latexguide"
 
 \end_inset
 
-] tienen más información.
- Sin embargo, no deberías preocuparte por este asunto.
+] tienen más información sobre 
+\lang english
+the technical details of LaTeX's page break mechanism.
 \end_layout
 
 \begin_layout Chapter
diff --git a/lib/doc/fr/UserGuide.lyx b/lib/doc/fr/UserGuide.lyx
index 03a0e82192..f9f4c3f9d4 100644
--- a/lib/doc/fr/UserGuide.lyx
+++ b/lib/doc/fr/UserGuide.lyx
@@ -17860,7 +17860,6 @@ commande
 
  apparaisse comme un nom propre dans la sortie finale, voir le dernier paragraph
 e de cette section.
- Pour créer des noms propres ne mettez pas les accolades.
 \end_layout
 
 \end_inset
@@ -18188,13 +18187,36 @@ LyX peut éviter de changer de page juste après un en-tête de section.
  ne laissent qu'une ligne d'un paragraphe toute seule au sommet ou au bas
  d'une page ? LaTeX suit des règles concernant les sauts de page, et certaines
  d'entre elles sont spécialement destinées à éviter les veuves et les orphelins.
- C'est l'avantage d'utiliser LaTeX en interne.
-\end_layout
+ 
+\lang english
+If they appear nevertheless and you don't like them, you can add the commands
+\lang french
 
-\begin_layout Standard
-Nous n'allons pas traiter de la façon de décider TeX ou LaTeX à changer
- de page, ou de la façon d'influencer ce comportement.
- Quelques livres sur LaTeX cités dans la bibliographie (comme
+\begin_inset Newline newline
+\end_inset
+
+
+\series bold
+
+\backslash
+widowpenalty=10000
+\begin_inset Newline newline
+\end_inset
+
+
+\backslash
+clubpenalty=10000
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+
+\lang english
+to the LaTeX preamble of your document to avoid them
+\lang french
+.
+ Quelques livres sur LaTeX (comme
 \begin_inset space ~
 \end_inset
 
@@ -18216,9 +18238,9 @@ key "latexguide"
 
 \end_inset
 
-) peuvent contenir plus d'informations.
- De toutes façons, vous n'aurez presque jamais à vous inquiéter de tout
- cela.
+) peuvent contenir plus d'informations 
+\lang english
+about the technical details of LaTeX's page break mechanism.
 \end_layout
 
 \begin_layout Chapter
diff --git a/lib/doc/ja/UserGuide.lyx b/lib/doc/ja/UserGuide.lyx
index 10389410bf..c4a5a37a53 100644
--- a/lib/doc/ja/UserGuide.lyx
+++ b/lib/doc/ja/UserGuide.lyx
@@ -14389,11 +14389,36 @@ status collapsed
 \begin_layout Standard
 LyXでは原理的に、節見出しの直後に改頁が起こることを避けることができることはあきらかです。これは段落環境を採用していることの利点なのです。しかし、改頁によって
 段落のうち一行だけをページの冒頭や末尾に取り残してしまう、孤立行に関してはどうでしょう。実はLaTeXには、改頁を制御する規則が埋め込まれていて、これらに含まれ
-ている規則の一部が、孤立行の発生を明示的に防いでいるのです。これは、LaTeXをバックエンドとして使うことによって、LyXが獲得している利点です。
-\end_layout
+ている規則の一部が、孤立行の発生を明示的に防いでいるのです。
+\lang english
+If they appear nevertheless and you don't like them, you can add the commands
+\lang japanese
 
-\begin_layout Standard
-ここでは、TeXやLaTeXが改頁を決定する方法や、その挙動の変更方法について、詳述する紙幅がありません。参考文献に引用してあるLaTeX関連書籍(
+\begin_inset Newline newline
+\end_inset
+
+
+\series bold
+
+\backslash
+widowpenalty=10000
+\begin_inset Newline newline
+\end_inset
+
+
+\backslash
+clubpenalty=10000
+\series default
+
+\begin_inset Newline newline
+\end_inset
+
+
+\lang english
+to the LaTeX preamble of your document to avoid them.
+ Some LaTeX books
+\lang japanese
+(
 \begin_inset CommandInset citation
 LatexCommand cite
 key "latexcompanion"
@@ -14407,7 +14432,10 @@ key "latexguide"
 
 \end_inset
 
-)などに詳しい説明をしているものがあります。しかしながら、この点を気にしなくてはならなくなることは、まずないでしょう。
+)
+\lang english
+have more information about the technical details of LaTeX's page break
+ mechanism.
 \end_layout
 
 \begin_layout Chapter
-- 
2.39.2