Ticket #9725: sagetex.rst

File sagetex.rst, 4.5 KB (added by mardaus, 9 years ago)
Line 
1**************
2SageTeX nutzen
3**************
4
5Das SageTeX Paket ermöglicht es Ihnen die Ergebnisse von Sage Berechnungen
6direkt in ein LaTeX Dokument zu setzen. Es wird standardmäßig mit Sage
7installiert. Um es zu nutzen, müssen Sie es lediglich in Ihrem lokalen
8TeX System "installieren", wobei "installieren" hier eine einzige Datei
9kopieren bedeutet. Siehe hierfür auch :ref:`installation` in diesem
10Tutorial und den Abschnitt "Make SageTeX known to TeX" des `Sage installation guide
11<http://sagemath.org/doc/installation/index.html>`_ (`dieser Link
12<../installation/index.html>`_ sollte Sie zu einer lokalen Kopie der
13Installationsanleitung führen) für mehr Informationen wie das geht.
14
15Hier stellen wir ein sehr kurzes Beispiel vor wie man SageTeX nutzt.
16Die komplette Dokumentation finden Sie unter ``SAGE_ROOT/local/share/texmf/tex/generic/sagetex``,
17wobei ``SAGE_ROOT`` das Installationsverzeichnis von Sage ist. Dieses Verzeichnis
18enthält die Dokumentation, eine Beispieldatei und einige nützliche Python Skripte.
19
20Um zu sehen wie SageTeX funktioniert, folgen Sie den Anweisungen zur Installation von
21SageTeX (in :ref:`installation`) und kopieren Sie den folgenden Text in eine Datei namens -
22sagen wir ``st_example.tex``:
23
24.. warning::
25
26  Der folgende Text wird mehrere Fehler bezüglich unbekannten Kontrollsequenzen
27  anzeigen, wenn Sie ihn in der "live" Hilfe ansehen. Nutzen Sie stattdessen
28  die statische Version um den korrekten Text zu sehen.
29
30.. code-block:: latex
31
32    \documentclass{article}
33    \usepackage{sagetex}
34
35    \begin{document}
36
37    Wenn Sie Sage\TeX nutzen, können Sie Sage nutzen um Dinge auszurechen und
38    sie direkt in ein \LaTeX{} Dokument zu setzen. Zum Beispiel gibt es
39    $\sage{number_of_partitions(1269)}$ ganzzahlige Partitionen von $1269$.
40    Sie müssen die Zahl nicht selbst ausrechnen, oder aus einem anderen
41    Programm herauskopieren.
42
43    Hier ein wenig Sage Code:
44
45    \begin{sageblock}
46        f(x) = exp(x) * sin(2*x)
47    \end{sageblock}
48
49    Die zweite Ableitung von $f$ ist
50
51    \[
52      \frac{\mathrm{d}^{2}}{\mathrm{d}x^{2}} \sage{f(x)} =
53      \sage{diff(f, x, 2)(x)}.
54    \]
55
56    Hier ein Plot von $f$ von $-1$ bis $1$:
57
58    \sageplot{plot(f, -1, 1)}
59
60    \end{document}
61
62Lassen Sie LaTeX ganz normal über ``st_example.tex`` laufen. Beachten Sie dabei, dass LaTeX
63sich über einige Dinge beschwert, z.B.::
64
65    Package sagetex Warning: Graphics file
66    sage-plots-for-st_example.tex/plot-0.eps on page 1 does not exist. Plot
67    command is on input line 25.
68
69    Package sagetex Warning: There were undefined Sage formulas and/or
70    plots. Run Sage on st_example.sage, and then run LaTeX on
71    st_example.tex again.
72
73Beachten Sie, dass zusätzlich zu den Dateien, die LaTeX normalerweise produziert
74noch eine Datei ``st_example.sage`` erscheint. Das ist das Sage Skript, das
75erstellt wurde als Sie LaTeX mit ``st_example.tex`` aufgerufen haben. Wie Ihnen die
76Warnmeldung mitteilte sollten Sie Sage über die Datei ``st_example.sage`` laufen lassen,
77also tun Sie das bitte. Ihnen wird gesagt werden, dass Sie LaTeX erneut über die Datei
78``st_example.tex`` laufen lassen sollen; bevor Sie dies tun beachten Sie, dass eine neue
79Datei namens ``st_example.sout`` von Sage erstellt wurde. Diese Datei enthält die Ergebnisse
80von Sages Berechnungen in einem Format, das LaTeX nutzen kann um es in Ihren Text einzufügen.
81Ein neues Verzeichnis mit einer .eps Datei Ihres Plots wurde ebenfalls erstellt.
82Lassen Sie LaTeX nun erneut laufen, und Sie werden sehen, dass alles was Sage berechnet und
83geplottet hat nun in Ihrem Dokument ist.
84
85Die verschiednenen verwendeten Makros sollten einfach zu verstehen sein.
86Eine ``sageblock`` Umgebung setzt Ihren Code unverändert und führt ihn auch
87aus wenn Sie Sage laufen lassen. Wenn Sie etwa ``\sage{foo}`` schreiben, wird
88das Ergebnis des Aufrufs ``latex(foo)`` (in Sage) in Ihrem Dokument erscheinen.
89Plot-Befehle sind etwas komplizierter, aber in Ihrer einfachsten Form fügt
90``\sageplot{foo}`` das Bild ein, das Sie erhalten wenn Sie ``foo.save('filename.eps')``
91in Sage aufrufen würden.
92
93Grundsätzlich gilt:
94
95    - lassen Sie LaTeX über Ihre .tex Datei laufen;
96    - lassen Sie Sage über die neu generierte .sage Datei laufen;
97    - lassen Sie LaTeX erneut laufen.
98
99Sie können das Aufrufen von Sage weglassen, wenn Sie keine Änderung
100an den Sage Befehlen in Ihrem Dokument vorgenommen haben.
101
102Es gibt noch viel mehr über SageTeX zu sagen, aber da sowohl Sage alsauch
103LaTeX komplexe und mächtige Werkzeuge sind, sollten Sie die Dokumentation
104über SageTeX in ``SAGE_ROOT/local/share/texmf/tex/generic/sagetex`` lesen.