Documentation of new IPA features

lib/doc/UserGuide.lyx

@@ -134,6 +134,7 @@ enumitem
 \html_math_output 0
 \html_css_as_file 0
 \html_be_strict true
+\author -712698321 "Jürgen Spitzmüller" 
 \author 5863208 "ab" 
 \author 2090807402 "usti" 
 \end_header
@@ -39623,11 +39624,32 @@ Single
 \begin_inset space ~
 \end_inset
 
-Quote Inserts this quote: 
+Quote Inserts 
+\change_deleted -712698321 1345809482
+this
+\change_inserted -712698321 1345809484
+a single
+\change_unchanged
+ quote
+\change_deleted -712698321 1345809487
+: 
 \begin_inset Quotes ers
 \end_inset
 
 
+\change_inserted -712698321 1345809513
+ in the quotation marks style selected in the 
+\family sans
+Document\SpecialChar \menuseparator
+Settings
+\family default
+ dialog under 
+\family sans
+Language
+\family default
+.
+\change_unchanged
+
 \end_layout
 
 \begin_layout Description
@@ -39682,9 +39704,36 @@ Language ! Phonetic symbols
 
 \end_inset
 
-Creates a formula with a so called tipa inset.
+
- Here you can insert commands to create IPA phonetic symbols.
+\change_deleted -712698321 1345808954
- For this feature you must have the LaTeX-package 
+Creates a formula with a so called tipa inset
+\change_inserted -712698321 1345808969
+Inserts a box where
+\change_deleted -712698321 1345809001
+.
+ Here
+\change_unchanged
+ you can insert 
+\change_deleted -712698321 1345809047
+commands to create IPA phonetic 
+\change_unchanged
+symbols
+\change_inserted -712698321 1345809189
+ from the International Phonetic Alphabet (IPA) and opens a toolbar which
+ provides a large set of these symbols
+\change_unchanged
+.
+ 
+\change_deleted -712698321 1345809068
+For
+\change_inserted -712698321 1345809068
+To use
+\change_unchanged
+ this feature 
+\change_inserted -712698321 1345809224
+with traditional LaTeX 
+\change_unchanged
+you must have the LaTeX-package 
 \series bold
 tipa
 \series default
@@ -39702,8 +39751,15 @@ LaTeX-packages ! tipa
 \begin_inset Newline newline
 \end_inset
 
-For more information about this feature we refer you to the documentation
+
- of 
+\change_deleted -712698321 1345809282
+For m
+\change_inserted -712698321 1345809283
+M
+\change_unchanged
+ore information about this feature 
+\change_deleted -712698321 1345809286
+we refer you to the documentation of 
 \series bold
 tipa, 
 \begin_inset CommandInset citation
@@ -39730,6 +39786,16 @@ http://wiki.lyx.org/LyX/LinguistLyX
 \end_inset
 
 
+\change_inserted -712698321 1345809397
+can be found in the Linguistics manual (
+\family sans
+Help\SpecialChar \menuseparator
+Specific Manuals\SpecialChar \menuseparator
+Linguistics Manual
+\family default
+).
+\change_unchanged
+
 \end_layout
 
 \begin_layout Subsection

lib/doc/de/UserGuide.lyx

@@ -35736,12 +35736,12 @@ Nicht-typographisches
 \end_inset
 
 Anführungszeichen Fügt dieses Anführungszeichen ein: ", unabhängig vom Anführung
-szeichen-Stil der im Menü 
+szeichen-Stil der im Dialog 
 \family sans
 Dokument\SpecialChar \menuseparator
 Einstellungen
 \family default
- Dialog unter 
+ unter 
 \family sans
 Sprache
 \family default
@@ -35753,11 +35753,17 @@ Einfaches
 \begin_inset space ~
 \end_inset
 
-Anführungszeichen Fügt dieses Anführungszeichen ein: 
+Anführungszeichen Fügt ein einfaches Anführungszeichen im Anführungszeichenstil
-\begin_inset Quotes grs
+ ein, der im Dialog 
-\end_inset
+\family sans
-
+Dokument\SpecialChar \menuseparator
-
+Einstellungen
+\family default
+ unter 
+\family sans
+Sprache
+\family default
+ eingestellt ist.
 \end_layout
 
 \begin_layout Description
@@ -35818,9 +35824,11 @@ Symbole
 
 \end_inset
 
-Erstellt eine Formel mit einer sogenannten tipa-Einfügung.
+Erstellt eine Einfügung, in die man Symbole des Internationalen Phonetischen
- In diese kann man Befehle eingeben um phonetische Symbole der IPA zu erzeugen.
+ Alphabets (IPA) eingeben kann, und öffnet eine Symbolleiste, die einen
- Für dieses Feature muss das LaTeX-Paket 
+ Großteil dieser Symbole bereitstellt.
+ Um dieses Feature mit traditionellem LaTeX nutzen zu können, muss das LaTeX-Pak
+et 
 \series bold
 tipa
 \series default
@@ -35838,34 +35846,13 @@ LaTeX-Paket ! tipa
 \begin_inset Newline newline
 \end_inset
 
-Für weitere Informationen über dieses Feature siehe die Dokumentation von
+Weitere Informationen über dieses Feature bietet das Linguistik-Handbuch
- 
+ unter 
-\series bold
+\family sans
-tipa, 
+Hilfe\SpecialChar \menuseparator
-\begin_inset CommandInset citation
+Spezielle Handbücher
-LatexCommand cite
+\family default
-key "tipa"
+.
-
-\end_inset
-
-
-\series default
- und diese Wiki-Seite:
-\begin_inset Newline newline
-\end_inset
-
-
-\begin_inset Flex URL
-status open
-
-\begin_layout Plain Layout
-
-http://wiki.lyx.org/LyX/LinguistLyX
-\end_layout
-
-\end_inset
-
-
 \end_layout
 
 \begin_layout Subsection

lib/examples/de/linguistics.lyx

@@ -1,5 +1,5 @@
-#LyX 2.0 created this file. For more info see http://www.lyx.org/
+#LyX 2.1 created this file. For more info see http://www.lyx.org/
-\lyxformat 413
+\lyxformat 438
 \begin_document
 \begin_header
 \textclass article
@@ -26,7 +26,6 @@ linguistics
 \font_osf false
 \font_sf_scale 100
 \font_tt_scale 100
-
 \graphics default
 \default_output_format default
 \output_sync 0
@@ -46,15 +45,21 @@ linguistics
 \pdf_pdfusetitle true
 \papersize default
 \use_geometry false
-\use_amsmath 1
+\use_package amsmath 1
-\use_esint 1
+\use_package amssymb 1
-\use_mhchem 1
+\use_package esint 1
-\use_mathdots 1
+\use_package mathdots 1
+\use_package mathtools 0
+\use_package mhchem 1
+\use_package undertilde 0
 \cite_engine basic
+\cite_engine_type numerical
+\biblio_style plain
 \use_bibtopic false
 \use_indices false
 \paperorientation portrait
 \suppress_date false
+\justification true
 \use_refstyle 0
 \index Stichwortverzeichnis
 \shortcut idx
@@ -873,7 +878,7 @@ status open
 \align center
 \begin_inset Tabular
 <lyxtabular version="3" rows="5" columns="5">
-<features tabularvalignment="middle">
+<features rotate="0" tabularvalignment="middle">
 <column alignment="right" valignment="top" width="0">
 <column alignment="center" valignment="top" width="0">
 <column alignment="center" valignment="top" width="0">
@@ -1345,7 +1350,8 @@ Um phonetische Zeichen einzugeben, brauchen Sie das Linguistikmodul nicht.
 \end_layout
 
 \begin_layout Standard
-Um LyX' IPA-Funktion zu benutzen, müssen Sie das Paket 
+Um LyX' IPA-Funktion mit klassischem LaTeX oder PDFLaTeX zu benutzen, müssen
+ Sie das Paket 
 \emph on
 tipa
 \emph default
@@ -1357,6 +1363,29 @@ key "tipa"
 \end_inset
 
  installiert haben.
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+Wenn Sie XeTeX oder LuaTeX verwenden (und 
+\begin_inset Quotes gld
+\end_inset
+
+Nicht-TeX-Schriften verwenden
+\begin_inset Quotes grd
+\end_inset
+
+ in 
+\family sans
+Dokument\SpecialChar \menuseparator
+Einstellungen\SpecialChar \menuseparator
+Schriften
+\family default
+ aktiviert haben), brauchen Sie kein zusätzliches Paket.
+\end_layout
+
+\end_inset
+
  Für eine direkte Vorschau der IPA-Symbole im Arbeitsfenster sollten Sie
  weiterhin das 
 \emph on
@@ -1381,33 +1410,31 @@ Sonderzeichen\SpecialChar \menuseparator
 Phonetische Symbole 
 \family default
 aktivieren.
- Es wird ein kleiner umrahmter Bereich eingefügt, in den Sie die Zeichen
+ Es wird ein kleiner umrahmter Eingabebereich eingefügt und eine Symbolleiste
- mithilfe der Kurznotation eingeben können, die im 
+ aktiviert, die die wichtigsten IPA-Symbole (nach den IPA-Kategorien sortiert)
-\emph on
+ bereitstellt.
-tipa
+ Jeder Symbolbereich dieser Symbolleiste kann durch Klicken auf die gestrichelte
-\emph default
+ Linie abgetrennt werden.
--Handbuch erläutert wird.
+ Dadurch kann phonetische Notation recht komfortabel eingegeben werden:
- Ein Beispiel: 
+ 
-\begin_inset Formula $\text{\textipa{[Ekspl@"neIS@n]}}$
+\begin_inset IPA
+
+\begin_layout Standard
+[ˈɛtva zo:]
+\end_layout
+
 \end_inset
 
- (
+.
-\emph on
-tipa
-\emph default
--Kurznotation: 
-\family typewriter
-[Ekspl@"neIS@n
-\family default
-]).
  Wenn
 \emph on
  preview-lat
-\family sans
 \emph default
 e
-\family default
+\emph on
-x installiert ist und Sie weiterhin in
+x
+\emph default
+ installiert ist und Sie weiterhin in
 \family sans
  Werkzeuge\SpecialChar \menuseparator
 Einstellungen\SpecialChar \ldots{}
@@ -1424,65 +1451,62 @@ Sofortige Vorschau
 
  aktiviert haben, zeigt LyX eine schöne WYSIWYG-Vorschau der Notation an,
  sobald der Cursor den IPA-Bereich verlässt.
-\end_layout
+ Alternativ zur Symbolleiste können Sie die Zeichen auch direkt mithilfe
+ der Kurznotation eingeben können, die im 
+\emph on
+tipa
+\emph default
+-Handbuch erläutert wird: hier eine 
+\begin_inset IPA
 
 \begin_layout Standard
-Alternativ können die meisten IPA-Zeichen auch direkt eingegeben (z.
+[kOst"pro:b@]
-\begin_inset space \thinspace{}
+\end_layout
+
 \end_inset
 
-B.
+ (
- über 
+\emph on
+tipa
+\emph default
+-Kurznotation: 
+\family typewriter
+[kOst"pro:b@
+\family default
+]).
+ Alternativ können Sie die meisten IPA-Zeichen auch über 
 \family sans
 Einfügen\SpecialChar \menuseparator
 Sonderzeichen\SpecialChar \menuseparator
 Symbole\SpecialChar \ldots{}
 
 \family default
-) oder aus einem anderen Dokument kopiert und in LyX eingefügt werden, so
+ in das Eingabefeld eingeben oder sie aus einem anderen Dokument kopieren
- wie hier: [ɛkspləˈneɪʃən].
+ und dort einfügen.
+ Die Ausgabe sollte immer identisch sein, egal welche Eingabemethode Sie
+ wählen.
+\end_layout
+
+\begin_layout Standard
+Bitte beachten Sie, dass Sie die meisten IPA-Zeichen über die zuletzt genannten
+ Methoden auch außerhalb des IPA-Eingabebereichs einfügen können: [zoː viː
+ hiːɐ̯].
  In der Ausgabe werden diese Zeichen dann ebenfalls direkt in die korrekten
  
 \emph on
 tipa
 \emph default
--Makros umgewandelt (lassen Sie es mich wissen, falls das nicht der Fall
+-Makros umgewandelt (lassen Sie es uns wissen, falls das nicht der Fall
  ist).
- Dieses Verfahren erscheint auf den ersten Blick besser, da man die Kurznotation
+ Dieses Verfahren hat aber gravierende Nachteile gegenüber der IPA-Umgebung,
- nicht lernen muss.
+ denn die direkte Eingabe resultiert in der Regel in unerwünschter Schriftmischu
- Es hat aber gravierende Nachteile gegenüber der IPA-Umgebung von LyX:
+ng (die lateinischen Buchstaben werden aus der Grundschrift, die speziellen
-\end_layout
+ IPA-Zeichen aber aus der IPA-Schrift genommen, und diese beiden Schriften
-
+ passen nicht notwendigerweise zusammen).
-\begin_layout Enumerate
+ Innerhalb der IPA-Eingabeumgebung wird dagegen für alle Zeichen dieselbe
-Die direkte Eingabe resultiert häufig in unerwünschter Schriftmischung (im
+ Schrift verwendet.
- Beispiel oben werden die lateinischen Buchstaben aus der Grundschrift,
- die speziellen IPA-Zeichen aber aus der IPA-Schrift genommen, und diese
- beiden Schriften passen nicht notwendigerweise zusammen; 
-\family sans
-Einfügen\SpecialChar \menuseparator
-Sonderzeichen\SpecialChar \menuseparator
-Phonetische Symbole
-\family default
- verwendet dagegen für alle Zeichen dieselbe Schrift, nämlich die mit 
-\emph on
-tipa
-\emph default
- gelieferte IPA-Schrift).
-\end_layout
-
-\begin_layout Enumerate
-Die Zurichtung der Zeichen (
-\emph on
-Kerning
-\emph default
-) wird unter Umständen negativ beeinträchtigt.
-\end_layout
-
-\begin_layout Standard
  Deshalb sollten Sie, wenn Sie nicht wirklich nur Einzelzeichen eingeben,
- unbedingt das erste Vorgehen wählen.
+ unbedingt dieses Vorgehen wählen.
- Die tipa-Kurznotation ist übrigens ziemlich intuitiv.
- Hat man sie einmal gelernt, kann man damit sehr schnell arbeiten.
 \end_layout
 
 \begin_layout Section
@@ -1508,7 +1532,6 @@ key "linguistlyx"
 \end_layout
 
 \begin_layout Bibliography
-\labelwidthstring Literaturverzeichnis
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "covington"
@@ -1530,7 +1553,6 @@ http://www.ctan.org/tex-archive/macros/latex/contrib/covington/
 \end_layout
 
 \begin_layout Bibliography
-\labelwidthstring Literaturverzeichnis
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "csquotes"
@@ -1552,7 +1574,6 @@ http://www.ctan.org/tex-archive/macros/latex/contrib/csquotes/
 \end_layout
 
 \begin_layout Bibliography
-\labelwidthstring Literaturverzeichnis
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "enumitem"
@@ -1574,7 +1595,6 @@ http://www.ctan.org/tex-archive/macros/latex/contrib/enumitem/
 \end_layout
 
 \begin_layout Bibliography
-\labelwidthstring Literaturverzeichnis
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "float"
@@ -1596,7 +1616,6 @@ http://www.ctan.org/tex-archive/macros/latex/contrib/float/
 \end_layout
 
 \begin_layout Bibliography
-\labelwidthstring Literaturverzeichnis
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "linguistlyx"
@@ -1620,7 +1639,6 @@ http://wiki.lyx.org/LyX/LinguistLyX
 \end_layout
 
 \begin_layout Bibliography
-\labelwidthstring Literaturverzeichnis
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "preview"
@@ -1642,7 +1660,6 @@ http://www.ctan.org/tex-archive/macros/latex/contrib/preview/
 \end_layout
 
 \begin_layout Bibliography
-\labelwidthstring Literaturverzeichnis
 \begin_inset CommandInset bibitem
 LatexCommand bibitem
 key "tipa"

lib/examples/linguistics.lyx

@@ -1,5 +1,5 @@
-#LyX 2.0 created this file. For more info see http://www.lyx.org/
+#LyX 2.1 created this file. For more info see http://www.lyx.org/
-\lyxformat 413
+\lyxformat 438
 \begin_document
 \begin_header
 \textclass article
@@ -26,7 +26,6 @@ linguistics
 \font_osf false
 \font_sf_scale 100
 \font_tt_scale 100
-
 \graphics default
 \default_output_format default
 \output_sync 0
@@ -46,15 +45,21 @@ linguistics
 \pdf_pdfusetitle true
 \papersize default
 \use_geometry false
-\use_amsmath 1
+\use_package amsmath 1
-\use_esint 1
+\use_package amssymb 1
-\use_mhchem 1
+\use_package esint 1
-\use_mathdots 1
+\use_package mathdots 1
+\use_package mathtools 0
+\use_package mhchem 1
+\use_package undertilde 0
 \cite_engine basic
+\cite_engine_type numerical
+\biblio_style plain
 \use_bibtopic false
 \use_indices false
 \paperorientation portrait
 \suppress_date false
+\justification true
 \use_refstyle 0
 \index Index
 \shortcut idx
@@ -832,7 +837,7 @@ status open
 \align center
 \begin_inset Tabular
 <lyxtabular version="3" rows="5" columns="5">
-<features tabularvalignment="middle">
+<features rotate="0" tabularvalignment="middle">
 <column alignment="right" valignment="top" width="0">
 <column alignment="center" valignment="top" width="0">
 <column alignment="center" valignment="top" width="0">
@@ -1271,11 +1276,12 @@ Phonetic Symbols (IPA)
 You do not need the Linguistics module to insert phonetic symbols, this
  is a base functionality of LyX.
  However, since this is frequently used by linguists, we will describe it
- (briefly) in this paper nevertheless.
+ (briefly) in this manual nevertheless.
 \end_layout
 
 \begin_layout Standard
-A prerequisite to use LyX's IPA support is the LaTeX package 
+If you use traditional LaTeX or PDFLaTeX, a prerequisite to use LyX's IPA
+ support is the LaTeX package 
 \emph on
 tipa
 \emph default
@@ -1287,6 +1293,33 @@ key "tipa"
 \end_inset
 
 .
+\begin_inset Foot
+status collapsed
+
+\begin_layout Plain Layout
+If you use XeTeX or LuaTeX (i.
+\begin_inset space \thinspace{}
+\end_inset
+
+e., if you have clicked 
+\begin_inset Quotes eld
+\end_inset
+
+Use non-TeX fonts
+\begin_inset Quotes erd
+\end_inset
+
+ in 
+\family sans
+Document\SpecialChar \menuseparator
+Settings\SpecialChar \menuseparator
+Fonts
+\family default
+), no extra package is needed.
+\end_layout
+
+\end_inset
+
  Additionally, if you want to have instant preview, you should have the
  
 \emph on
@@ -1303,32 +1336,38 @@ key "preview"
 \end_layout
 
 \begin_layout Standard
-Phonetic symbols can be entered via 
+The recommended way to insert phonetic symbols is via 
 \family sans
 Insert\SpecialChar \menuseparator
 Special characters\SpecialChar \menuseparator
 Phonetic symbols.
  
 \family default
-You get a little frame, where you can insert the symbols using the shortcut
+This gives you an input box, where you can insert the symbols, and a toolbar
- notation which is described in the 
+ opens, which provides the basic set of phonetic symbols (sorted by the
-\emph on
+ IPA categories).
-tipa
+ Each of the toolbar's panels can be torn off the bar by clicking on the
-\emph default
+ dashed line on its top.
- manual.
+ This way, you can insert most symbols quite comfortably: 
- Example: 
+\begin_inset IPA
-\begin_inset Formula $\text{\textipa{[Ekspl@"neIS@n]}}$
+
+\begin_layout Standard
+[l
+\begin_inset IPADeco bottomtiebar
+status open
+
+\begin_layout Plain Layout
+ai
+\end_layout
+
 \end_inset
 
- (
+k ðɪs]
-\emph on
+\end_layout
-tipa
+
-\emph default
+\end_inset
- shortcut notation: 
+
-\family typewriter
+.
-[Ekspl@"neIS@n
-\family default
-]).
  Given that
 \emph on
  preview-latex
@@ -1339,56 +1378,75 @@ tipa
 Preferences\SpecialChar \menuseparator
 Graphi
 \family default
-cs), you'll get a nice preview as soon as the cursor leaves the frame.
+cs), you'll get a nice WYSIWYG preview as soon as the cursor leaves the
-\end_layout
+ box.
+ Alternatively to the toolbar, you can also insert the symbols directly
+ via the shortcut notation which is described in the 
+\emph on
+tipa
+\emph default
+ manual: here's 
+\begin_inset IPA
 
 \begin_layout Standard
-Furthermore, most IPA glyphs can also be inserted (e.
+
-\begin_inset space \thinspace{}
+\family roman
+\series medium
+\shape up
+\size normal
+\emph off
+\bar no
+\strikeout off
+\uuline off
+\uwave off
+\noun off
+\color none
+[@n Iɡ"zA:mpl]
+\end_layout
+
 \end_inset
 
-g.
+ (
-\begin_inset space \space{}
+\emph on
-\end_inset
+tipa
-
+\emph default
-via 
+ shortcut notation: 
+\family typewriter
+[@n Iɡ"zA:mpl
+\family default
+]).
+ Furthermore, you can insert symbols via 
 \family sans
 Insert\SpecialChar \menuseparator
 Special characters\SpecialChar \menuseparator
 Symbols\SpecialChar \ldots{}
 
 \family default
-) or pasted directly into LyX: [ɛkspləˈneɪʃən].
+ (which might be useful for symbols that are not yet covered by the toolbar),
+ or you can simply paste unicode-encoded text (e.
+\begin_inset space \thinspace{}
+\end_inset
+
+g., from other applications) into the box.
+ The output should be equal, no matter what input method you chose.
+\end_layout
+
+\begin_layout Standard
+Note that you can also insert or paste most IPA glyphs outside the specific
+ IPA input box: [əz ʃəʊn hɪə].
  In the output, they will be automatically transformed into the correct
  
 \emph on
 tipa
 \emph default
- macro (if not, please inform me).
+ macro (if not, please inform us).
- However, please note that the former method produces better output quality
+ However, please note that this method produces inferior output quality,
- for two reasons:
+ since it will most likely result in a mix of fonts (the latin characters
-\end_layout
+ are taken from the base document font, the IPA glyphs from the IPA font).
-
+ Within the IPA input box, on the other hand, the IPA font is used for all
-\begin_layout Enumerate
+ characters.
-direct input might result in a mix of fonts (in the above example, the latin
+ So unless you only need to insert single IPA characters, this method is
- characters are taken from the base font, the IPA glyphs from the IPA font,
+ highly recommended.
- whereas 
-\family sans
-Insert\SpecialChar \menuseparator
-Special characters\SpecialChar \menuseparator
-Phonetic symbol
-\family default
-s uses the IPA font for all characters)
-\end_layout
-
-\begin_layout Enumerate
-the letter kerning is not preserved
-\end_layout
-
-\begin_layout Standard
-So unless you only need to insert single IPA characters, the former method
- is recommended, and it's worth learning the (pretty intuitive) IPA shortcut
- notation.
 \end_layout
 
 \begin_layout Section