TeX-Notation: Unterschied zwischen den Versionen

Aus MoodleDocs
Wechseln zu:Navigation, Suche
Hauptseite ► Inhalte verwalten ► Filter ► TeX-Notation
Filter
(Die Seite wurde neu angelegt: „{{Filter}} {{Zum Übersetzen}} Siehe en:TeX_notation_filter ... ==TeX-Debugger== ... en:TeX_notation_filter Der TeX-Filter konvertiert TeX-Code…“)
 
Keine Bearbeitungszusammenfassung
 
(6 dazwischenliegende Versionen von einem anderen Benutzer werden nicht angezeigt)
Zeile 1: Zeile 1:
{{Filter}}
{{Filter}}
Der [[TeX-Notation|TeX-Filter]] konvertiert TeX-Code in GIF-Grafiken. Er benutzt dafür '''Mimetex'''. Für Linux (glib2.3), Windows und Max OS X bringt die Moodle Distribution bereits passende Binärprogramme mit.


{{Zum Übersetzen}}
Siehe [[:en:TeX_notation_filter]]


...
==Filter nutzen ==
Intern kann der Filter zwei verschiedene Methoden verwenden, um mathematische Ausdrücke in GIF-Grafiken umzuwandeln. Bei der ersten (bevorzugten) Methode benötigen Sie drei Binärdateien (''latex'', ''dvips'' und ''convert''), die Sie auf Ihrem Moodle-Server installieren und konfigurieren müssen (manche Web-Hoster übernehmen diesen Service). Die Filtereinstellungen, die weiter unten beschrieben werden, beziehen sich alle auf diese Methode.


==TeX-Debugger==
Wenn diese Methode nicht funktioniert, wendet der Filter automatisch die zweite Methode an, bei der nur eine Binärdatei Mimetex (im Verzeichnis ''/moodle/filters/tex'')benötigt wird. Diese Datei ist für die meisten Betriebssysteme im Standardpaket von Moodle enthalten.


...
Bevor Sie den Filter verwenden können, müssen Sie ihn als Administrator/in über den Menupunkt ''Website-Administration'' (oder im Block ''[[Einstellungen-Block|Einstellungen]] > Website-Administration'')'' > Plugins > Filter > Übersicht'' aktivieren. Wenn Sie darüber hinaus den [[Algebraische Notation|Algebra-Filter]] (eine Art "Frontend" für den TeX-Filter) nutzen wollen, aktivieren Sie diesen gleich mit.


[[en:TeX_notation_filter]]
Sobald der Filter aktiviert und konfiguriert ist, können Sie ihn für die Darstellung mathematischer Ausdrücke verwenden. Der Ausdruck muss in doppelte Doller-Zeichen eingeschlossen werden und in LaTeX-Syntax geschreiben sein.  
 
Der [[TeX-Filter]] konvertiert TeX-Code in GIF-Grafiken. Er benutzt dafür ein Programm namens [[MimeTex]]. Für Linux (glib2.3), Windows und Max OS X bringt die Moodle Distribution bereits passende Binärprogramme mit.
 
=== Benutzung ===


Um den Filter zu benutzen muss die Informationsquelle einen mit doppelten Doller-Zeichen geklammerten TeX-Ausdruck enthalten. Beispiel:
'''Beispiel''':
   
   
     $$ \sqrt{ x + y } $$
     $$ \sqrt{ x + y } $$


=== MimeTeX benutzen ===
== MimeTeX ==
 
Moodle kann eine spezielle MimeTeX Binärdatei (zu finden im Verzeichnis ''moodle/filters/tex'') verwenden, wenn der Zugriff auf die Binärdateien von dvips, convert und latex, die zusätzlich auf dem Moodle-Server installiert sind, nicht funktioniert (oder die Dateien gar nicht installiert wurden).  
MimeTeX wird in der Moodle Standard-Distribution in Form vorcompilierter Binärprogramme mitgeliefert. Diese Programme befinden sich im filters/tex Unterverzeichnis. Verschiedene Versionen für verschiedene Betriebssysteme (s.o.) sind hier verfügbar. Der TeX-Filter verwendet automatisch das zum erkannten Server-Betriebssystem passende Betriebssystem (insbesondere Solaris-Benutzer haben per Default kein Binäry!). Beachten Sie, dass Ihre Web-Server-Software mit den ausreichenden Rechten konfiguriert sein muss um an dieser Stelle Binärprogramme ausführen zu dürfen. Dies scheint insbesondere auf Windows-Servern ein Problem zu sein. Im [http://moodle.org/mod/forum/view.php?id=752 Mathematical Tools Forum] finden Sie hierzu weitere Informationen.
 
=== Neuerungen mit Version 1.6 ===
 
{{Moodle 1.6}}
 
Moodle 1.6 bringt als Neuerung die Fähigkeit die vollen Tex Formatierungsmöglichkeiten zu benutzen (MimeTex bietet nämlich nur eine Untermenge aller Möglichkeiten). Drei externe Binärprogramme werden benutzt um die Grafiken zu rendern. Hierfür ist evtl. ein passendes Setup Ihres Systems notwendig. Der Filter sucht zuerst einen LaTeX Renderer (Ghostscript wird für diese Variante ebenfalls benötigt) und verwendet erst wenn er keinen solchen findet das einfachere [[MimeTex]] das mit Moodle mitgeliefert wird. LaTeX erlaubt die gesamten Möglichkeiten des verfügbaren Syntax während [[MimeTex]] nur eine mathematische Untermenge unterstützt.


=== Einstellungs-Seite ===
Moodle kommt mit verschiedenen Versionen dieser MimeTeX Binärdatei - für verschiedene Betriebssysteme. Der TeX-Filter greift auf die Binärdatei zu, die zum Betriebssystem Ihres Moodle-Servers passt. (Sollte für Ihr Betriebssystem keine Binärdatei vorhanden sein, dann müssen Sie das Skript entsprechend anpassen.)


Die Einstellungs-Seite für den TeX-Filter hat die primäre Intention die Arbeitsweise des LaTeX-Renderers einzustellen. Die Standardeinstellungen für die drei Pfade werden in Abhängigkeit des erkannten Server-Betriebssystems der Moodle-Installation ausgewählt. Bei den Vorschlägen handelt es sich einfach um die jeweils üblichen Werte - Moodle prüft nicht ob die Binär-Programme tatsächlich an den jeweiligen Stellen vorhanden sind.
Beachten Sie, dass Ihr Webserver so konfiguriert sein muss, dass er Binärdateien in diesem Verzeichnis ausführen darf.


==== LaTeX Präambel ====
Es gibt ein [http://www.forkosh.com/mimetexmanual.html MimeTeX Handbuch]. Dieses richtet sich jedoch an System-Administrator/innen mit gewisser Erfahrung und ist nicht speziell auf Moodle ausgerichtet.


Erlaubt es die LaTeX Präambel anzugeben. Die Standard-Einstellung sollte für die meisten Benutzer ausreichen, aber Sie müssen diese Einstellung evtl. ändern um Non-Latin Zeichensätze usw. zu unterstützen. Konsultieren Sie die LaTeX Dokumentation für weitere Informatioen.
Sie sollten auf diese Binärdateien nur im Notfall zurückgreifen, d.h. wenn trifftige Gründe gegen eine separate LaTeX-Installation auf dem Moodle-Server (außerhalb von Moodle) sprechen.


==== Transparente Farbe ====
== Kompatibiltät mit MathJax ==
In Moodle 2.8 können die TeX-Notation und der [[MathJax-Filter]] in Kombination verwendet werden. Wenn auf einer Moodle-Seite beide Filter aktiviert sind, werden Bilder erst mit Hilfe des TeX-Filters dargestellt und anschließend werden die TeX-Ausdrücke durch die MathJax-Darstellung ersetzt. Das geschieht mit einer kleinen Verzögerung.


Dies sollte auf Ihre übliche Hintergrund-Farbe eingestellt werden. Die Standard-Einstellung ist #FFFFFF (d.h. weiß).
Wir empfehlen Trainer/innen, nur einen der beiden Filter zu aktivieren.


==== Dichte ====
==Systemweite Einstellungen==
Als Admnistrator/in können Sie über den Menupunkt ''Website-Administration'' (oder im Block ''[[Einstellungen-Block|Einstellungen]] > Website-Administration'')'' > Plugins > Filter > TeX-Notation'' folgende Einstellungen vornehmen:


Diese Einstellung wirkt sich auf die Größe der resultierenden Grafik aus.
;LaTeX Präambel
:Hier können Sie LaTeX Präambel angeben. Die Standard-Einstellung sollte für die meisten Nutzer/innen ausreichen, aber Sie müssen diese Einstellung evtl. ändern, um Non-Latin-Zeichensätze usw. zu unterstützen. Konsultieren Sie die LaTeX-Dokumentation für weitere Informatioen.


==== Pfad zum ''latex'' Binär-Programm ====
;Hintergrundfarbe
:Wählen Sie hier die Hintergrundfarbe für die generierte Grafik. Sie sollte mit der Hintergrundfarbe Ihrer Moodle-Site übereinstimmen. Die Standard-Einstellung ist #FFFFFF (d.h. weiß).


Pfad zum Standard-LaTeX-Binärprogramm.
;Dichte/Empfindlichkeit
:Diese Einstellung wirkt sich auf die Größe der resultierenden Grafik aus.


==== Pfad zum ''dvips'' Binary ====
;Pfad zum ''latex'' Binary
:Pfad zum Standard-LaTeX-Binärprogramm. Auf Unix-Systemen ist das normalerweise ''/usr/bin/latex'', unter MacOS X - ''/usr/texbin/'', unter Windows und Verwendung von MiKTeX - ''C:\texmf\miktex\bin\latex.exe''.


Pfad zum Stanard dvips Binary - wird generell als Teil des LaTeX Systems mitgeliefert.
;Pfad zum ''dvips'' Binary
:Pfad zum Standard dvips Binary - wird generell als Teil des LaTeX-Systems mitgeliefert. Auf Unix-Systemen ist das normalerweise ''/usr/bin/dvips'', unter MacOS X - ''/usr/texbin/'', unter Windows - ''C:\texmf\miktex\bin\dvips.exe''.  


==== Pfad zum ''convert'' Binary ====
;Pfad zum ''convert'' Binary
:Pfad zum Standard convert Binärprogramm. Dieses Programm ist Bestandteil des Ghostscript-Systems oder von ImageMagick unter Windows. Auf Unix-Systemen ist das normalerweise ''/usr/bin/convert'', unter MacOS X - ''/usr/local/bin'', unter Windows - ''C:\Program Files\ImageMagick\convert.exe'' (für ImageMagick). 


Pfad zum Standard convert Binärprogramm. Dieses Programm ist Bestandteil des Ghostscript Systems.
==Filter debuggen==
Der [[TeX-Notation|TeX-Filter]] hat ein Script zum Debuggen (schalten Sie dazu den Debug-Modus von Moodle auf der Seite ''Website-Administration'' (oder im Block ''[[Einstellungen-Block|Einstellungen]] > Website-Administration'')'' > Entwicklung > Debugging'' ein). Das Skript können Sie verwenden, wenn Sie Probleme mit dem Filter haben. Rufen Sie dazu die URL http://your.moodle.path/filter/tex/texdebug.php im Brwoser auf.


== Siehe auch: ==
== Siehe auch: ==


* [[Filter (administrator)]]
* [http://moodle.org/mod/glossary/view.php?id=2739&mode=letter&hook=M&sortkey=CREATION&sortorder=asc  TeX Filter Glossar] - ein [[Glossar]] zum Download, das die TeX-Notation erklärt und in einem Moodle-Kurs bereitgestellt werden kann.
* [http://moodle.org/mod/glossary/view.php?id=2739&mode=letter&hook=M&sortkey=CREATION&sortorder=asc  TeX Filter Glossar] - ein [[Glossar|glossar]] das Sie zu Ihrem Kurs hinzufügen können. Es erläutert die Details der der unterstützten [[TeX Notation]].
* [http://www.latex-project.org/ LaTeX]  
* [http://www.latex-project.org/ LaTeX] - das LaTeX Dokumenten Satzsystem.
* [http://www.ghostscript.com/ ghostscript] - ein Programm, das zur Erzeugung der Grafiken benötigt wird
* [http://www.ghostscript.com/ ghostscript] - wird für das Rendering der Bilder benötigt.
* [http://www.forkosh.com/mimetexmanual.html MimeTeX Manual] - TeX-Notation Manual
* [http://www.forkosh.com/mimetex.html mimetex] - erzeugt mathematische Ausdrücke auf Basis des (La)Tex-Codes.
* [http://www.miktex.org/ MikTeX] - LaTeX für Windows Systeme
* [http://www.miktex.org/ MikTeX] - LaTeX für Windows Systeme.
* [http://www.imagemagick.org/script/index.php ImageMagick] - ein Programm, das zur Erzeugung der Grafiken benötigt wird (läuft unter Windows)


[[Category:Administrator]]
[[Category:Website-Administration]]
[[Category:Filter]]
[[Category:Mathematik]]


[[en:TeX_notation_filter]]
[[en:TeX_notation_filter]]
[[es:Filtro_de_notación_TeX]]

Aktuelle Version vom 8. März 2019, 06:05 Uhr

Der TeX-Filter konvertiert TeX-Code in GIF-Grafiken. Er benutzt dafür Mimetex. Für Linux (glib2.3), Windows und Max OS X bringt die Moodle Distribution bereits passende Binärprogramme mit.


Filter nutzen

Intern kann der Filter zwei verschiedene Methoden verwenden, um mathematische Ausdrücke in GIF-Grafiken umzuwandeln. Bei der ersten (bevorzugten) Methode benötigen Sie drei Binärdateien (latex, dvips und convert), die Sie auf Ihrem Moodle-Server installieren und konfigurieren müssen (manche Web-Hoster übernehmen diesen Service). Die Filtereinstellungen, die weiter unten beschrieben werden, beziehen sich alle auf diese Methode.

Wenn diese Methode nicht funktioniert, wendet der Filter automatisch die zweite Methode an, bei der nur eine Binärdatei Mimetex (im Verzeichnis /moodle/filters/tex)benötigt wird. Diese Datei ist für die meisten Betriebssysteme im Standardpaket von Moodle enthalten.

Bevor Sie den Filter verwenden können, müssen Sie ihn als Administrator/in über den Menupunkt Website-Administration (oder im Block Einstellungen > Website-Administration) > Plugins > Filter > Übersicht aktivieren. Wenn Sie darüber hinaus den Algebra-Filter (eine Art "Frontend" für den TeX-Filter) nutzen wollen, aktivieren Sie diesen gleich mit.

Sobald der Filter aktiviert und konfiguriert ist, können Sie ihn für die Darstellung mathematischer Ausdrücke verwenden. Der Ausdruck muss in doppelte Doller-Zeichen eingeschlossen werden und in LaTeX-Syntax geschreiben sein.

Beispiel: 

   $$ \sqrt{ x + y } $$

MimeTeX

Moodle kann eine spezielle MimeTeX Binärdatei (zu finden im Verzeichnis moodle/filters/tex) verwenden, wenn der Zugriff auf die Binärdateien von dvips, convert und latex, die zusätzlich auf dem Moodle-Server installiert sind, nicht funktioniert (oder die Dateien gar nicht installiert wurden).

Moodle kommt mit verschiedenen Versionen dieser MimeTeX Binärdatei - für verschiedene Betriebssysteme. Der TeX-Filter greift auf die Binärdatei zu, die zum Betriebssystem Ihres Moodle-Servers passt. (Sollte für Ihr Betriebssystem keine Binärdatei vorhanden sein, dann müssen Sie das Skript entsprechend anpassen.)

Beachten Sie, dass Ihr Webserver so konfiguriert sein muss, dass er Binärdateien in diesem Verzeichnis ausführen darf.

Es gibt ein MimeTeX Handbuch. Dieses richtet sich jedoch an System-Administrator/innen mit gewisser Erfahrung und ist nicht speziell auf Moodle ausgerichtet.

Sie sollten auf diese Binärdateien nur im Notfall zurückgreifen, d.h. wenn trifftige Gründe gegen eine separate LaTeX-Installation auf dem Moodle-Server (außerhalb von Moodle) sprechen.

Kompatibiltät mit MathJax

In Moodle 2.8 können die TeX-Notation und der MathJax-Filter in Kombination verwendet werden. Wenn auf einer Moodle-Seite beide Filter aktiviert sind, werden Bilder erst mit Hilfe des TeX-Filters dargestellt und anschließend werden die TeX-Ausdrücke durch die MathJax-Darstellung ersetzt. Das geschieht mit einer kleinen Verzögerung.

Wir empfehlen Trainer/innen, nur einen der beiden Filter zu aktivieren.

Systemweite Einstellungen

Als Admnistrator/in können Sie über den Menupunkt Website-Administration (oder im Block Einstellungen > Website-Administration) > Plugins > Filter > TeX-Notation folgende Einstellungen vornehmen:

LaTeX Präambel
Hier können Sie LaTeX Präambel angeben. Die Standard-Einstellung sollte für die meisten Nutzer/innen ausreichen, aber Sie müssen diese Einstellung evtl. ändern, um Non-Latin-Zeichensätze usw. zu unterstützen. Konsultieren Sie die LaTeX-Dokumentation für weitere Informatioen.
Hintergrundfarbe
Wählen Sie hier die Hintergrundfarbe für die generierte Grafik. Sie sollte mit der Hintergrundfarbe Ihrer Moodle-Site übereinstimmen. Die Standard-Einstellung ist #FFFFFF (d.h. weiß).
Dichte/Empfindlichkeit
Diese Einstellung wirkt sich auf die Größe der resultierenden Grafik aus.
Pfad zum latex Binary
Pfad zum Standard-LaTeX-Binärprogramm. Auf Unix-Systemen ist das normalerweise /usr/bin/latex, unter MacOS X - /usr/texbin/, unter Windows und Verwendung von MiKTeX - C:\texmf\miktex\bin\latex.exe.
Pfad zum dvips Binary
Pfad zum Standard dvips Binary - wird generell als Teil des LaTeX-Systems mitgeliefert. Auf Unix-Systemen ist das normalerweise /usr/bin/dvips, unter MacOS X - /usr/texbin/, unter Windows - C:\texmf\miktex\bin\dvips.exe.
Pfad zum convert Binary
Pfad zum Standard convert Binärprogramm. Dieses Programm ist Bestandteil des Ghostscript-Systems oder von ImageMagick unter Windows. Auf Unix-Systemen ist das normalerweise /usr/bin/convert, unter MacOS X - /usr/local/bin, unter Windows - C:\Program Files\ImageMagick\convert.exe (für ImageMagick).

Filter debuggen

Der TeX-Filter hat ein Script zum Debuggen (schalten Sie dazu den Debug-Modus von Moodle auf der Seite Website-Administration (oder im Block Einstellungen > Website-Administration) > Entwicklung > Debugging ein). Das Skript können Sie verwenden, wenn Sie Probleme mit dem Filter haben. Rufen Sie dazu die URL http://your.moodle.path/filter/tex/texdebug.php im Brwoser auf.

Siehe auch:

  • TeX Filter Glossar - ein Glossar zum Download, das die TeX-Notation erklärt und in einem Moodle-Kurs bereitgestellt werden kann.
  • LaTeX
  • ghostscript - ein Programm, das zur Erzeugung der Grafiken benötigt wird
  • MimeTeX Manual - TeX-Notation Manual
  • MikTeX - LaTeX für Windows Systeme
  • ImageMagick - ein Programm, das zur Erzeugung der Grafiken benötigt wird (läuft unter Windows)
Abgerufen von „https://docs.moodle.org/37/de/index.php?title=TeX-Notation&oldid=17913“
Powered by MediaWiki