#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 )
Create a German translation of the Sage Tutorial.
Apply:
- trac_9725.patch
- trac_9725B.patch
- trac_9725C.patch
- 9725_TESTDIRS.patch to the SAGE_ROOT repository
Attachments (14)
Change History (52)
Changed 9 years ago by
Changed 9 years ago by
Changed 9 years ago by
Changed 9 years ago by
comment:1 Changed 9 years ago by
- Owner changed from mvngu to phil
comment:2 Changed 9 years ago by
comment:3 Changed 9 years ago by
- 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
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
comment:5 Changed 9 years ago by
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
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
Changed 9 years ago by
Changed 9 years ago by
comment:7 Changed 9 years ago by
- 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
- Work issues changed from translate more sections to proofreading
Changed 9 years ago by
comment:9 Changed 9 years ago by
- Work issues proofreading deleted
comment:10 Changed 9 years ago by
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
- 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
comment:12 Changed 9 years ago by
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
- Description modified (diff)
- Status changed from needs_review to positive_review
comment:14 Changed 9 years ago by
- Merged in set to sage-4.7.1.alpha1
- Resolution set to fixed
- Status changed from positive_review to closed
comment:15 follow-up: ↓ 16 Changed 8 years ago by
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: ↓ 21 Changed 8 years ago by
- 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
- 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
- Status changed from needs_review to needs_work
comment:19 Changed 8 years ago by
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.
comment:20 Changed 8 years ago by
- Description modified (diff)
comment:21 in reply to: ↑ 16 Changed 8 years ago by
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
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
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
- Work issues changed from build and test "de" documentation automatically to doctest failures
comment:25 Changed 8 years ago by
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
comment:26 Changed 8 years ago by
- Description modified (diff)
- Status changed from needs_work to needs_review
comment:27 Changed 8 years ago by
- Status changed from needs_review to needs_work
- Work issues changed from doctest failures to patch Makefile - add testdir
comment:28 follow-up: ↓ 29 Changed 8 years ago by
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
- 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
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
- Cc schilly added
comment:32 Changed 8 years ago by
- 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
Well, of course you can only get the required output if you have the GAP group database package installed...
Changed 8 years ago by
comment:34 Changed 8 years ago by
- Description modified (diff)
- Status changed from needs_work to needs_review
comment:35 Changed 8 years ago by
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
- Status changed from needs_review to positive_review
Works for me on Sage-4.7.1.alpha1
comment:37 Changed 8 years ago by
- Merged in set to sage-4.7.1.alpha2
- Resolution set to fixed
- Status changed from positive_review to closed
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