German Translation of the Tutorial

[sagetrac-phil]

Create a German translation of the Sage Tutorial.

Apply:

1. attachment: trac_9725.patch
2. attachment: trac_9725B.patch
3. attachment: trac_9725C.patch
4. attachment: 9725_TESTDIRS.patch to the SAGE_ROOT repository

CC: @haraldschilly

Component: documentation

Keywords: Documentation Tutorial German

Author: Philipp Schneider, Michael Mardaus

Reviewer: Volker Braun

Merged: sage-4.7.1.alpha2

Issue created by migration from https://trac.sagemath.org/ticket/9725

[sagetrac-phil]

Attachment: introduction.rst.gz

Attachment: tour.rst.gz

[sagetrac-phil]

Attachment: tour_assignment.rst.gz

[sagetrac-phil]

comment:1

Attachment: tour_help.rst.gz

[sagetrac-mardaus]

comment:2

Hallo Phil,
ich hab mal in die erste Datei geschaut, und hätte ein paar typos und Formulierungen anzumerken. Können wir irgendwie zusammen daran arbeiten, ohne das wir dauernd neue Dateien hochladen müssen? Ich denke da an SVN oder dergleichen.
Michael

[sagetrac-phil]

comment:3

If someone would like to help us proofreading, I will keep a current version of the translation published at:
http://wwwcip.informatik.uni-erlangen.de/~snphschn/sage/doc/output/html/de/tutorial/index.html

The current rst Files can be found at:
http://wwwcip.informatik.uni-erlangen.de/~snphschn/sage/doc/de/tutorial/

Philipp

[sagetrac-mardaus]

Changed author from Philipp Schneider to Philipp Schneider, Michael Mardaus

[sagetrac-mardaus]

comment:4

FYI: I'm translating interactive_shell.rst at the moment.

I will send you my file once I'm done translating it, and I will send you a diff or updated/commented version of your files after I proofread them via email.

Michael

[sagetrac-maldun]

comment:5

Attachment: interactive_shell.rst.gz

Ein paar Hinweise/Typos:

langfristige >>Zeile<< von Sage -> Ich denke ihr meint >>Ziele<< =)

geführte Tour -> Ich würde guided mit "begleitend", statt mit "geführt" übersetzen macht im Deutschen mehr Sinn...

Ich glaube statt "Hilfe erhalten", würde ich nur "Hilfe" schreiben

Euler’s Method for Systems of Differential Equations¶ -> warum wurde das nicht übersetzt?

Das sind nur ein paar Sachen die mir beim schnellen durchlesen aufgefallen sind. Aber ansich eine gute Übersetzung. bravo!

greez
maldun

[sagetrac-phil]

comment:6

Thanks for your corrections, I changed everything.
If you would like to translate a section yourself, you are welcome.

Also, I made the pdf version available at
http://wwwcip.informatik.uni-erlangen.de/~snphschn/sage/doc/output/pdf/de/tutorial/SageTutorial.pdf

Phil

[sagetrac-mardaus]

Attachment: interfaces.rst.gz

[sagetrac-mardaus]

Attachment: sagetex.rst.gz

Attachment: latex.rst.gz

[sagetrac-phil]

Changed work issues from translate more sections to proofreading

[sagetrac-mardaus]

Attachment: sage-proofread.zip

Proofread version of Phil's parts

[sagetrac-phil]

Attachment: tutorial-de.tgz.gz

[sagetrac-phil]

Changed work issues from proofreading to none

[sagetrac-mardaus]

comment:10

I found an article in the german computer magazine c't today about sage (c't 5/2011 p. 69) where it says:
"Das Gratis-Paket Sage bringt die wichtigesten Open-Source-Mathematikprogramme schon mit - 'Batteries included', heißt es in der ausführlichen, aber komplett englischen Dokumentation. ..."
(The free package Sage brings the most important open-source math-programs batteries included, as it says in the detailed, but completely english written documentation.)

Maybe we should use that as a reminder that we already have a german version of the tut here.

[sagetrac-phil]

comment:26

Attachment: trac_9725B.patch.gz

[sagetrac-phil]

Changed work issues from doctest failures to patch Makefile - add testdir

[sagetrac-phil]

comment:28

How is it possible to patch the Makefile?

I edited the Makefile to add the directory of the german tutorial to the TESTDIR.
When I tried to commit the change I got:

sage: hg_sage.commit()
cd "/home/phil/Applications/sage-4.7.rc4/devel/sage" && hg diff  | less
cd "/home/phil/Applications/sage-4.7.rc4/devel/sage" && hg commit  
nothing changed

[jdemeyer]

Changed work issues from patch Makefile - add testdir to none

[jdemeyer]

comment:29

Replying to @sagetrac-phil:

How is it possible to patch the Makefile?

You need to use hg_root instead of hg_sage:

sage: hg_root.apply("https://github.com/sagemath/sage-prod/files/10650457/9725_TESTDIRS.patch.gz")
Attempting to load remote file: https://github.com/sagemath/sage-prod/files/10650457/9725_TESTDIRS.patch.gz
Loading: [.]
cd "/usr/local/src/sage-4.7" && hg status
cd "/usr/local/src/sage-4.7" && hg status
cd "/usr/local/src/sage-4.7" && hg import   "/home/jdemeyer/.sage/temp/arcanis/5225/tmp_0.patch"
applying /home/jdemeyer/.sage/temp/arcanis/5225/tmp_0.patch

[sagetrac-phil]

comment:30

Ok thanks,

I also ran make ptestlong after adding the directory of the german tutorial the TESTDIRS variable and got

phil@phil-lt:~/Applications/sage-4.7.rc4$ make ptestlong
...
All tests passed!
Total time for all tests: 3914.3 seconds

[jdemeyer]

comment:32

sage -t  -force_lib devel/sage/doc/de/tutorial/interfaces.rst
**********************************************************************
File "/mnt/usb1/scratch/jdemeyer/merger/sage-4.7.1.alpha2/devel/sage-main/doc/de/tutorial/interfaces.rst", line 163:
    sage: G.IdGroup()
Exception raised:
    Traceback (most recent call last):
      File "/mnt/usb1/scratch/jdemeyer/merger/sage-4.7.1.alpha2/local/bin/ncadoctest.py", line 1231, in run_one_test
        self.run_one_example(test, example, filename, compileflags)
      File "/mnt/usb1/scratch/jdemeyer/merger/sage-4.7.1.alpha2/local/bin/sagedoctest.py", line 38, in run_one_example
        OrigDocTestRunner.run_one_example(self, test, example, filename, compileflags)
      File "/mnt/usb1/scratch/jdemeyer/merger/sage-4.7.1.alpha2/local/bin/ncadoctest.py", line 1172, in run_one_example
        compileflags, 1) in test.globs
      File "<doctest __main__.example_3[5]>", line 1, in <module>
        G.IdGroup()###line 163:
    sage: G.IdGroup()
      File "/mnt/usb1/scratch/jdemeyer/merger/sage-4.7.1.alpha2/local/lib/python/site-packages/sage/interfaces/interface.py", line 588, in
 __call__
        return self._obj.parent().function_call(self._name, [self._obj] + list(args), kwds)
      File "/mnt/usb1/scratch/jdemeyer/merger/sage-4.7.1.alpha2/local/lib/python/site-packages/sage/interfaces/gap.py", line 646, in funct
ion_call
        ['%s=%s'%(key,value.name()) for key, value in kwds.items()])))
      File "/mnt/usb1/scratch/jdemeyer/merger/sage-4.7.1.alpha2/local/lib/python/site-packages/sage/interfaces/gap.py", line 375, in eval
        result = Expect.eval(self, input_line, **kwds)
      File "/mnt/usb1/scratch/jdemeyer/merger/sage-4.7.1.alpha2/local/lib/python/site-packages/sage/interfaces/expect.py", line 1026, in e
val
        return '\n'.join([self._eval_line(L, **kwds) for L in code.split('\n') if L != ''])
      File "/mnt/usb1/scratch/jdemeyer/merger/sage-4.7.1.alpha2/local/lib/python/site-packages/sage/interfaces/gap.py", line 519, in _eval
_line
        raise RuntimeError, message
    RuntimeError: Gap produced error output
    Error, the Small Groups identification is required but not installed

       executing IdGroup($sage1);
**********************************************************************

[sagetrac-phil]

comment:33

Well, of course you can only get the required output if you have the GAP group database package installed...

[sagetrac-phil]

Attachment: trac_9725C.patch.gz

[sagetrac-phil]

comment:35

I guess the test which depends on the optional package requires a magic string too.
It should work after applying patch C.

[vbraun]

comment:36

Works for me on Sage-4.7.1.alpha1

[jdemeyer]

Merged: sage-4.7.1.alpha2

[kcrisman]

comment:38

FYI - There is a tiny typo a beginner could fix, wanted to pass it on here though I don't expect anyone here to address it, given that #8660 or #8698 would be more useful... Anyway, #14035.