Opened 10 years ago

Last modified 7 years ago

#9725 closed enhancement

German Translation of the Tutorial — at Version 26

Reported by: phil Owned by: phil
Priority: minor Milestone: sage-4.7.1
Component: documentation Keywords: Documentation Tutorial German
Cc: schilly Merged in:
Authors: Philipp Schneider, Michael Mardaus Reviewers: Volker Braun
Report Upstream: N/A Work issues: doctest failures
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. 9725_TESTDIRS.patch to the SAGE_ROOT repository

Change History (39)

Changed 10 years ago by phil

Changed 10 years ago by phil

Changed 10 years ago by phil

Changed 10 years ago by phil

comment:1 Changed 10 years ago by phil

  • Owner changed from mvngu to phil

comment:2 Changed 10 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 10 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 10 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 10 years ago by mardaus

comment:5 Changed 10 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 10 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 10 years ago by mardaus

Changed 10 years ago by mardaus

Changed 10 years ago by mardaus

comment:7 Changed 10 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 10 years ago by phil

  • Work issues changed from translate more sections to proofreading

Changed 10 years ago by mardaus

Proofread version of Phil's parts

Changed 10 years ago by phil

comment:9 Changed 10 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 9 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 9 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 9 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 9 years ago by jdemeyer

  • Status changed from needs_review to needs_work

comment:19 Changed 9 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 9 years ago by jdemeyer

Apply to SAGE_ROOT repository

comment:20 Changed 9 years ago by jdemeyer

  • Description modified (diff)

comment:21 in reply to: ↑ 16 Changed 9 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 9 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 9 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 9 years ago by jdemeyer

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

comment:25 Changed 9 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 9 years ago by phil

fix the doctest problems

comment:26 Changed 9 years ago by phil

  • Description modified (diff)
  • Status changed from needs_work to needs_review
Note: See TracTickets for help on using tickets.