From c4a233e9e9b2572b23511c103ca60dff967950d8 Mon Sep 17 00:00:00 2001 From: Juergen Spitzmueller Date: Fri, 24 Aug 2012 15:20:48 +0200 Subject: [PATCH] Documentation of new IPA features --- lib/doc/UserGuide.lyx | 78 ++++++++++++-- lib/doc/de/UserGuide.lyx | 63 +++++------ lib/examples/de/linguistics.lyx | 175 ++++++++++++++++-------------- lib/examples/linguistics.lyx | 184 +++++++++++++++++++++----------- 4 files changed, 314 insertions(+), 186 deletions(-) diff --git a/lib/doc/UserGuide.lyx b/lib/doc/UserGuide.lyx index 2157442b06..08c04aa7c6 100644 --- a/lib/doc/UserGuide.lyx +++ b/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. - For this feature you must have the LaTeX-package + +\change_deleted -712698321 1345808954 +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 diff --git a/lib/doc/de/UserGuide.lyx b/lib/doc/de/UserGuide.lyx index 6aeee018ae..05678f9203 100644 --- a/lib/doc/de/UserGuide.lyx +++ b/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: -\begin_inset Quotes grs -\end_inset - - +Anführungszeichen Fügt ein einfaches Anführungszeichen im Anführungszeichenstil + ein, der im Dialog +\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. - In diese kann man Befehle eingeben um phonetische Symbole der IPA zu erzeugen. - Für dieses Feature muss das LaTeX-Paket +Erstellt eine Einfügung, in die man Symbole des Internationalen Phonetischen + Alphabets (IPA) eingeben kann, und öffnet eine Symbolleiste, die einen + 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 - -\series bold -tipa, -\begin_inset CommandInset citation -LatexCommand cite -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 - - +Weitere Informationen über dieses Feature bietet das Linguistik-Handbuch + unter +\family sans +Hilfe\SpecialChar \menuseparator +Spezielle Handbücher +\family default +. \end_layout \begin_layout Subsection diff --git a/lib/examples/de/linguistics.lyx b/lib/examples/de/linguistics.lyx index bbbf1aa7ab..2d64dcca3a 100644 --- a/lib/examples/de/linguistics.lyx +++ b/lib/examples/de/linguistics.lyx @@ -1,5 +1,5 @@ -#LyX 2.0 created this file. For more info see http://www.lyx.org/ -\lyxformat 413 +#LyX 2.1 created this file. For more info see http://www.lyx.org/ +\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_esint 1 -\use_mhchem 1 -\use_mathdots 1 +\use_package amsmath 1 +\use_package amssymb 1 +\use_package esint 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 - + @@ -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 - mithilfe der Kurznotation eingeben können, die im -\emph on -tipa -\emph default --Handbuch erläutert wird. - Ein Beispiel: -\begin_inset Formula $\text{\textipa{[Ekspl@"neIS@n]}}$ + Es wird ein kleiner umrahmter Eingabebereich eingefügt und eine Symbolleiste + aktiviert, die die wichtigsten IPA-Symbole (nach den IPA-Kategorien sortiert) + bereitstellt. + Jeder Symbolbereich dieser Symbolleiste kann durch Klicken auf die gestrichelte + Linie abgetrennt werden. + Dadurch kann phonetische Notation recht komfortabel eingegeben werden: + +\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 -x installiert ist und Sie weiterhin in +\emph on +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. -\begin_inset space \thinspace{} +[kOst"pro:b@] +\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 - wie hier: [ɛkspləˈneɪʃən]. + in das Eingabefeld eingeben oder sie aus einem anderen Dokument kopieren + 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 - nicht lernen muss. - Es hat aber gravierende Nachteile gegenüber der IPA-Umgebung von LyX: -\end_layout - -\begin_layout Enumerate -Die direkte Eingabe resultiert häufig in unerwünschter Schriftmischung (im - 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. - Die tipa-Kurznotation ist übrigens ziemlich intuitiv. - Hat man sie einmal gelernt, kann man damit sehr schnell arbeiten. + Dieses Verfahren hat aber gravierende Nachteile gegenüber der IPA-Umgebung, + denn die direkte Eingabe resultiert in der Regel in unerwünschter Schriftmischu +ng (die lateinischen Buchstaben werden aus der Grundschrift, die speziellen + IPA-Zeichen aber aus der IPA-Schrift genommen, und diese beiden Schriften + passen nicht notwendigerweise zusammen). + Innerhalb der IPA-Eingabeumgebung wird dagegen für alle Zeichen dieselbe + Schrift verwendet. + Deshalb sollten Sie, wenn Sie nicht wirklich nur Einzelzeichen eingeben, + unbedingt dieses Vorgehen wählen. \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" diff --git a/lib/examples/linguistics.lyx b/lib/examples/linguistics.lyx index 327088ab7d..594a8a4df0 100644 --- a/lib/examples/linguistics.lyx +++ b/lib/examples/linguistics.lyx @@ -1,5 +1,5 @@ -#LyX 2.0 created this file. For more info see http://www.lyx.org/ -\lyxformat 413 +#LyX 2.1 created this file. For more info see http://www.lyx.org/ +\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_esint 1 -\use_mhchem 1 -\use_mathdots 1 +\use_package amsmath 1 +\use_package amssymb 1 +\use_package esint 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 - + @@ -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 - notation which is described in the -\emph on -tipa -\emph default - manual. - Example: -\begin_inset Formula $\text{\textipa{[Ekspl@"neIS@n]}}$ +This gives you an input box, where you can insert the symbols, and a toolbar + opens, which provides the basic set of phonetic symbols (sorted by the + IPA categories). + Each of the toolbar's panels can be torn off the bar by clicking on the + dashed line on its top. + This way, you can insert most symbols quite comfortably: +\begin_inset IPA + +\begin_layout Standard +[l +\begin_inset IPADeco bottomtiebar +status open + +\begin_layout Plain Layout +ai +\end_layout + \end_inset - ( -\emph on -tipa -\emph default - shortcut notation: -\family typewriter -[Ekspl@"neIS@n -\family default -]). +k ðɪs] +\end_layout + +\end_inset + +. 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. -\end_layout +cs), you'll get a nice WYSIWYG preview as soon as the cursor leaves the + 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{} -\end_inset - -via + ( +\emph on +tipa +\emph default + 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). - However, please note that the former method produces better output quality - for two reasons: -\end_layout - -\begin_layout Enumerate -direct input might result in a mix of fonts (in the above example, the latin - characters are taken from the base font, the IPA glyphs from the IPA font, - 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. + macro (if not, please inform us). + However, please note that this method produces inferior output quality, + since it will most likely result in a mix of fonts (the latin characters + 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 + characters. + So unless you only need to insert single IPA characters, this method is + highly recommended. \end_layout \begin_layout Section