From e92e4e03f614388afd34970436a1f82a76684b84 Mon Sep 17 00:00:00 2001 From: Patrik Wehrli Date: Thu, 18 Mar 2021 18:52:34 +0100 Subject: [PATCH 1/3] German version of help page --- de/help.md | 147 +++++++++++++++++++++++++++++++++++++++++++++++++++- de/index.md | 2 +- 2 files changed, 146 insertions(+), 3 deletions(-) diff --git a/de/help.md b/de/help.md index 0fc9f96c..fa709fd3 100644 --- a/de/help.md +++ b/de/help.md @@ -1,17 +1,160 @@ --- +layout: "page" lang: "de" title: "Learnlatex.org verwenden" +description: "Diese Seite erklärt die learnlatex.org Webseite und wie man sie am besten nutzt." permalink: /de/help --- -Translation to be added _after_ English text completed. + +# Hilfe + + +## Navigating the site + +Der Kurs besteht aus 16 Hauptlektionen, welche über das [Inhaltsverzeichnis]({{ "/" | absolute_url | append: page.lang | append: "/#toc" }}) auf der [Startseite](./) erreichbar sind. + +Jede Lektion hat einen Link zu einer Zusatzlektion welche das Thema weiter vertieft. +Es sollte möglich sein alle 16 Lektionen durchzuarbeiten _ohne_ die Zusatzlektionen. + +Am Ende des Kurses gibt es eine oder mehrere Sprachspezifische Lektionen, +sowie eine Beispielsammlung von LaTeX Paketen, die nicht in diesem Kurs behandelt wurden. + +At the end of the course there are one or more lessons specific to the +language being used for the lessons, and finally a gallery of examples +of packages demonstrating LaTeX use not covered by this course. + +--- + +## Beispiele + +### Beispiele kompilieren Jedes Beispiel besteht aus einem kleinen, aber vollständigen LaTeX-Dokument, -das in einer Seite wie dieser gezeigt wird: +das auf der Seite so angezeigt wird: ```latex \documentclass{article} \usepackage[T1]{fontenc} + \begin{document} Example text. \end{document} ``` + +Jedes Beispiel ist komplett. Sie können kleinere Änderungen +z.B. für Übungsaufgaben direkt in dem Editor machen. + +Für die Beispiele wurde der [ACE](https://ace.c9.io/) Editor benutzt. + +#### Drei möglichkeiten die Beispiele zu kompilieren + +* Den Overleaf Service nutzen +* Den LaTeX Online Service nutzen +* Eine lokale TeX Installation nutzen + +##### Den Overleaf Service nutzen + +Overleaf ist einer der beliebtesten online LaTeX editoren. +Die Schaltfläche unter dem Beispiel, +übermittelt den Code an [Overleaf](https://www.overleaf.com/about). + +Wenn Sie keinen Overleaf Account haben, oder die Anmeldedaten nicht bereits +im Browser gespeichert sind, werden Sie zu einer Login-Seite weitergeleitet, +wo Sie sich registrieren oder einloggen können. Overleaf ist ein gratis Service, +Sie müssen nur wenige Informationen angeben, und den Nutzungsbedingungen zustimmen. + +Wenn Ihre Overleaf Anmeldedaten bereits im Browser vorhanden sind, wird +Overleaf in einem neuen Tab geöffnet, mit dem Code als neues Projekt. +Sie können den Code dann direkt bearbeiten, und Overleaf wird automatisch +LaTeX ausführen, und das resultierende Dokument, oder einen Fehlerbericht anzeigen. + +Die Editierfunktionen in Overleaf sind weitaus mächtiger als auf dieser Seite, +und Sie können Ihr Projekt im Overleaf Account speichern und später weiter arbeiten. + +##### Den LaTeX Online Service nutzen + +Die Schaltfläche unter dem Beispiel, +übermittelt den Code an [TexLive.net](https://texlive.net)[^1]. + +Der LaTeX CGI Dienst wurde speziell entwickelt für diese Seite und nutzt +teilweise [PDF.js](https://mozilla.github.io/pdf.js/) um PDF Dokumente +in Browsern ohne eingebaute PDF unterstützung anzuzeigen. + +Die resultierenden PDF-Dokumente (oder Fehlermeldungen) werden direkt unterhalb +der Beispiele angezeigt. Eine Schaltfläche wird +angezeigt, um die Ausgabe zu löschen. + +Bitte beachten Sie, dass **LaTeX Online** keinerlei Anmeldung oder Registrierung +benötigt. Das ist sehr nützlich für kleine Beispiele, aber weder diese Seite, +noch `latexcgi`, `latexonline.cc` oder `latex-on-http` bieten die Möglichkeit +Ihre Dokumente zu speichern. Jegliche Änderungen die Sie an dem Beispielcode +machen, ist verloren, wenn Sie die Seite schliessen. + +##### Eine lokale TeX Installation nutzen + +Wenn Sie TeX lokal installiert haben, können Sie den Beispielcode aus der +Seite entweder mit der Maus markieren, oder mit dem `Alles markieren` +Tastaturkürzel im Editor kopieren (In Windows ist das z.B. Strg-A Strg-C). +Das kopiert den Code in die Zwischenablage ihres Betriebssystems. +Dann können Sie ein neues leeres Dokument in Ihrem lokalen Editor öffnen, +und den Code hineinkopieren. + +### Fehlerbehebung + +Unsere Beispiele basieren auf einer aktuellen LaTeX installation. +Sie funktionieren mit beiden Online Services. Falls Sie mit dem Beispielcode +Fehlermeldungen erhalten, überprüfen Sie bitte, ob ihre LaTeX installation +auf dem neuesten Stand ist. + +--- + +## Ein TeX Programm wählen + +Wenn Sie den Beispielcode verwenden, wird automatisch das `pdflatex` Programm +genutzt. + +Sie können diese Auswahl auf `latex`, `pdflatex`, `xelatex`, `lualatex`, +`platex` oder `uplatex` verändern mit einem Kommentar in der Form: + +`% !TEX ` _irgendein text_ `lualatex` + +Das Leerzeichen am Anfang ist optional. Die Gross- und Kleinschreibung, +sowie auch der _irgendein text_ zwischen dem ersten und letzten Wort werden ignoriert. + +Das ermöglicht es die form `% !TEX program=pdflatex` zu nutzen, die von einigen +TeX Editoren verwendet wird, ohne auf `program=` zu achten. Es kann jeweils nur +eine der unterstützten Programme definiert werden. + +Ein Beispiel zur verwendung von LuaLaTeX finden Sie [auf dieser Seite](more-14). + +Wenn `platex` oder `uplatex` gewählt wurde, wird zusätzlich `dvipdfmx` +verwendet, um das PDF Dokument aus den DVI Dateien dieser Engines zu generieren. +Ähnlich wie `dvips` und `ps2pdf` benutzt werden wenn `latex` spezifiziert wurde. + +--- + +## Darstellung der Ausgabe wählen + +Wenn Sie einen der LaTeX online Service nutzen, wird die PDF Ausgabe +der Beispiele automatisch mit [PDF.js](https://mozilla.github.io/pdf.js/) +dargestellt. Das sorgt für konsistente Ergebnisse unabhängig vom verwendeten Browser. + +Falls Sie es bevorzugen den standard PDF Reader ihres Browsers zu verwenden +(im Browser integriert, oder als externe Applikation), können Sie einen +einen Kommentar in folgender Form hinzufügen: + +`% !TEX ` _irgendein text_ `pdf` + +Das Standardverhalten kann explizit definiert werden mit `pdfjs`. +Zur Fehlersuche kann es gewünscht sein, die Logdatei auszugeben, +auch wenn der Code ein PDF Dokument ohne Fehler generiert. +Dies kann mit der angabe von `log` erreicht werden. + +--- + +[^1]: Während der entwicklung dieser Seite haben wir auch +[LaTeX.Online](https://latexonline.cc/) und +[LaTeX-on-HTTP](https://github.com/YtoTech/latex-on-http) genutzt. +Wir möchten den Entwicklern dieser Services danken. Durch ihre Anpassungen +wurde es möglich die Beispiele auf dieser Seite schon in einer frühen +Phase zur verfügung zu stellen. diff --git a/de/index.md b/de/index.md index 52c8f466..088aef16 100644 --- a/de/index.md +++ b/de/index.md @@ -25,7 +25,7 @@ permalink: /de/

How it works

-

We have taken 16 of the most important things you will need to know, and made them into short lessons which should not take long to cover. In each lesson, we give lots of examples of what you would write. You can edit and run them in this website. More on examples …

+

We have taken 16 of the most important things you will need to know, and made them into short lessons which should not take long to cover. In each lesson, we give lots of examples of what you would write. You can edit and run them in this website. More on examples …

From 55bcb7ffccec489ae701ab1aa719eb439c7b0ad8 Mon Sep 17 00:00:00 2001 From: Jonathan Spratte Date: Sun, 21 Mar 2021 16:53:09 +0100 Subject: [PATCH 2/3] translate missing heading --- de/help.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/de/help.md b/de/help.md index fa709fd3..b4b088ee 100644 --- a/de/help.md +++ b/de/help.md @@ -9,7 +9,7 @@ permalink: /de/help # Hilfe -## Navigating the site +## Auf der Seite navigieren Der Kurs besteht aus 16 Hauptlektionen, welche über das [Inhaltsverzeichnis]({{ "/" | absolute_url | append: page.lang | append: "/#toc" }}) auf der [Startseite](./) erreichbar sind. From b13e893bf538286bdc9c110a87c2ebbc88ec2700 Mon Sep 17 00:00:00 2001 From: Jonathan Spratte Date: Sun, 21 Mar 2021 17:06:39 +0100 Subject: [PATCH 3/3] fix typos; remove untranslated paragraphs --- de/help.md | 72 ++++++++++++++++++++++++++---------------------------- 1 file changed, 35 insertions(+), 37 deletions(-) diff --git a/de/help.md b/de/help.md index b4b088ee..5ac5ce8b 100644 --- a/de/help.md +++ b/de/help.md @@ -13,15 +13,13 @@ permalink: /de/help Der Kurs besteht aus 16 Hauptlektionen, welche über das [Inhaltsverzeichnis]({{ "/" | absolute_url | append: page.lang | append: "/#toc" }}) auf der [Startseite](./) erreichbar sind. -Jede Lektion hat einen Link zu einer Zusatzlektion welche das Thema weiter vertieft. -Es sollte möglich sein alle 16 Lektionen durchzuarbeiten _ohne_ die Zusatzlektionen. +Jede Lektion hat einen Link zu einer Zusatzlektion, welche das Thema weiter +vertieft. Es sollte möglich sein, alle 16 Lektionen _ohne_ die Zusatzlektionen +durchzuarbeiten. -Am Ende des Kurses gibt es eine oder mehrere Sprachspezifische Lektionen, -sowie eine Beispielsammlung von LaTeX Paketen, die nicht in diesem Kurs behandelt wurden. - -At the end of the course there are one or more lessons specific to the -language being used for the lessons, and finally a gallery of examples -of packages demonstrating LaTeX use not covered by this course. +Am Ende des Kurses gibt es eine oder mehrere sprachspezifische Lektionen, +sowie eine Beispielsammlung von LaTeX Paketen, die nicht in diesem Kurs +behandelt wurden. --- @@ -37,16 +35,16 @@ das auf der Seite so angezeigt wird: \usepackage[T1]{fontenc} \begin{document} -Example text. +Beispieltext. \end{document} ``` Jedes Beispiel ist komplett. Sie können kleinere Änderungen -z.B. für Übungsaufgaben direkt in dem Editor machen. +z.B. für Übungsaufgaben direkt im Editor machen. Für die Beispiele wurde der [ACE](https://ace.c9.io/) Editor benutzt. -#### Drei möglichkeiten die Beispiele zu kompilieren +#### Drei Möglichkeiten die Beispiele zu kompilieren * Den Overleaf Service nutzen * Den LaTeX Online Service nutzen @@ -54,7 +52,7 @@ Für die Beispiele wurde der [ACE](https://ace.c9.io/) Editor benutzt. ##### Den Overleaf Service nutzen -Overleaf ist einer der beliebtesten online LaTeX editoren. +Overleaf ist einer der beliebtesten online LaTeX-Editoren. Die Schaltfläche unter dem Beispiel, übermittelt den Code an [Overleaf](https://www.overleaf.com/about). @@ -76,9 +74,9 @@ und Sie können Ihr Projekt im Overleaf Account speichern und später weiter arb Die Schaltfläche unter dem Beispiel, übermittelt den Code an [TexLive.net](https://texlive.net)[^1]. -Der LaTeX CGI Dienst wurde speziell entwickelt für diese Seite und nutzt -teilweise [PDF.js](https://mozilla.github.io/pdf.js/) um PDF Dokumente -in Browsern ohne eingebaute PDF unterstützung anzuzeigen. +Der LaTeX CGI Dienst wurde speziell für diese Seite entwickelt und nutzt +[PDF.js](https://mozilla.github.io/pdf.js/), um PDF Dokumente in Browsern ohne +eingebaute PDF-Unterstützung anzuzeigen. Die resultierenden PDF-Dokumente (oder Fehlermeldungen) werden direkt unterhalb der Beispiele angezeigt. Eine Schaltfläche wird @@ -86,24 +84,24 @@ angezeigt, um die Ausgabe zu löschen. Bitte beachten Sie, dass **LaTeX Online** keinerlei Anmeldung oder Registrierung benötigt. Das ist sehr nützlich für kleine Beispiele, aber weder diese Seite, -noch `latexcgi`, `latexonline.cc` oder `latex-on-http` bieten die Möglichkeit -Ihre Dokumente zu speichern. Jegliche Änderungen die Sie an dem Beispielcode -machen, ist verloren, wenn Sie die Seite schliessen. +noch `latexcgi`, `latexonline.cc` oder `latex-on-http` bieten die Möglichkeit, +Ihre Dokumente zu speichern. Jegliche Änderungen, die Sie an dem Beispielcode +machen, ist verloren, wenn Sie die Seite schließen. -##### Eine lokale TeX Installation nutzen +##### Eine lokale TeX-Installation nutzen Wenn Sie TeX lokal installiert haben, können Sie den Beispielcode aus der Seite entweder mit der Maus markieren, oder mit dem `Alles markieren` -Tastaturkürzel im Editor kopieren (In Windows ist das z.B. Strg-A Strg-C). +Tastaturkürzel im Editor kopieren (in Windows ist das z.B. Strg-A Strg-C). Das kopiert den Code in die Zwischenablage ihres Betriebssystems. -Dann können Sie ein neues leeres Dokument in Ihrem lokalen Editor öffnen, +Dann können Sie ein neues leeres Dokument in Ihrem lokalen Editor öffnen und den Code hineinkopieren. ### Fehlerbehebung -Unsere Beispiele basieren auf einer aktuellen LaTeX installation. -Sie funktionieren mit beiden Online Services. Falls Sie mit dem Beispielcode -Fehlermeldungen erhalten, überprüfen Sie bitte, ob ihre LaTeX installation +Unsere Beispiele basieren auf einer aktuellen LaTeX-Installation. +Sie funktionieren mit beiden Onlineservices. Falls Sie mit dem Beispielcode +Fehlermeldungen erhalten, überprüfen Sie bitte, ob ihre LaTeX-Installation auf dem neuesten Stand ist. --- @@ -118,43 +116,43 @@ Sie können diese Auswahl auf `latex`, `pdflatex`, `xelatex`, `lualatex`, `% !TEX ` _irgendein text_ `lualatex` -Das Leerzeichen am Anfang ist optional. Die Gross- und Kleinschreibung, +Das Leerzeichen am Anfang ist optional. Die Groß- und Kleinschreibung, sowie auch der _irgendein text_ zwischen dem ersten und letzten Wort werden ignoriert. -Das ermöglicht es die form `% !TEX program=pdflatex` zu nutzen, die von einigen -TeX Editoren verwendet wird, ohne auf `program=` zu achten. Es kann jeweils nur -eine der unterstützten Programme definiert werden. +Das ermöglicht es die Form `% !TEX program=pdflatex` zu nutzen, die von einigen +TeX-Editoren verwendet wird, ohne auf `program=` zu achten. Es kann jeweils nur +eines der unterstützten Programme definiert werden. -Ein Beispiel zur verwendung von LuaLaTeX finden Sie [auf dieser Seite](more-14). +Ein Beispiel zur Verwendung von LuaLaTeX finden Sie [auf dieser Seite](more-14). Wenn `platex` oder `uplatex` gewählt wurde, wird zusätzlich `dvipdfmx` verwendet, um das PDF Dokument aus den DVI Dateien dieser Engines zu generieren. -Ähnlich wie `dvips` und `ps2pdf` benutzt werden wenn `latex` spezifiziert wurde. +Ähnlich wie `dvips` und `ps2pdf` benutzt werden, wenn `latex` spezifiziert wurde. --- ## Darstellung der Ausgabe wählen -Wenn Sie einen der LaTeX online Service nutzen, wird die PDF Ausgabe +Wenn Sie einen der LaTeX Onlineservices nutzen, wird die PDF Ausgabe der Beispiele automatisch mit [PDF.js](https://mozilla.github.io/pdf.js/) dargestellt. Das sorgt für konsistente Ergebnisse unabhängig vom verwendeten Browser. -Falls Sie es bevorzugen den standard PDF Reader ihres Browsers zu verwenden +Falls Sie es bevorzugen, den Standard-PDF-Reader Ihres Browsers zu verwenden (im Browser integriert, oder als externe Applikation), können Sie einen -einen Kommentar in folgender Form hinzufügen: +Kommentar in folgender Form hinzufügen: `% !TEX ` _irgendein text_ `pdf` Das Standardverhalten kann explizit definiert werden mit `pdfjs`. Zur Fehlersuche kann es gewünscht sein, die Logdatei auszugeben, auch wenn der Code ein PDF Dokument ohne Fehler generiert. -Dies kann mit der angabe von `log` erreicht werden. +Dies kann mit der Angabe von `log` erreicht werden. --- -[^1]: Während der entwicklung dieser Seite haben wir auch +[^1]: Während der Entwicklung dieser Seite haben wir auch [LaTeX.Online](https://latexonline.cc/) und [LaTeX-on-HTTP](https://github.com/YtoTech/latex-on-http) genutzt. Wir möchten den Entwicklern dieser Services danken. Durch ihre Anpassungen -wurde es möglich die Beispiele auf dieser Seite schon in einer frühen -Phase zur verfügung zu stellen. +wurde es möglich, die Beispiele auf dieser Seite schon in einer frühen +Phase zur Verfügung zu stellen.