Ticket #8660: trac_8660-installation-de_reviewer.patch

File trac_8660-installation-de_reviewer.patch, 50.3 KB (added by SimonKing, 10 years ago)

Reviewer patch, to apply after trac_8660-installation-de.patch

  • doc/de/installation/binary.rst

    # HG changeset patch
    # User Simon King <simon.king@nuigalway.ie>
    # Date 1271591686 -3600
    # Node ID 51ac1623eddcc851b1ba848148098f6279b5649a
    # Parent  e035d0951f4b0f7bfa9ac8953481feb3899a06b1
    Reviewer's patch for German documentation
    
    diff -r e035d0951f4b -r 51ac1623eddc doc/de/installation/binary.rst
    a b  
    3434ebenso die Datei „sage“ des Verzeichnisses in ein beliebiges
    3535Verzeichnis kopieren, z. B. nach ``/usr/local/bin/``. In diesem Fall
    3636müssen Sie jedoch anschließend den obersten Eintrag ``SAGE_ROOT="....."``
    37 editieren und die Punkte durch das Sage-Verzeichnis
     37bearbeiten und die Punkte durch das Sage-Verzeichnis
    3838sage-x.y.z-x86_64-Linux ersetzen. Wenn der Eintrag ``/usr/local/bin/``
    3939sich im Pfad Ihres Rechners befindet., können Sie Sage von überall
    4040durch einfache Eingabe von „sage“ in einer Eingabezeile starten. Ein
     
    4343
    4444    ln -s /.../path_to/.../sage-x.y.z-x86_64-Linux /usr/local/share/sage
    4545
    46 Ergänzen Sie dann $PATH mit/usr/local/share/sage. Danach können Sie
     46Ergänzen Sie dann ``$PATH`` mit ``/usr/local/share/sage``. Danach können Sie
    4747ebenfalls Sage durch die Eingabe von „sage“ in einer Eingabezeile
    4848starten. Wenn Sie eine andere oder eine neue Version von Sage
    4949installieren, müssen Sie den alten Link löschen und einen neuen
    5050erstellen, der auf das Verzeichnis ``/usr/local/share/sage`` zeigt.
    5151
    52 Schlussendlich können Sie auch diese zwei Ansätze verbinden, sage nach
     52Außerdem können Sie diese zwei Ansätze auch verbinden, indem Sie sage nach
    5353``/usr/local/bin/`` kopieren, einen Link von sage-x.y.z-x86_64-Linux zu
    5454``/usr/local/share/sage`` erstellen und die Zeile der Datei
    5555``/usr/local/bin/sage``::
     
    7373    (please wait at most a few minutes)...
    7474    Do not interrupt this.
    7575
    76 Die aktuelle Distribution enthält .dmg-Dateien für OS X 10.4.x und
    77 10.5.x. Aber Sage soll eine eigenständige Anwendung werden (native
    78 application). Daran wird gearbeitet, Hilfe ist immer willkommen.
     76Das heißt, Sage bemerkt, dass sich Pfade geändert haben und benötigt
     77einige Minuten, sich entsprechend anzupassen - dieser Vorgang darf
     78nicht unterbrochen werden. Die aktuelle Distribution enthält .dmg-Dateien
     79für OS X 10.4.x und 10.5.x. Aber Sage soll eine eigenständige Anwendung
     80werden (native application). Daran wird gearbeitet, Hilfe ist immer
     81willkommen.
    7982
    8083
    8184Microsoft Windows
  • doc/de/installation/documentation.rst

    diff -r e035d0951f4b -r 51ac1623eddc doc/de/installation/documentation.rst
    a b  
    55
    66Die Dokumentation ist Teil von Sage, sie müssen die Dokumentation also
    77nicht unbedingt zusätzlich installieren. Die Dokumentation enthält
    8 eine Übung mit Anleitung, ein Handbuch für Entwickler, den „Developers
    9 Guide, und diese Installationsanleitung, den Installation Guide in
     8eine Übung mit Anleitung („Tutorial“), ein Handbuch für Entwickler
     9(„Developers Guide“), und diese Installationsanleitung („Installation Guide") in
    1010englischer Sprache. Das Tutorial enthält eine Übung mit Anleitung,
    1111eine „Guided Tour“ durch Sage und ist ein guter Beginn. Das
    12 Referenzhandbuch, „Reference Manual“ beschreibt, was Sage bietet und
     12Referenzhandbuch („Reference Manual“) beschreibt den Funktionsumfang von Sage und
    1313gibt Beispiele für die Nutzung.
    1414
    1515Um eine HTML- oder pdf-Version der Dokumentation zu erstellen,
    16 benutzen Sie den Sage-Befehl -docbuild {document} {format}. Der Befehl
    17 sage -docbuild reference html beispielsweise erstellt eine
    18 HTML-Version des Referenzhandbuchs; sage -docbuild -help zeigt ein
     16benutzen Sie den Befehl ``sage -docbuild {document} {format}`` auf der Kommandozeile.
     17Der Befehl ``sage -docbuild reference html`` beispielsweise erstellt eine
     18HTML-Version des Referenzhandbuchs; ``sage -docbuild -help`` zeigt eine
    1919Liste aller Optionen.
  • doc/de/installation/icon.rst

    diff -r e035d0951f4b -r 51ac1623eddc doc/de/installation/icon.rst
    a b  
    33Desktop-Startsymbol
    44===================
    55
    6 Diese Anleitung zeigt Ihnen, wie Sie unter KDE ein Startsymbol auf dem
    7 Desktop zum Starten Ihres Sage-Notebooks erstellen. Die Schritte zu
    8 einem Gnome-Desktopsymbol sind wohl ähnlich.
     6Diese Anleitung hilft Ihnen, ein KDE Desktop-Symbol zum Starten Ihres
     7Sage-Notebooks zu erstellen. Die Schritte zu einem Gnome-Desktopsymbol
     8sind vermutlich ähnlich.
    99
    10 #. Erstellen Sie eine Datei notebook.sage, die lediglich die Zeile::
     10#. Erstellen Sie eine Datei ``notebook.sage``, die lediglich eine Zeile
     11   enthält::
    1112
    1213      notebook(openviewer=True)
    1314
    1415#. Erstellen Sie in Ihrem Verzeichnis „Desktop“ eine Datei
    15    Sage-notebook.desktop mit dem folgenden Inhalt::
     16   ``Sage-notebook.desktop`` mit dem folgenden Inhalt::
    1617
    1718       [Desktop Entry]
    1819       Comment=
     
    3435       X-KDE-SubstituteUID=false
    3536       X-KDE-Username=
    3637
    37    Sie müssen in der Zeile Exec= den passenden Pfad zu Ihrer Datei
    38    notebook.sage eintragen.
     38   Sie müssen in der Zeile ``Exec=`` den passenden Pfad zu Ihrer Datei
     39   ``notebook.sage`` eintragen.
    3940
    4041#. Nach Rechtsklick auf das Sage-Notebook Desktopsymbol wählen Sie
    41    Eigenschaften, dann Anwendungen, erweiterte Optionen und dort „in
    42    Terminal ausführen“. Wenn Sie die Überschrift des Terminalfensters
    43    des xwindow anpassen wollen, fügen Sie zu den Terminaloptionen -T
    44    "sage notebook" hinzu.
     42   ``Eigenschaften``, dann ``Anwendungen``, ``erweiterte Optionen`` und
     43   dort ``in Terminal ausführen``. Wenn Sie die Überschrift des Terminalfensters
     44   des xwindow anpassen wollen, fügen Sie zu den Terminaloptionen
     45   ``-T "sage notebook"`` hinzu.
    4546
    46 Zum Verlassen des Notebooks drücken Sie zuerst (gleichzeitig) Strg+c
     47Zum Verlassen des Notebooks drücken Sie zuerst (gleichzeitig) ``Strg-c``
    4748im aktiven Terminalfenster, in dem Sage ausgeführt wird, und danach
    48 Strg+d um Sage im Terminal zu beenden und schließen Sie zuletzt den
     49``Strg-d`` um Sage im Terminal zu beenden und schließen Sie zuletzt den
    4950Browser oder den Browser-Tab, der das Sage-Notebook Server anzeigte.
    5051
    5152Für ein Bild Ihres Startsymbols nutzen Sie den Link zu „Sage art“:
  • doc/de/installation/introduction.rst

    diff -r e035d0951f4b -r 51ac1623eddc doc/de/installation/introduction.rst
    a b  
    3535  Sprache, mit der einfach C-Erweiterungen für Python geschrieben
    3636  werden können.
    3737
    38 * eclib: John Cremonas Programme für die Berechnung und das Rechnen
     38* eclib: John Cremonas Programme für die Enumeration von und das Rechnen
    3939  mit elliptischen Kurven, die über rationale Zahlen definiert sind.
    4040
    41 * ecm: Methode der elliptischen Kurven für die Faktorisierung von
    42   Integern
     41* ecm: ganzzahlige Faktorisierung mittels elliptischer Kurven
    4342
    4443* flint: schnelle Bibliothek für die Zahlentheorie
    4544
    4645* fortran: die Programmiersprache Fortran
    4746
    48 * GAP: Ein System für numerische diskrete Algebra
     47* GAP: Ein System für rechnergestützte diskrete Algebra
    4948
    50 * genus2reduction: Reduzierung der Information  mittels Kurven vom
     49* genus2reduction: Reduktionsinformation für Kurven vom
    5150  Geschlecht 2
    5251
    53 * gfan: Berechnung von Groebner-Fächern und Torus-Varianten
     52* gfan: Berechnung von Gröbner-Fächern und torischen Varietäten
    5453
    55 * ghmm: Modellbibliothek für versteckte Markov-Prozesse
     54* ghmm: Bibliothek für versteckte Markov-Modelle
    5655
    5756* givaro: eine C++ -Bibliothek für arithmetische und algebraische
    5857  Berechnungen
     
    6362* gsl: GNU Scientific Library ist eine numerische Bibliothek für C-
    6463  und C++-Programme
    6564
    66 * ipython: eine erweiterte Python-Shell für effiziente, interaktive
    67   Eingabe, eine Bibliothek zur Programmierung interaktiver Umgebung
     65* ipython: eine erweiterte Python-Shell für effiziente interaktive
     66  Eingabe, eine Bibliothek zur Programmierung interaktiver Umgebungen
    6867  basierend auf Python sowie ein System für verteilte und
    6968  parallelisierte Programmierung
    7069
     
    7372
    7473* jsmath: stellt Mathematik für HTML zur Verfügung
    7574
    76 * lapack: eine Bibliothek von Fortran 77 Subroutinen für die am
    77   häufigsten auftretenden Problemen der linearen Algebra
     75* lapack: eine Bibliothek von Fortran 77 Subroutinen zur Lösung der
     76  häufigsten Probleme der linearen Algebra
    7877
    79 * lcalc: Rubinsteins L-functions-Rechner
     78* lcalc: Rubinsteins Rechner für L-Funktionen
    8079
    8180* libfplll: enthält verschiedene Implementierungen für den Gleitkomma
    82   „LLL-Reduktionsalgorithmus“, der unterschiedliche Geschwindigkeits-
    83   und Zuverlässigkeitsverhältnisse bereitstellt
     81  „LLL-Reduktionsalgorithmus“, der unterschiedliche Verhältnisse von
     82  Geschwindigkeit und Zuverlässigkeit bereitstellt
    8483
    8584* libm4ri: Bibliothek für Matrizen-Multiplikation, -Reduktion und
    86   Inversion über GF(2)
     85  -Inversion über GF(2)
    8786
    8887* linbox: C++ Musterbibliothek für genaue, hochperformante Berechnung
    8988  der linearen Algebra
     
    110109* numpy: numerische lineare Algebra und andere numerische
    111110  Rechenverfahren für Python
    112111
    113 * palp: ein Paket zur Analyse von „Lattice Polytopes“
     112* palp: ein Paket zur Analyse von Gitterpolytopen
    114113
    115114* pari: PARI, Bibliothek für Zahlentheorie
    116115
    117116* pexpect: Python-Expect (für die Fernsteuerung anderer Systeme)
    118117
    119 * polybori: Stellt High-level-Datentypen für boolsche Polynomiale und
    120   Monomiale, Expotentialvektoren sowie für die zugrunde liegenden
    121   polynomiale Ringe und Untermengen der Potentialmenge der boolschen
     118* polybori: Stellt High-level-Datentypen für boolsche Polynome und
     119  Monome, Expotentenvektoren sowie für die zugrunde liegenden
     120  Polynomringe und Untermengen der Potenzmenge der boolschen
    122121  Variablen
    123122
    124123* pynac: eine modifizierte Version von GiNaC (eine C++ Bibliothek für
    125   symbolische mathematische Berechnungen) die die Abhängigkeit von
    126   Python von CLN eliminiert
     124  symbolische mathematische Berechnungen), die die Abhängigkeit von
     125  von CLN durch Python ersetzt
    127126
    128127* Python: Die Python-Programmiersprache
    129128
     
    134133
    135134* scipy: wissenschaftliches Tool für Python
    136135
    137 * singular: Polynomiale Berechnungen für die algebraische Geometrie
     136* singular: Polynom-Berechnungen für die algebraische Geometrie
    138137  u.s.w.
    139138
    140139* symmetrica: Routinen für Berechnungen im Bereich der
     
    153152
    154153* zlib: zlib-Kompressionsbibliothek
    155154
    156 * zn_poly: C-Bibliothek für polynomiale Arithmetik in Z/nZ[x]
     155* zn_poly: C-Bibliothek für Polynom-Arithmetik in Z/nZ[x]
    157156
    158157* ZODB: Zope-Objektdatenbank
  • doc/de/installation/quick-guide.rst

    diff -r e035d0951f4b -r 51ac1623eddc doc/de/installation/quick-guide.rst
    a b  
    1414* Wollen Sie eine Binär- oder Quellcode-Distribution? Selbst wenn Sie
    1515  entwickeln wollen, ist eine Binärdistribution von Sage geeignet. Die
    1616  Quellcode-Distribution ist hauptsächlich erforderlich, wenn Sie den
    17   Quellcode der Pakete analysieren wollen, die gewöhnlich als SPKs
     17  Quellcode der Pakete analysieren wollen, die gewöhnlich als SPKGs
    1818  bezeichnet werden.
    1919
    2020* Wenn verfügbar, wählen Sie die passende Binärdistribution von einem
     
    2424* Befolgen Sie die Anleitung für die Binärinstallation
    2525  (http://www.sagemath.org/doc/installation/binary.html), um eine
    2626  aktuelle vorkompilierte Version von Sage zu installieren. Die
    27   Anleitung für die Installation von der Quelle
     27  Anleitung für die Installation aus dem Quellcode
    2828  (http://www.sagemath.org/doc/installation/source.html) bietet
    2929  ausführlichere Informationen zur Kompilation von Sage aus dem
    3030  Quellcode.
  • doc/de/installation/sagetex.rst

    diff -r e035d0951f4b -r 51ac1623eddc doc/de/installation/sagetex.rst
    a b  
    11.. -*- coding: utf-8 -*-
    22
    3 SageTeX mit TeX bekannt machen
    4 ==============================
     3SageTeX: Sage in TeX benutzen
     4=============================
    55
    66Sage ist weitgehend autark, aber einige Teile bedürfen der Nacharbeit,
    77um optimal zu funktionieren.
     
    1111aber um SageTeX mit Ihren LaTeX-Dokumenten zu nutzen, müssen Sie
    1212SageTex Ihrer TeX-Installation bekannt machen.
    1313
    14 Dazu muss TeX Ihre Datei sagetex.sty finden, die sich im Verzeichnis
    15 SAGE_ROOT/local/share/texmf/tex/generic/sagetex/ befindet, wobei
    16 SAGE_ROOT der vollständige Pfad zu dem Verzeichnis ist, in dem Sie
    17 Sage kompiliert oder installiert haben. Wenn TeX die Datei sagetex.sty
    18 findet, dann arbeitet SageTeX korrekt. Es gibt mehrere Wege, das zu
    19 realisieren:
     14Dazu muss TeX Ihre Datei ``sagetex.sty`` finden, die sich im Verzeichnis
     15``SAGE_ROOT/local/share/texmf/tex/generic/sagetex/`` befindet, wobei
     16``SAGE_ROOT`` der vollständige Pfad zu dem Verzeichnis ist, in dem Sie
     17Sage kompiliert oder installiert haben. Wenn TeX die Datei ``sagetex.sty``
     18findet, dann kann SageTeX benutzt werden. Es gibt mehrere Wege, das zu
     19erreichen:
    2020
    21 - Der erste und einfachste Weg ist es, sagetex.sty in das gleiche
     21- Der erste und einfachste Weg ist es, ``sagetex.sty`` in das gleiche
    2222  Verzeichnis zu kopieren, in dem sich Ihr LaTeX-Dokument
    2323  befindet. Nachdem das aktuelle Verzeichnis immer durchsucht wird,
    2424  wenn Sie ein Dokument bearbeiten, funktioniert das immer.
    2525
    2626  Diese Lösung verursacht aber einige kleine Probleme. Das erste Problem
    27   sind mehrere unnötige Kopien von sagetex.sty verteilt über mehrere
     27  sind mehrere unnötige Kopien von ``sagetex.sty`` verteilt über mehrere
    2828  Verzeichnisse. Das zweite und ernsthaftere Problem ist, dass nach
    2929  einem Upgrade von Sage mit einer neuen Version von SageTeX der
    3030  Python-Code und der LaTeX-Code für SageTeX möglicherweise nicht mehr
    3131  zusammenarbeiten und Fehler verursachen.
    3232
    33 - Der zweite Weg ist die Nutzung der Variablen der
    34   TEXINPUTS-Umgebung. Wenn Sie eine bash-Shell nutzen, geht das so::
     33- Der zweite Weg ist die Nutzung der Umgebungsvariablen ``TEXINPUTS``.
     34  Wenn Sie eine bash-Shell nutzen, geht das so::
    3535
    3636      export TEXINPUTS="SAGE_ROOT/local/share/texmf//:"
    3737
    38   wobei SAGE_ROOT wieder der vollständige Pfad des Verzeichnisses
     38  wobei ``SAGE_ROOT`` wieder der vollständige Pfad des Verzeichnisses
    3939  Ihrer Sage-Installation ist. Beachten Sie bitte die Zeichen „//:“ am
    40   Ende der Zeile, diese sind sehr wichtig! Danach finden „TeX and
    41   friends“ die SageTeX-Style-Datei. Soll diese Änderung auf Dauer
    42   sein, dann können Sie die oben gezeigte Zeile in Ihre Datei .bashrc
     40  Ende der Zeile, diese sind wichtig. Danach finden „TeX und Konsorten“
     41  die SageTeX-Style-Datei. Soll diese Änderung dauerhaft
     42  sein, dann können Sie die oben gezeigte Zeile in Ihre Datei ``.bashrc``
    4343  einfügen. Wenn Sie eine andere Shell verwenden, müssen Sie
    44   gegebenenfalls die Befehlszeile anpassen so dass die
     44  gegebenenfalls die Befehlszeile so anpassen, dass die
    4545  Umgebungsvariable erkannt wird. Ziehen Sie gegebenenfalls das Manual
    4646  Ihrer Shell zu rate.
    4747
     
    5454  Verzeichnis erfolgt, dann müssen Sie den Eintrag zum neuen Wert von
    5555  SAGE_ROOT korrigieren.
    5656
    57 - Der dritte und beste Weg zur Verbindung von TeX und sagetex.sty ist
     57- Der dritte und beste Weg um TeX auf ``sagetex.sty`` hinzuweisen, ist
    5858  eine Kopie an geeigneter Stelle Ihres Home-Verzeichnisses. Die
    5959  meisten TeX-Distributionen durchsuchen das Home-Verzeichnis
    6060  automatisch nach Paketen. Um das passende Verzeichnis zu finden,
     
    6363      kpsewhich -var-value=TEXMFHOME
    6464
    6565  Danach wird ein Verzeichnis ausgegeben, das ähnlich wie
    66   /home/drake/texmf oder /Users/drake/Library/texmf lautet. Kopieren
    67   Sie Ihr tex-Verzeichnis von SAGE_ROOT/local/share/texmf/ in Ihr
    68   Home-texmf-Verzeichnis in einer Eingabezeile Ihrer Shell::
     66  ``/home/drake/texmf`` oder ``/Users/drake/Library/texmf`` lautet.
     67  Kopieren Sie Ihr tex-Verzeichnis von ``SAGE_ROOT/local/share/texmf/``
     68  in Ihr eigenes ``texmf``-Verzeichnis in einer Eingabezeile Ihrer Shell::
    6969
    7070      cp -R SAGE_ROOT/local/share/texmf/tex TEXMFHOME
    7171
    72   wobei SAGE_ROOT wieder wie gewöhnlich den Pfad Ihrer
    73   Sage-Installation bezeichnet und TEXMFHOME ist die von der Eingabe
    74   kpsewhich gelieferte Ausgabe (siehe oben).
     72  wobei ``SAGE_ROOT`` wie gehabt den Pfad Ihrer Sage-Installation bezeichnet
     73  und ``TEXMFHOME`` die vom Befehl ``kpsewhich`` gelieferte Ausgabe ist
     74  (siehe oben).
    7575
    7676  Wenn Sie Sage upgraden und SageTeX danach nicht mehr funktioniert,
    7777  wiederholen Sie die beschriebenen Schritte, so dass Sage und TeX
    7878  wieder synchronisiert werden.
    7979
     80.. _sagetex_installation_multiuser:
     81
    8082- Zur Installation auf einem Multiuser-System modifizieren Sie die
    81   oben beschriebenen Schritte und kopieren Sie sagetex.sty in ein
     83  oben beschriebenen Schritte und kopieren Sie ``sagetex.sty`` in ein
    8284  geeignetes systemweites TeX-Verzeichnis. Anstelle des Verzeichnisses
    83   TEXMFHOME ist die Nutzung des Ergebnisses von ::
     85  ``TEXMFHOME`` ist die Nutzung des Ergebnisses von
     86  ::
    8487
    8588      kpsewhich -var-value=TEXMFLOCAL
    8689
    8790  die bessere Wahl. Die Eingabe liefert ein Verzeichnis, etwa wie
    88   /usr/local/share/texmf. Kopieren Sie das tex-Verzeichnis wie oben in
    89   das Verzeichnis TEXMFLOCAL. Wenn Sie die TeX-Datenbasis
     91  ``/usr/local/share/texmf``. Kopieren Sie das tex-Verzeichnis wie oben in
     92  das Verzeichnis ``TEXMFLOCAL``. Wenn Sie die TeX-Datenbasis
    9093  aktualisieren müssen, können Sie das einfach durch Eingabe von ::
    9194
    9295      texhash TEXMFLOCAL
    9396
    94   als root ausführen und TEXMFLOCAL anpassen. Danach können alle
     97  als root ausführen und ``TEXMFLOCAL`` anpassen. Danach können alle
    9598  Nutzer Ihres Systems auf die LaTeX-Pakte zugreifen; wenn sie Sage
    9699  nutzen können, können sie ebenso SageTeX nutzen.
    97100
    98101.. WARNING::
    99102
    100   Es ist sehr wichtig, dass die Datei sagetex.sty, die LaTeX bei der
     103  Es ist sehr wichtig, dass die Datei ``sagetex.sty``, die LaTeX bei der
    101104  Texterstellung nutzt, mit der Version von SageTeX, die Sage nutzt,
    102105  zusammenpasst. Wenn Sie Sage aktualisieren, sollten Sie
    103106  sicherstellen, dass alle älteren, verstreuten Versionen von
    104   sagetex.sty gelöscht werden.
     107  ``sagetex.sty`` gelöscht werden.
    105108
    106   Wegen dieser Problematik wird dringend empfohlen, die SageTeX Dateien
    107   in das Verzeichnis texmf in Ihr Home-Verzeichnis (wie oben
     109  Wegen dieser Problematik wird dringend empfohlen, die SageTeX-Dateien
     110  in das Verzeichnis ``texmf`` in Ihr Home-Verzeichnis (wie oben
    108111  beschrieben) zu kopieren. Dann ist nach einem Upgrade lediglich ein
    109112  Verzeichnis zu kopieren und es ist sichergestellt, dass SageTeX
    110113  richtig arbeitet.
     
    114117---------------------
    115118
    116119SageTeX ist nicht grundsätzlicher Teil der Sage-Installation. Dennoch
    117 ist es der Erwähnung wert, dass sich die Dokumentation für SageTeX
    118 unter
    119 SAGE_ROOT/local/share/texmf/tex/generic/sagetex/sagetexpackage.pdf
    120 befindet. In diesem Verzeichnis ist ebenso eine Beispieldatei, siehe
    121 example.tex und example.pdf, das fertige Ergebnis der Bearbeitung
    122 dieser Datei mit LaTeX und Sage. Sie können diese Dateien von CTAN
    123 herunterladen:
     120ist es erwähnenswert, dass sich die Dokumentation für SageTeX
     121unter ``SAGE_ROOT/local/share/texmf/tex/generic/sagetex/sagetexpackage.pdf``
     122befindet. In diesem Verzeichnis ist auch eine Beispieldatei, siehe
     123``example.tex`` und ``example.pdf``, das fertige Ergebnis der Bearbeitung
     124dieser Datei mit LaTeX und Sage. Sie können diese Dateien von
     125:abbr:`CTAN (Comprehensive TeX Archive Network)` herunterladen:
    124126http://www.ctan.org/tex-archive/macros/latex/contrib/sagetex/.
    125127
    126128SageTeX wird zwar „offiziell“ mit Sage ausgeliefert, aber beachten
     
    131133SageTeX und TeXLive
    132134-------------------
    133135
    134 Verwirrend mag sein, dass TeX in der aktuellen Version von TeXLive
    135 2009 die Version SageTeX beinhaltet. Das klingt gut, aber für SageTeX
    136 ist es wichtig, dass die Sage-Teile und die LaTeX-Teile synchronisiert
    137 werden. Das ist das eigentliche Problem, weil sowohl Sage als auch
    138 SageTeX häufig aktualisiert werden, TeXLive hingegen nicht. Aktuell
    139 (Januar 2010) liefern viele Linux-Distributionen TeXLive 2007 aus.
     136Verwirrend mag sein, dass TeX in der aktuellen Version von `TeXLive
     1372009 <http://www.tug.org/texlive/>`_ auch SageTeX beinhaltet. Das klingt
     138gut, aber für SageTeX ist es wichtig, dass die Sage-Teile und die
     139LaTeX-Teile synchronisiert werden. Das kann problematisch sein,
     140weil sowohl Sage als auch SageTeX häufig aktualisiert werden, TeXLive
     141hingegen nicht. Aktuell (Januar 2010) liefern viele
     142Linux-Distributionen immer noch TeXLive 2007 aus.
    140143
    141 Deshalb ist es wichtig und empfehlenswert, LaTeX immer als Teil von
    142 SageTeX von Sage zu installieren, so wie das oben beschrieben ist. Die
     144Deshalb ist es wichtig und *sehr empfehlenswert*, den LaTeX-Teil von
     145SageTeX immer von Sage zu installieren, so wie das oben beschrieben ist. Die
    143146oben beschriebene Anleitung stellt sicher, dass die beiden Teile von
    144147SageTeX kompatibel sind, so dass diese problemlos
    145148zusammenarbeiten. Eine Nutzung von TeXLive für den LaTeX-Teil von
  • doc/de/installation/source.rst

    diff -r e035d0951f4b -r 51ac1623eddc doc/de/installation/source.rst
    a b  
    88Kompilierung erfüllt, ist der Prozess einfach. Ihr Computer wird eine
    99Weile beschäftigt sein, um Sage aus dem Quellcode zu kompilieren, aber
    1010Sie müssen das nicht überwachen. Wenn Sie Sage aus der Quelle
    11 compilieren, können Sie sicher sein,  die neueste Version von Sage zu
    12 haben, mit der Sie alle Bestandteile des Programms ändern können, von
    13 dem Sage abhängt. Sie können Sage auch rekompilieren.
     11kompilieren, können Sie sicher sein,  die neueste Version von Sage zu
     12haben, mit der Sie alle Bestandteile und alle Programme ändern können, von
     13denen Sage abhängt. Sie können Sage auch rekompilieren.
    1414
    1515Zum Zeitpunkt der Texterstellung für diese Anleitung (Install Guide
    1616v4.3.4, 2010) wird Sage auf Linux (32-bit x86, 64-bit x86-64, IA64
     
    1919neuesten Informationen.)
    2020
    2121    **Solaris? FreeBSD? OS X 10.5 im 64bit-Modus?**: Die vollständige
    22     Kompilation von Sage ist zum aktuellen Zeitpunkt nicht auf Solaris
    23     oder *BSD möglich. Der größte Teil von Sage kann auf Solaris
     22    Kompilation von Sage ist derzeit nicht auf Solaris oder BSD möglich.
     23    Der größte Teil von Sage kann auf Solaris
    2424    kompiliert werden und die weiteren Bestandteile können mit
    2525    Standardpaketen ergänzt werden; E-mailen Sie an sage-devel
    2626    http://groups.google.com/group/sage-devel, wenn Sie Sage auf
     
    3232    arbeitet an einem vollen „native port“ und die Zahl der Änderungen
    3333    ist im Vergleich zu anderen Ports relativ klein.
    3434
    35     Das Sage-Entwicklungsteam hofft, OS X 10.5 im 64-bit Mode für die
     35    Das Sage-Entwicklungsteam hofft, OS X 10.5 im 64-bit-Modus für die
    3636    nächste Sage-Version unterstützen zu können. Einige Informationen zum
    37     Kompilieren von Sage auf OS X 10.5 im 64-bit Mode finden Sie
     37    Kompilieren von Sage auf OS X 10.5 im 64-bit-Modus finden Sie
    3838    unter:
    3939    http://mvngu.wordpress.com/2009/09/02/compile-sage-4-1-in-64-bit-mode-on-os-x-10-5-8/
    4040
     
    5555    ranlib
    5656    tar
    5757    readline mit den „development headers“
    58     ssh-keygen – wird benötigt, um Notebooks im sicheren Mode zu benutzen
     58    ssh-keygen – wird benötigt, um Notebooks im sicheren Modus zu benutzen
    5959    latex wird empfohlen, ist aber nicht unbedingt erforderlich
    6060
    61 Um festzustellen, ob m4 installiert ist, geben Sie in der Eingabezeile
    62 „which m4“ ein. Wenn kein Antworttext (oder eine Fehlermeldung)
    63 erfolgt, dann ist m4 nicht installiert. Außerdem wird die Installation
     61Um festzustellen, ob ``m4`` installiert ist, geben Sie in der Eingabezeile
     62``which m4`` ein. Wenn kein Antworttext (oder eine Fehlermeldung)
     63erfolgt, dann ist ``m4`` nicht installiert. Außerdem wird die Installation
    6464von LaTeX sehr empfohlen, sie ist aber nicht unbedingt
    65 erforderlich. Wenn Sie ssh-keygen nicht installiert haben, können Sie
    66 Ihr Notebook nicht im sicheren Mode betreiben. Um Ihr Notebook im
    67 unsicheren Mode zu betreiben, starten Sie Ihr Notebook mit der Eingabe
    68 „notebook(secure=False)“ anstelle von „notebook()“.
     65erforderlich. Wenn Sie ``ssh-keygen`` nicht installiert haben, können Sie
     66Ihr Notebook nicht im sicheren Modus betreiben. Um Ihr Notebook im
     67unsicheren Modus zu betreiben, starten Sie Ihr Notebook mit der Eingabe
     68``notebook(secure=False)`` anstelle von ``notebook()``.
    6969
    7070Stellen Sie sicher, dass Sie unter OS X zumindest die Version 2.4 von
    71 Xcode haben, gcc -v sollte zumindest 5363 ausgeben. Ist dies nicht der
     71Xcode haben, ``gcc -v`` sollte zumindest 5363 ausgeben. Ist dies nicht der
    7272Fall, laden Sie von http://developer.apple.com/ nach der Registrierung
    7373das freie XCode-Paket herunter. Lediglich OS X `\geq 10.4` wird
    74 unterstützt. Damit haben Sie alle oben gegebenen Befehle zur
     74unterstützt. Damit stehen Ihnen alle oben genannten Befehle zur
    7575Verfügung.
    7676
    7777Bei einem Debian-basierten System (z. B. Ubuntu), ist ranlib im
    78 Package binutils inkludiert. Auf einem neu installierten Ubuntu-System
    79 (getestet mit Ubuntu 9.04), können Sie die oben gegebenen Befehle wie
     78Package binutils enthalten. Auf einem neu installierten Ubuntu-System
     79(getestet mit Ubuntu 9.04), können Sie die oben genannten Befehle wie
    8080folgt installieren::
    8181
    8282     sudo apt-get install build-essential m4 gfortran
     
    9595
    9696    sudo apt-get install texlive xpdf evince xdvi
    9797
    98 (Es muss die GNU-Version von make installiert sein. Beispielsweise
    99 erstellt   Sage kein Build auf FreeBSD, wenn keine GNU-Version von
    100 make (unter genau dem Namen make) installiert ist.
     98(Es muss die GNU-Version von ``make`` installiert sein. Beispielsweise
     99kann Sage auf FreeBSD nicht gebaut werden, wenn keine GNU-Version von
     100``make`` installiert ist und auch den Namen ``make`` trägt.
    101101
    102102Einige Teile von Sage sind in Python geschrieben, dennoch muss Python
    103103nicht auf Ihrem Computer vorinstalliert werden, weil die
     
    105105
    106106Bei der Ausführung des Installationsprogramms wird geprüft, ob alle
    107107oben aufgeführten benötigten Programme vorhanden sind und es erfolgt
    108 eine Meldung darüber, welche vermisst werden.
     108eine Meldung darüber, welche fehlen.
    109109
    110110-  Wenn Sie die Tcl/Tk-Bibliotheken in Sage nutzen wollen, bereiten
    111    Sie das vor, indem Sie die Tcl/Tk-Entwicklungsbibliothekens
     111   Sie das vor, indem Sie die Tcl/Tk-Entwicklungsbibliotheken
    112112   zusätzlich zu der Tck/Tk-Basisinstallation installieren. Das Python
    113113   von Sage erkennt Tcl/Tk automatisch, wenn es installiert ist.
    114114
     
    124124
    125125       sage -f python-2.5.2.p8    # or the latest version available
    126126
    127    Wenn danach die Befehle zur Installation keine
    128    ImportError-Fehlermeldung ausgeben, hat das funktioniert:
     127   Wenn danach das Importieren der Bibliotheken mit den Befehlen
    129128
    130129   .. skip
    131130
     
    134133       sage: import _tkinter
    135134       sage: import Tkinter
    136135
    137 -  Sage wird aktuell mit GCC Version 4.3.x entwickelt, kompiliert aber
    138    auch mit anderen GCC-Versionen der 4.x-Serie einwandfrei,
    139    kompiliert aber nicht mit älteren GCC-Versionen.
     136   ohne einen ``ImportError`` möglich ist, war die Installation erfolgreich.
    140137
    141    Sollten Sie an einer Version für Suns CC-Compiler interessiert sein,
     138-  Sage wird aktuell mit GCC Version 4.3.x entwickelt und kompiliert wahrscheinlich
     139   auch mit anderen GCC-Versionen der 4.x-Serie einwandfrei.
     140   Es funktioniert aber nicht mit älteren GCC-Versionen.
     141
     142   Sollten Sie an einer Version für Sun's CC-Compiler interessiert sein,
    142143   schicken Sie bitte eine E-Mail an die sage-devel mailing list, auch
    143144   bekannt als sage-devel Google group unter
    144145   http://groups.google.com/group/sage-devel
    145146
    146 Perl wird benötigt, weil die NTL- und PARI-Konfigurationsskripts in
     147``perl`` wird benötigt, weil die NTL- und PARI-Konfigurationsskripts in
    147148   Perl geschrieben sind.
    148149
    149 Nach dem Entpacken des Sage-Tarballs enthält das Unterverzeichnis spkg
     150Nach dem Entpacken des Sage-Tarballs enthält das Unterverzeichnis ``spkg``
    150151die Quellcodes für alles, was Sage benötigt. Die Entwickler legen Wert
    151152darauf, dass die gesamte benötigte Software in der Sage-Distribution
    152153enthalten ist, so dass Sie sich nicht selbst um Download und
     
    156157
    157158-  Kein Build mit gcc 4.3.0, die Behebung ist in Arbeit.
    158159
    159 -  Verschieben des Builds nach der Kompilation bricht die “PARI Galois
    160    fields database“, da die Pfade offensichtlich im PARI-Binary fix
     160-  Verschieben des Builds nach der Kompilation macht die „PARI Galois
     161   fields database“ unbrauchbar, da die Pfade offensichtlich im PARI-Binary fixiert
    161162   sind. PARI hat also eine starre, vorgegebene
    162    Verzeichnisstruktur. (Hilfe, das zu korrigieren ist erwünscht!)
     163   Verzeichnisstruktur. (Hilfe bei der Fehlerbehebung ist erwünscht!)
    163164
    164165
    165166Fortran
     
    177178    export SAGE_FORTRAN_LIB=/path/to/fortran/libs/libgfortran.so
    178179
    179180Beachten Sie, dass die Umgebungsvariable ``SAGE_FORTRAN`` lediglich das
    180 Fortran-Sage-Paket betrifft, das sonst als Fortran spkg bezeichnet
    181 wird. Darüber hinaus soll diese Variable andere spkgs nicht
    182 beeinflussen, die Fortran benutzen. Beispielsweise nutzt das Lapack
    183 spkg Fortran, aber der Kompilationsprozess von Lapack soll die
    184 Umgebungsvariable ``SAGE_FORTRAN`` ignorieren. Die
    185 ``SAGE_FORTRAN``-Umgebungsvariable bedeutet nicht: „Kompiliere alle spkg,
    186 die Fortran nutzen, mit diesem Fortran“. Vielmehr bedeutet sie: „Nutze
    187 das ``sage_fortran`` script der ``SAGE_FORTRAN``-Umgebungsvariablen,
    188 damit der Fortran-Compiler für die Installation des Fortran spkg
    189 genutzt wird“.
     181Fortran-Sage-Paket (Fortran spkg) betrifft. Es ist *nicht* Zweck dieser
     182Variable, den Bau anderer spkgs zu beeinflussen, selbst wenn diese Fortran
     183benutzen. Beispielsweise nutzt das Lapack spkg Fortran, aber der
     184Kompilationsprozess von Lapack soll die Umgebungsvariable ``SAGE_FORTRAN``
     185ignorieren. Die ``SAGE_FORTRAN``-Umgebungsvariable bedeutet also nicht:
     186„Kompiliere alle spkg, die Fortran nutzen, mit diesem Fortran“. Vielmehr
     187bedeutet sie: „Zur Installierung des Fortran spkg soll das
     188``sage_fortran``-Skript den in der ``SAGE_FORTRAN``-Umgebungsvariable
     189benannten Fortran-Compiler verwenden“.
    190190
    191 Auf Mac OS X benötigen Sie keinen Fortran-Compiler. Die
    192 Sage-Quellcodedistribution benötigt keinen Fortran-Compiler auf diesem
    193 System. Für Mac OS X wird die Sage-Quellcodedistribution mit einem
    194 Fortran-Compiler für Mac OS X ausgeliefert. Dieser Fortran-Compiler
    195 wird benutzt, selbst wenn Sie einen anderen Fortran-Compiler in der
     191Auf Mac OS X benötigen Sie keinen Fortran-Compiler, da die
     192Sage-Quellcodedistribution einen Fortran-Compiler für dieses
     193System enthält. Dieser Fortran-Compiler
     194wird benutzt, außer wenn Sie einen anderen Fortran-Compiler in der
    196195Umgebungsvariablen SAGE_FORTRAN definieren.
    197196
    198197Auf den Plattforman AIX, HP-UX und Solaris, für die sowohl 32- und
    199 64-bit Builds verfügbar sind, muss die Variable im Pfad zur Bibliothek
     19864-bit Builds verfügbar sind, muss die Pfadvariable
    200199``SAGE_FORTRAN_LIB`` auf die 32-bit-Bibliothek verweisen, wenn Sie Sage
    201 für 32-bit compilieren, und auf die 64-bit-Bibliothek, wenn Sie Sage
     200für 32-bit kompilieren, und auf die 64-bit-Bibliothek, wenn Sie Sage
    202201für 64-bit kompilieren. Unter Solaris können die Variablen
    203202``SAGE_FORTRAN`` und ``SAGE_FORTRAN_LIB`` beispielsweise wie folgt gesetzt
    204203werden (Sie sollten das prüfen)::
     
    219218    SAGE_FORTRAN_LIB=/path/to/gcc/install/directory/lib/amd64/libgfortran.so
    220219
    221220
    222 Schritte der Installation aus der Quelle
    223 ----------------------------------------
     221Installationsschritte aus der Quelle
     222------------------------------------
    224223
    225224Die Installation aus der Quelle ist (potentiell) sehr einfach, weil
    226 die Distribution essentiell alles enthält, was Sage benötigt.
     225die Distribution im Wesentlichen alles enthält, was Sage benötigt.
    227226
    228227Stellen Sie sicher, dass keine Leerzeichen in den Verzeichnisnamen
    229228sind, unter denen Sie kompilieren. Zwar wird der Start aus einem
    230229Verzeichnis mit Leerzeichen im Bezeichner unterstützt, dieser wird
    231 aber nicht empfohlen, da das Kompilieren aus einem solchen Verzeichnis
     230aber nicht empfohlen: Das Kompilieren unter einem solchen Verzeichnis
    232231ist nicht möglich, weil einige Komponenten nicht kompilieren, wenn
    233232sich Leerzeichen im Pfad befinden.
    234233
     
    240239   Download in einem Unterverzeichnis Ihres Heimatverzeichnisses,
    241240   in das Sie Sage installieren wollen. Beachten Sie, dass diese
    242241   Datei nicht komprimiert ist, es handelt sich um einen einfachen
    243    Tarball, (der allerdings voll mit komprimierten Dateien ist).
     242   Tarball, der allerdings voll mit komprimierten Dateien ist.
    244243
    245244#. Extrahieren Sie::
    246245
     
    255254   Das ist das Heimatverzeichnis von Sage, das als SAGE_ROOT oder als
    256255   „top level Sage directory“ bezeichnet wird.
    257256
    258 #. Optional (aber sehr empfohlen ): Lesen Sie die Datei ``README.txt``.
     257#. Optional (aber sehr empfohlen): Lesen Sie die Datei ``README.txt``.
    259258
    260259#. Geben Sie ein::
    261260
     
    263262
    264263   Damit werden Sage und alle Abhängigkeiten kompiliert. Sie sollen
    265264   und brauchen nicht als Administrator oder als Root eingeloggt sein,
    266    weil keine der Dateien außerhalb des Verzeichnisses sage-x.y.z
    267    verändert werden. [1] Diese Anweisung führt die üblichen Schritte
     265   weil keine der Dateien außerhalb des Verzeichnisses ``sage-x.y.z``
     266   verändert werden [1]_. Diese Anweisung führt die üblichen Schritte
    268267   für jedes Paket aus, legt aber alle Kompilate im lokalen
    269268   Build-Verzeichnisbaum ab. Das kann je nach Maschine bis zu einer
    270269   Stunde dauern. Abhängig von der Architektur des Systems (z. B.,
     
    275274
    276275.. [1]
    277276   Es gibt eine Ausnahme – das Verzeichnis .ipythonrc wird in Ihrem
    278    HOME-Verzeichnis erstellt, sofern es nicht vorhanden ist.
     277   ``HOME``-Verzeichnis erstellt, sofern es nicht vorhanden ist.
    279278
    280        Die Verzeichnisstruktur ist NICHT absolut kodiert. Es ist
    281        möglich, das Verzeichnis zu verschieben oder
     279       Das Verzeichnis, in dem Sage gebaut wurde, ist NICHT absolut
     280       kodiert. Es sollte möglich sein, das Verzeichnis zu verschieben oder
    282281       umzubenennen. (Wenn das nicht funktioniert, ist das ein Fehler
    283        – unglücklicherweise existiert ein Fehler, der bisher nicht
    284        behoben ist und der PARI betrifft, das den Ort der Dateien
    285        “galois data” festschreibt. Korrektur ist erwünscht!)
     282       – unglücklicherweise gibt es einen Fehler, der bisher nicht
     283       behoben wurde und der PARI betrifft, das den Ort der Dateien
     284       “galois data” absolut kodiert. Fehlerbehebung ist erwünscht!)
    286285
    287286   Nachdem Sage kompiliert wurde, können Sie die gesamte installierte
    288    Verzeichnisstruktur zu ``/usr/local`` kopieren. Sie können ebenso
    289    ``sage-*/sage`` script zu ``/usr/local/bin/`` kopieren und
    290    ``ROOT="....."`` am Beginn dieser Datei editieren.
     287   Verzeichnisstruktur nach ``/usr/local`` kopieren. Sie können ebenso
     288   das ``sage-*/sage``-Skript nach ``/usr/local/bin/`` kopieren und
     289   die Zeile ``ROOT="....."`` am Beginn dieser Datei bearbeiten.
    291290
    292291#. Um Sage zu starten, wechseln Sie in das Sage-Verzeichnis und geben
    293292   Sie ein::
     
    306305
    307306   Wenn Sage erfolgreich startet, heißt das, dass die meisten der
    308307   Komponenten erfolgreich kompiliert wurden. Wenn das Sage-Prompt
    309    aber nicht erscheint (und Sie eine ausführliche Fehlermeldung, ein
     308   aber nicht erscheint (und Sie zum Beispiel eine lange Fehlermeldung, ein
    310309   „traceback“, erhalten), berichten Sie bitte das Problem z. B. an
    311    http://groups.google.com/group/sage-support und fügen Sie Ihrer
    312    E-Mail bitte die Datei install.log bei. Hilfreich ist außerdem die
    313    Mitteilung des Betriebssystems und die Versionsnummer (und das
    314    Datum) der Sage-Kopie, die Sie nutzen. (Es gibt keine bestimmte
    315    Form für Fehlerberichte – senden Sie, wir schätzen jeden Bericht.)
     310   http://groups.google.com/group/sage-support und stellen Sie die
     311   Datei ``install.log`` zum Download (aber bitte nicht als E-Mail-Anhang)
     312   zur Verfügung. Hilfreich ist außerdem, das Betriebssystem sowie die
     313   Versionsnummer und das Datum der benutzen Sage-Kopie zu nennen.
     314   (Es gibt keine bestimmte Form für Fehlerberichte – schreiben Sie einfach,
     315   wir schätzen jeden Bericht.)
    316316
    317317   Versuchen Sie nach dem Start eine Eingabe::
    318318
     
    322322   Versuchen Sie etwas kompliziertere Eingaben, etwa eine, die die
    323323   PARI C-Bibliothek benutzt::
    324324
    325        sage: factor(2005)
    326        5 * 401
     325       sage: factor(2010)
     326       2 * 3 * 5 * 67
    327327
    328328   Prüfen Sie, ob die Schnittstellen zu Gap, Singular, Maxima and
    329329   PARI/GP funktionieren::
     
    345345   gp-Anweisung erzeugt ein Objekt im GP-Interpreter und eine
    346346   pari-Anweisung ein Objekt in der PARI C-Bibliothek.)
    347347
    348    Versuchen Sie GAP, Singular oder GAP aus Sage:
     348   Starten Sie GAP, Singular oder GAP in Sage:
    349349
    350350   .. skip
    351351
    352352   ::
    353353
    354354       sage: gap_console()
    355        GAP4, Version: 4.4.6 of 02-Sep-2005, x86_64-unknown-linux-gnu-gcc
     355       GAP4, Version: 4.4.12 of 17-Dec-2008, x86_64-unknown-linux-gnu-gcc
    356356       gap> 2+2;
    357357       4
    358358       [Strg+d]
     
    365365       ...
    366366       [Strg+d]
    367367
    368    Siehe Original der Formatierung
    369    http://www.sagemath.org/doc/installation/source.html#steps-to-install-from-source
    370 
    371368   .. skip
    372369
    373370   ::
    374371
    375372       sage: singular_console()
    376373                            SINGULAR                             /  Development
    377         A Computer Algebra System for Polynomial Computations   /   version 3-0-1
     374        A Computer Algebra System for Polynomial Computations   /   version 3-1-0
    378375                                                              0<
    379             by: G.-M. Greuel, G. Pfister, H. Schoenemann        \   October 2005
     376            by: G.-M. Greuel, G. Pfister, H. Schoenemann        \   Mar 2009
    380377       FB Mathematik der Universitaet, D-67653 Kaiserslautern    \
    381        // ** executing /usr/local/sage/sage-0.8.2/bin/LIB/.singularrc
    382378       [ctrl-d]
    383379       > Auf Wiedersehen.
    384380       sage:
    385381
    386382#. Optional: Prüfen Sie die Schnittstelle zu jeder in Sage nicht
    387    enthaltenen Software, die Sie verfügbar haben. Beachten Sie, dass
    388    jeder Aufruf eines externen Programms einen speziellen Namen hat:
    389    Mathematica wird mit math, Maple mit maple usw. aufgerufen. Der
    390    einfachste Weg, diesen Namen zu ändern oder eine andere Anpassung
    391    vorzunehmen, ist die Erstellung eines Umleitungsskripts in
    392    ``SAGE_ROOT/local/bin``. Sage schreibt dieses Verzeichnis an die erste
    393    Stelle der Pfadangabe Ihres Rechners, sodass Ihr Skript absolute
    394    Pfade nutzen muss, um einen Aufruf auf sich selbst zu
    395    vermeiden. Außerdem muss Ihr Skript $* nutzen, um alle Argumente zu
    396    übergeben. Ein Maple-Skript kann wie folgt aussehen::
     383   enthaltenen Software, über die Sie verfügen. Beachten Sie, dass
     384   jede Schnittstelle das betreffende externe Programm unter einem
     385   speziellen Namen aufruft: Mathematica wird mit ``math`` aufgerufen,
     386   Maple mit ``maple`` usw. Der einfachste Weg, nötigenfalls diesen Namen
     387   zu ändern oder eine andere Anpassung vorzunehmen, ist die Erstellung eines
     388   Umleitungsskripts in ``SAGE_ROOT/local/bin``. Sage schreibt dieses
     389   Verzeichnis an die erste Stelle der Pfadangabe Ihres Rechners. Ihr
     390   Skript muss daher absolute Pfade nutzen, um einen Aufruf auf sich selbst
     391   zu vermeiden. Außerdem muss Ihr Skript ``$*`` nutzen, um alle Argumente zu
     392   übergeben. Ein ``maple``-Skript könnte wie folgt aussehen::
    397393
    398394       #!/bin/sh
    399395
    400396       /etc/maple10.2/maple.tty $*
    401397
    402 #. Optional: Verschiedene Möglichkeiten, um Sage leichter handhabbar
    403    zu machen:
     398#. Optional: Verschiedene Möglichkeiten, die Nutzung von Sage etwas zu erleichtern:
    404399
    405400   -  Kopieren Sie ``SAGE_ROOT/sage`` in den Pfad Ihrer Maschine. Wenn
    406       Sie dies tun, müssen Sie auch die Zeile mit den Punkten (....) im
    407       oberen Teil des Skripts editieren.
     401      Sie dies tun, müssen Sie auch die Zeile mit den Punkten (``....``)
     402      am Anfang des Skripts bearbeiten.
    408403
    409    -  KDE-Nutzer müssen ein bash-Skript, z. B. Mit dem Namen „sage“
    410       mit den folgenen Zeilen erstellen::
     404   -  KDE-Nutzer können ein bash-Skript namens ``sage`` mit folgendem
     405      Inhalt erstellen::
    411406
    412407          #!/bin/bash
    413408          konsole -T "sage" -e <SAGE_ROOT>/sage
    414409
    415410      Nachdem Sie dieses ausführbar gemacht haben (``chmod a+x sage``),
    416411      setzen Sie es in Ihren Pfad. (Beachten Sie, dass Sie ``SAGE_ROOT``
    417       ändern müssen!) Sie können aber auch ein KDE-Startsymbol auf
     412      wie oben ändern müssen!) Sie können aber auch ein KDE-Startsymbol auf
    418413      Ihrem Desktop mit dieser Anweisung versehen. Klicken Sie dazu
    419414      mit der rechten Maustaste auf das Symbol, wählen Sie
    420415      Einstellungen und tragen Sie im geeigneten Feld den Startbefehl ein.
    421416
    422    -  Nutzer der bash-Shell geben „echo $PATH“ in die Eingabezeile ein
    423       und kopieren den sage-Pfad mit „cp sage <your-path-dir>“ in
    424       eines der Verzeichnisse oder fügen dieses Binärverzeichnis der
    425       PATH-Variablen hinzu. Wenn Sie die bash-Shell nutzen, fügen Sie
    426       z. B. die folgenden Zeilen Ihrer Datei „.bashrc“ hinzu (sofern
     417   -  Nutzer der bash-Shell geben ``echo $PATH`` in die Eingabezeile ein
     418      und kopieren den sage-Pfad mit ``cp sage <your-path-dir>`` in
     419      eines der Verzeichnisse oder fügen das Sage-Binärverzeichnis der
     420      ``PATH``-Variablen hinzu. Wenn Sie die bash-Shell nutzen, fügen Sie
     421      z. B. die folgenden Zeilen Ihrer Datei ``.bashrc`` hinzu (sofern
    427422      diese existiert; wenn nicht, erstellen Sie die Datei)::
    428423
    429424          PATH="<sage-home-dir>/bin":$PATH
    430425          export PATH
    431426
    432427      Danach loggen Sie sich aus und wieder ein, damit die Änderung
    433       aktiv wird. Geben Sie dann „sage“ in der Eingabezeile Ihrer
     428      aktiv wird. Geben Sie dann ``sage`` in der Eingabezeile Ihrer
    434429      Konsole ein und Sage sollte starten.
    435430
    436431   - Unter Linux und OS X können Sie ein „Alias“ zu $SAGE_ROOT/sage
    437432     erstellen. Z. B. fügen Sie etwa eine Zeile wie die folgende in
    438      Ihre Datei .bashrc::
     433     Ihre Datei ``.bashrc``::
    439434
    440435         alias 'sage'='/home/username/sage-3.1.2/sage'
    441436
    442437     Danach schließen Sie Ihr Terminal und starten es neu. Geben Sie
    443      dann „sage“ in der Eingabezeile Ihrer Konsole ein. Sage sollte
     438     dann ``sage`` in der Eingabezeile Ihrer Konsole ein. Sage sollte
    444439     nun starten.
    445440
    446 #. Optional: Testen Sie die Installation mit der Eingabe ./sage
    447    -testall in der Eingabezeile. Damit werden die meisten Beispiele im
     441#. Optional: Testen Sie die Installation mit der Eingabe ``./sage
     442   -testall`` in der Eingabezeile. Damit werden die meisten Beispiele im
    448443   Quellcode ausgeführt und es wird sichergestellt, dass diese so wie
    449444   erwartet ausgeführt werden. Um alle Beispiele auszuführen, nutzen Sie
    450    „./sage -testall -optional -long“: Damit werden alle Beispiele
     445   ``./sage -testall -optional -long``: Damit werden alle Beispiele
    451446   ausgeführt und auch die Beispiele, die von optionalen Paketen und
    452447   Software abhängen, wie z. B. Mathematica oder Magma. Dies dauert
    453448   etwas länger. Die Ausführung einiger (optionaler) Beispiele wird
    454449   möglicherweise scheitern, weil sie voraussetzen, dass eine Datenbank
    455450   installiert ist. Alternativ können Sie im Sage-Rootverzeichnis
    456    ($SAGE_ROOT) „make test“ eingeben, um alle Standardtests
     451   (``$SAGE_ROOT``) ``make test`` eingeben, um alle Standardtests
    457452   auszuführen. Das kann zwischen etwa 30 Minuten und einer Stunde oder
    458453   länger dauern.
    459454
    460 #. Optional: Das Verzeichnis „spkg/build“ enthält „intermediate code“,
    461    der benutzt wird, um Sage lauffähig zu erstellen. Geben Sie „make
    462    clean ein, um diesen und einige überflüssige Verzeichnisse zu
     455#. Optional: Das Verzeichnis ``spkg/build`` enthält „intermediate code“,
     456   der benutzt wurde, um Sage lauffähig zu erstellen. Geben Sie ``make
     457   clean`` ein, um diesen und einige überflüssige Verzeichnisse zu
    463458   entfernen (z. B. spkg/archive und devel/old). Das ist ein sicherer
    464459   Prozess und spart bis zu 500 MB Plattenspeicher ein. Es ist
    465460   vorteilhaft, das regelmäßig zu tun.
    466461
    467462#. Optional: Installieren Sie optionale Sage-Pakete und
    468    Datenbanken. Geben Sie in die Eingabe „sage -optional“ ein, um eine
    469    Liste zu erhalten, oder laden Sie
    470    http://www.sagemath.org/packages/optional/ und „sage -i <package
    471    name>“ zum automatischen Download und zur Installation eines
    472    bestimmten Pakets.
     463   Datenbanken. Geben Sie in die Eingabe ``sage -optional`` ein oder besuchen
     464   Sie http://www.sagemath.org/packages/optional/, um eine Liste der Pakete
     465   zu erhalten. Ein optionales Paket wird mit ``sage -i <package
     466   name>`` automatisch heruntergeladen und installiert. Alternativ können
     467   Sie nach dem Starten von Sage ein Paket mit dem Befehl
     468   ``install_package(<initial segment of package name>)`` installieren.
    473469
    474 #. Optional: Führen Sie die Anweisung „install_scripts“ innerhalb von
    475    Sage aus, um die gp-, singular-, gap-Skripts und weitere Skripts in
    476    Ihrem Pfad (PATH) auszuführen. Geben Sie am Sage-Prompt
    477    „install_scripts?“ ein, um Detailinformationen zu erhalten.
     470#. Optional: Führen Sie die Anweisung ``install_scripts`` innerhalb von
     471   Sage aus, um gp-, singular-, gap-Skripts und weitere Skripts in
     472   Ihrem Pfad (PATH) zu erstellen. Geben Sie am Sage-Prompt
     473   ``install_scripts?`` ein, um Detailinformationen zu erhalten.
    478474
    479475Zuletzt: Have fun! Entdecken Sie überraschende Zusammenhänge!
    480476
     
    483479----------------------------------------
    484480
    485481Dieser Abschnitt widmet sich der Frage, wie ein Systemadministrator
    486 einen einzige Kopie von Sage für die Multi-User-Nutzung in einem
     482eine einzige Kopie von Sage für die Multi-User-Nutzung in einem
    487483Computer-Netz installieren kann.
    488484
    489485
    490 Systemweit verfügbare Installation
    491 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
     486Systemweite Installation
     487~~~~~~~~~~~~~~~~~~~~~~~~
    492488
    493489Hier finden Sie eine Zusammenstellung von Mails der „Sage support
    494490list“ (speziell solche von Luis Finotti).
    495491
    496 #. Entpacken Sie den aktuellen Sage-Tarball (wobei anzunehmen ist,
    497    dass es sich um sage- 4.3.4 handelt) z. B. im Verzeichnis /usr/local/
     492#. Entpacken Sie den aktuellen Sage-Tarball (wir nehmen im Folgenden
     493   an, dass es sich um sage- 4.3.4 handelt) z. B. im Verzeichnis /usr/local/
    498494   und kompilieren Sie als root. Angenommen Sie arbeiten in einer
    499495   Root-Shell und der Sage-Tarball befindet sich in Ihrem aktuellen
    500496   Verzeichnis, dann geben Sie ein::
    501497
    502        cp sage-2.5.2.tar /usr/local
     498       cp sage-4.3.4.tar /usr/local
    503499       cd /usr/local
    504        tar xvf sage-2.5.2.tar
    505        cd sage-2.5.2/
     500       tar xvf sage-4.3.4.tar
     501       cd sage-4.3.4/
    506502       make
    507503
    508504    (Kommentar: Es ist besser am Zielort zu kopieren anstatt zuerst zu
     
    510506    Fehler wenn Sie den Tarball reallokieren, weil ein Fehler noch
    511507    nicht behoben ist, nämlich die PARI-Dateistruktur für den Ort der
    512508    "galois data", die intern im PARI-Code festgelegt
    513     ist. (Korrekturen sind willkommen!))
     509    ist. (Fehlerbehebung ist willkommen!))
    514510
    515 #. Stellen Sie sicher, dass Sie die Zeile mit den .....“‘s am Start
    516    des Sage-Skripts anpassen. In anderen Worten: Editieren Sie
    517    SAGE_ROOT="....." zu SAGE_ROOT="/usr/local/sage-4.3.4".
     511#. Stellen Sie sicher, dass Sie die Zeile mit den ``.....``‘s am Beginn
     512   des Sage-Skripts anpassen. Mit anderen Worten: Ersetzen Sie
     513   ``SAGE_ROOT="....."`` durch ``SAGE_ROOT="/usr/local/sage-4.3.4"``.
    518514
    519515#. Es gibt einige Initialisierungsdateien, die beim ersten Start von
    520    Sage erstellt werden müssen. Starten Sie Sage zunächst als Root (oder
    521    um genauer zu sein: Führen Sie test und den Standardtestcode als Root
    522    aus.) Sie können alle Tests mit Strg+z und mit der nachfolgenden
    523    Eingabe von kill %1 abbrechen (wobei hier angenommen wurde, dass Sie
    524    keine anderen Jobs im Background der Shell laufen haben).
     516   Sage erstellt werden müssen. Starten Sie Sage daher zunächst
     517   *einmal* als Root (um ganz gründlich zu sein, könnten Sie mit
     518   ``make test`` als root alle Standardtests ausführen lassen.) Sie
     519   können alle Tests mit ``Strg+z`` und mit der nachfolgenden
     520   Eingabe von ``kill %1`` abbrechen (wobei hier angenommen wurde, dass Sie
     521   keine anderen Hintergrundjobs in der Shell laufen haben).
    525522
    526 #. Erstellen einer Kopie in /usr/local/bin::
     523#. Erstellen Sie eine Kopie des ``sage``-Skripts in ``/usr/local/bin``::
    527524
    528        cp /usr/local/sage-2.5.2/sage /usr/local/bin/
     525       cp /usr/local/sage-4.3.4/sage /usr/local/bin/
    529526
    530    Sie erstellen anstatt eines symlinks eine Kopie, weil beim Upgrade
    531    mit „sage -upgrade“ die Dateien in /usr/local/sage-4.3.4/sage
    532    überschrieben werden und dabei der Eintrag „ROOT=...“ gelöscht
    533    wird.
     527   Sie sollten eine Kopie anstatt eines symlinks erstellen, weil sonst
     528   beim Upgrade mit ``sage -upgrade`` die Datei ``/usr/local/sage-4.3.4/sage``
     529   überschrieben würde und der darin enthaltene Eintrag ``ROOT=...`` gelöscht
     530   würde.
    534531
    535    Stellen Sie sicher, dass alle Dateien in /usr/local/sage-4.3.4
    536    für alle lesbar gesetzt sind::
     532   Stellen Sie sicher, dass alle Dateien in ``/usr/local/sage-4.3.4``
     533   für alle Benutzer lesbar sind::
    537534
    538        chmod a+rX -R /usr/local/sage-2.5.2
     535       chmod a+rX -R /usr/local/sage-4.3.4
    539536
    540537
    541538Besondere Hinweise
     
    543540
    544541
    545542-  (Beitrag von Dorian Raymer) Sage-Build schlägt fehl, wenn Sie
    546    bison++ installiert haben. Sie sollten dann bison++ deinstallieren
    547    und bison installieren.
     543   ``bison++`` installiert haben. Sie sollten dann ``bison++`` deinstallieren
     544   und ``bison`` installieren.
    548545
    549 -  (Beitrag von Peter Jipsen) Wenn Sie einen Fehler in der Art::
     546-  (Beitrag von Peter Jipsen) Wenn Sie einen Fehler in der Art
     547   ::
    550548
    551549       ImportError: /home/jipsen/Desktop/sage-1.3.3.1/local/lib/libpari-gmp.so.2:
    552550            cannot restore segment prot after reloc:
     
    555553   erhalten, dann hindert Ihre SELinux-Konfiguration Sage am Starten.
    556554   launching. Um das zu korrigieren, können Sie entweder den „default
    557555   security context“ für Sage (??) ändern oder SELinux vollständig
    558    deaktivieren. Das erreichen Sie mit dem Eintrag „SELINUX=disabled“
    559    in Ihrer Datei /etc/sysconfig/selinux file.
     556   deaktivieren. Das erreichen Sie mit dem Eintrag ``SELINUX=disabled``
     557   in Ihrer Datei ``/etc/sysconfig/selinux``.
    560558
    561559- um SageTeX für Anwender nutzbar zu machen, lesen Sie die Anweisungen
    562   zur Installation in einem „multiuser environment“.
     560  zur :ref:`Installation in einer multiuser-Umgebung <sagetex_installation_multiuser>`.