Opened 9 years ago

Closed 8 years ago

Last modified 7 years ago

#9725 closed enhancement (fixed)

German Translation of the Tutorial

Reported by: phil Owned by: phil
Priority: minor Milestone: sage-4.7.1
Component: documentation Keywords: Documentation Tutorial German
Cc: schilly Merged in: sage-4.7.1.alpha2
Authors: Philipp Schneider, Michael Mardaus Reviewers: Volker Braun
Report Upstream: N/A Work issues:
Branch: Commit:
Dependencies: Stopgaps:

Description (last modified by phil)

Create a German translation of the Sage Tutorial.

Apply:

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

Attachments (14)

introduction.rst (6.9 KB) - added by phil 9 years ago.
tour.rst (1009 bytes) - added by phil 9 years ago.
tour_assignment.rst (3.3 KB) - added by phil 9 years ago.
tour_help.rst (9.6 KB) - added by phil 9 years ago.
interactive_shell.rst (29.1 KB) - added by mardaus 9 years ago.
interfaces.rst (11.6 KB) - added by mardaus 9 years ago.
sagetex.rst (4.5 KB) - added by mardaus 9 years ago.
latex.rst (22.8 KB) - added by mardaus 9 years ago.
sage-proofread.zip (102.2 KB) - added by mardaus 9 years ago.
Proofread version of Phil's parts
tutorial-de.tgz (69.5 KB) - added by phil 9 years ago.
trac_9725.patch (208.1 KB) - added by phil 9 years ago.
9725_TESTDIRS.patch (753 bytes) - added by jdemeyer 8 years ago.
Apply to SAGE_ROOT repository
trac_9725B.patch (2.4 KB) - added by phil 8 years ago.
fix the doctest problems
trac_9725C.patch (1.0 KB) - added by phil 8 years ago.

Download all attachments as: .zip

Change History (52)

Changed 9 years ago by phil

Changed 9 years ago by phil

Changed 9 years ago by phil

Changed 9 years ago by phil

comment:1 Changed 9 years ago by phil

  • Owner changed from mvngu to phil

comment:2 Changed 9 years ago by mardaus

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

comment:3 Changed 9 years ago by phil

  • Status changed from new to needs_work

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

comment:4 Changed 9 years ago by mardaus

  • Authors changed from Philipp Schneider to Philipp Schneider, Michael Mardaus

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

Changed 9 years ago by mardaus

comment:5 Changed 9 years ago by maldun

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

comment:6 Changed 9 years ago by phil

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

Changed 9 years ago by mardaus

Changed 9 years ago by mardaus

Changed 9 years ago by mardaus

comment:7 Changed 9 years ago by phil

  • Milestone changed from sage-5.0 to sage-4.6
  • Status changed from needs_work to needs_review

comment:8 Changed 9 years ago by phil

  • Work issues changed from translate more sections to proofreading

Changed 9 years ago by mardaus

Proofread version of Phil's parts

Changed 9 years ago by phil

comment:9 Changed 9 years ago by phil

  • Work issues proofreading deleted

comment:10 Changed 9 years ago by mardaus

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.

comment:11 Changed 9 years ago by vbraun

  • Description modified (diff)
  • Milestone changed from sage-4.7 to sage-4.7.1
  • Reviewers set to Volker Braun

Typo: Whitenys Regenschirm -> Whitneys Regenschirm

Sieht gut aus! Ich gebe dem ticket positive review bis auf den tippfehler. Wenn Du den korrigierst kannst Du das ticket auf "positive review" setzen.

Changed 9 years ago by phil

comment:12 Changed 9 years ago by phil

Hello Volker,

I corrected the typo and made other little changes to make the doctests pass. Thanks for reviewing!

Philipp

comment:13 Changed 9 years ago by vbraun

  • Description modified (diff)
  • Status changed from needs_review to positive_review

comment:14 Changed 9 years ago by jdemeyer

  • Merged in set to sage-4.7.1.alpha1
  • Resolution set to fixed
  • Status changed from positive_review to closed

comment:15 follow-up: Changed 8 years ago by fbissey

I don't know if it is an interaction with another ticket but I just did a test run of 4.7.1.alpha1 and got

sage -t -long -force_lib "devel/sage-main/doc/de/tutorial/programming.rst"
**********************************************************************
File "/Users/frb15/Desktop/sage-4.7.1.alpha1/devel/sage-main/doc/de/tutorial/programming.rst", line 425:
    sage: type(v)
Expected:
    <class 'sage.structure.sequence.Sequence'>
Got:
    <class 'sage.structure.sequence.Sequence_generic'>
**********************************************************************
File "/Users/frb15/Desktop/sage-4.7.1.alpha1/devel/sage-main/doc/de/tutorial/programming.rst", line 463:
    sage: type(B)
Expected:
    <class 'sage.structure.sequence.Sequence'>
Got:
    <class 'sage.structure.sequence.Sequence_generic'>
**********************************************************************
2 items had failures:

comment:16 in reply to: ↑ 15 ; follow-up: Changed 8 years ago by jdemeyer

  • Merged in sage-4.7.1.alpha1 deleted
  • Resolution fixed deleted
  • Status changed from closed to new

Replying to fbissey:

I don't know if it is an interaction with another ticket but I just did a test run of 4.7.1.alpha1 and got

sage -t -long -force_lib "devel/sage-main/doc/de/tutorial/programming.rst"

Which command did you type to run this test? When I ran "make ptest" or "make ptestlong", this test simply was not run, so that's where the bug is.

comment:17 Changed 8 years ago by jdemeyer

  • Status changed from new to needs_review
  • Work issues set to build and test "de" documentation automatically

Note also that the patchbot reports

sage -t  -force_lib sage/misc/sagedoc.py
**********************************************************************
File "/levi/scratch/robertwb/buildbot/sage-4.7.rc1/devel/sage-9725/sage/misc/sagedoc.py", line 489:
    sage: 'abvar/homology' in _search_src_or_doc('doc', 'homology', 'variety', interact=False)
Expected:
    True
Got:
    Warning, the following Sage documentation hasn't been built,
    so documentation search results may be incomplete:
    <BLANKLINE>
    /levi/scratch/robertwb/buildbot/sage-4.7.rc1/devel/sage/doc/output/html/de/tutorial
    <BLANKLINE>
    You can build this with 'sage -docbuild de/tutorial html'.
    True
**********************************************************************

and that the "doc/de" directory is not tested.

comment:18 Changed 8 years ago by jdemeyer

  • Status changed from needs_review to needs_work

comment:19 Changed 8 years ago by phil

Hi, in Sage 4.6.2 all tests passed. (I tested it manually.) I guess that the type of this sequence has changed in sage 4.7. I will fix this when sage 4.7 is released.

What i don't know is how to change sage to build and test "de" documentation automatically.

Changed 8 years ago by jdemeyer

Apply to SAGE_ROOT repository

comment:20 Changed 8 years ago by jdemeyer

  • Description modified (diff)

comment:21 in reply to: ↑ 16 Changed 8 years ago by fbissey

Replying to jdemeyer:

Replying to fbissey:

I don't know if it is an interaction with another ticket but I just did a test run of 4.7.1.alpha1 and got

sage -t -long -force_lib "devel/sage-main/doc/de/tutorial/programming.rst"

Which command did you type to run this test? When I ran "make ptest" or "make ptestlong", this test simply was not run, so that's where the bug is.

I just did a build of sage with make and then ran "./sage -tp 3 -long -sagenb devel/" I was checking that gsl-1.15 (#11357) was OK with 4.7.1.alpha1.

comment:22 Changed 8 years ago by fbissey

I don't know why I didn't mention it in my original post but I also have a time out in

sage -t -long  -force_lib devel/sage-main/doc/de/tutorial/interfaces.rst

Using -verbose it appears to get stuck at

Trying:
    maxima.plot3d ("2^(-u^2 + v^2)", "[u, -3, 3]", "[v, -2, 2]",   '[plot_format, openmath]') # nicht getestet###line 323:_sage_    >>> maxima.plot3d ("2^(-u^2 + v^2)", "[u, -3, 3]", "[v, -2, 2]",   '[plot_format, openmath]') # nicht getestet
Expecting nothing

I am guessing #7377 is to blame for that one.

comment:23 Changed 8 years ago by vbraun

The magic # not tested comment at the end of the doctest means Sage isn't supposed to use the command as a doctest. Its part of the Sage doctest syntax and you shouldn't translate it.

comment:24 Changed 8 years ago by jdemeyer

  • Work issues changed from build and test "de" documentation automatically to doctest failures

comment:25 Changed 8 years ago by phil

I created a patch to fix the doctest problems.

However, when I try to apply the 9725_TESTDIRS.patch I get the following error

sage: hg_sage.apply("../../9725_TESTDIRS.patch")
cd "/home/phil/Applications/sage-4.7.rc4/devel/sage" && hg status
cd "/home/phil/Applications/sage-4.7.rc4/devel/sage" && hg status
cd "/home/phil/Applications/sage-4.7.rc4/devel/sage" && hg import   "/home/phil/Applications/sage-4.7.rc4/9725_TESTDIRS.patch"
applying /home/phil/Applications/sage-4.7.rc4/9725_TESTDIRS.patch
unable to find 'Makefile' for patching
1 out of 1 hunks FAILED -- saving rejects to file Makefile.rej
abort: patch failed to apply

Changed 8 years ago by phil

fix the doctest problems

comment:26 Changed 8 years ago by phil

  • Description modified (diff)
  • Status changed from needs_work to needs_review

comment:27 Changed 8 years ago by phil

  • Status changed from needs_review to needs_work
  • Work issues changed from doctest failures to patch Makefile - add testdir

comment:28 follow-up: Changed 8 years ago by phil

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

comment:29 in reply to: ↑ 28 Changed 8 years ago by jdemeyer

  • Status changed from needs_work to needs_review
  • Work issues patch Makefile - add testdir deleted

Replying to phil:

How is it possible to patch the Makefile?

You need to use hg_root instead of hg_sage:

sage: hg_root.apply("http://trac.sagemath.org/sage_trac/raw-attachment/ticket/9725/9725_TESTDIRS.patch")
Attempting to load remote file: http://trac.sagemath.org/sage_trac/raw-attachment/ticket/9725/9725_TESTDIRS.patch
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

comment:30 Changed 8 years ago by phil

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

comment:31 Changed 8 years ago by schilly

  • Cc schilly added

comment:32 Changed 8 years ago by jdemeyer

  • Status changed from needs_review to needs_work
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);
**********************************************************************

comment:33 Changed 8 years ago by phil

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

Changed 8 years ago by phil

comment:34 Changed 8 years ago by phil

  • Description modified (diff)
  • Status changed from needs_work to needs_review

comment:35 Changed 8 years ago by phil

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

comment:36 Changed 8 years ago by vbraun

  • Status changed from needs_review to positive_review

Works for me on Sage-4.7.1.alpha1

comment:37 Changed 8 years ago by jdemeyer

  • Merged in set to sage-4.7.1.alpha2
  • Resolution set to fixed
  • Status changed from positive_review to closed

comment:38 Changed 7 years ago by kcrisman

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.

Note: See TracTickets for help on using tickets.