Opened 10 years ago

Closed 5 years ago

Last modified 5 years ago

#8698 closed enhancement (fixed)

German translation of the document "A Tour of Sage"

Reported by: mvngu Owned by: mvngu
Priority: major Milestone: sage-6.3
Component: documentation Keywords: german
Cc: bblochl@…, simon.king@…, leif, minz Merged in:
Authors: Bernhard Bloechl Reviewers: Minh Van Nguyen, André Apitzsch, Frédéric Chapoton, Simon King, Leif Leonhardy
Report Upstream: N/A Work issues:
Branch: d686ce5 (Commits) Commit:
Dependencies: Stopgaps:

Description (last modified by mvngu)

As the subject says. Because the patch on this ticket is short, I think this ticket takes much less work to review than #8660. So it's very likely that the current ticket would be merged first, then #8660. Someone who knows German needs to look over the attached patch.

See this sage-support thread for background information.

Attachments (2)

trac_8698-tour-de.patch (6.7 KB) - added by mvngu 10 years ago.
based on Sage 4.3.5
trac_8698-tour-de-sage_reviewer.patch (6.7 KB) - added by SimonKing 10 years ago.
Adding a section on the notebook; adding the missing plots; some proof reading

Download all attachments as: .zip

Change History (24)

comment:1 Changed 10 years ago by mvngu

  • Authors set to Bernhard Bloechl
  • Cc bblochl@… added
  • Description modified (diff)
  • Reviewers set to Minh Van Nguyen
  • Status changed from new to needs_review

comment:2 Changed 10 years ago by SimonKing

  • Cc simon.king@… added

comment:3 Changed 10 years ago by mvngu

  • Description modified (diff)

Updated patch in response to Bernhard's new posting at sage-support.

comment:4 Changed 10 years ago by SimonKing

  • Status changed from needs_review to needs_work

I made some proof reading, based on the html version that Minh posted at http://sage.math.washington.edu/home/mvngu/8698-tour-de/

  • Das ist ein Rundgang durch Sage, der sich eng an der „Tour of Mathematica“ am Beginn des Mathematica-Buchs folgt. ---> Das ist ein Rundgang durch Sage, der sich eng an die „Tour of Mathematica“ am Beginn des Mathematica-Buchs anlehnt. oder freier ---> Das ist ein Rundgang durch Sage, der sich an der „Tour of Mathematica“ am Beginn des Mathematica-Buchs orientiert. bzw. ---> Das ist ein Rundgang durch Sage, der von der „Tour of Mathematica“ am Beginn des Mathematica-Buchs inspiriert ist.

  • Wenn Sie das Sage in der Notebook-Version (als Notizbuch) benutzen. Since Sage is a name, it should be Wenn Sie Sage in der Notebook-Version...
  • Die Berechnung und Ausgabe des Wertes erfolgt nach der Eingabe der Tasten shift+return. Keys are not being entered. So, better Die Berechnung und Ausgabe des Wertes erfolgt nach gleichzeitigem Drücken der Tasten shift+return
  • Die Invertierung der Matrix 2 \times 2 in Sage: should be replaced by Die Invertierung einer (2 \times 2)-Matrix in Sage:.
  • Damit ermittelt Sage eine quadratische Gleichung. It was not immediately clear to me what "Damit" refers to. Moreover, the equation is not "determined" but "solved". So, perhaps better Im nächsten Beispiel löst Sage eine quadratische Gleichung.
  • Sage benötigt weniger als 5 Sekunden um die Anzahl der möglichen Varianten zur Partitionierung von... zu berechnen: There is a comma missing; I don't think that one would talk about "number of possible variants of partitions"; Sage is not only computing the number of partitions, but actually finds the partitions (which is stronger); and I think "partition" is "Partition" in German. So, I suggest Sage benötigt weniger als 5 Sekunden, um alle Partitionen von... zu ermitteln.
  • Last phrase of section "Sage-Algorithmen benutzen": I suggest to remove the parentheses. Perhaps one can make a footnote, but I think the phrase is just fine in normal text.

Best regards, and thank you for working on a German translation,

Simon

Changed 10 years ago by mvngu

based on Sage 4.3.5

comment:5 follow-up: Changed 10 years ago by leif

  • Cc leif added

Thanks, Simon... ;-)

I think what's at all meant by "Notebook" has to be explained, too. A typical German reader would first think of his laptop, not a user interface (which is funny if not annoying in the translation of the user guide when talking about ssh_keygen...).

It would be nice if you could supply a patch on top of Minh's.

-Leif

Changed 10 years ago by SimonKing

Adding a section on the notebook; adding the missing plots; some proof reading

comment:6 in reply to: ↑ 5 ; follow-up: Changed 10 years ago by SimonKing

  • Status changed from needs_work to needs_review

Replying to leif:

I think what's at all meant by "Notebook" has to be explained, too.

Good idea (and perhaps it would make sense to have this in English, too).

It would be nice if you could supply a patch on top of Minh's.

Done.

My patch adds a section on the notebook (I hope I didn't write too much nonsense, because I hardly ever use the notebook) and the two png-plots that were missing.

Minh: Is it OK to first finish this ticket off before focusing on #8660? Or should the two tickets be united at an earlier stage?

Best regards, Simon

comment:7 Changed 10 years ago by SimonKing

Helas.

I just found one typo. I wrote: "Die Anzahl der Möglichkeiten ist gigantisch, wir geben hier nur die letzten 40 Ziffern an."

Should be "Die Anzahl der Möglichkeiten ist gigantisch, wir geben hier nur die ersten 40 Ziffern an."

But I think this should be fixed once there are more comments of another reviewer.

comment:8 in reply to: ↑ 6 Changed 10 years ago by mvngu

Replying to SimonKing:

Minh: Is it OK to first finish this ticket off before focusing on #8660? Or should the two tickets be united at an earlier stage?

The Sage tour is much shorter than the installation guide. So I think the tour would be the first to get into the Sage standard documentation. Thank you for reviewing the tour.

comment:9 Changed 9 years ago by aapitzsch

  • Status changed from needs_review to needs_work

in conf.py:

  • add language = 'de' (to replace Chapter by Kapitel)
  • set html_short_title to Sage Rundgang

in index.rst:

  • Computer-Labors ---> Computerlabors
  • shift-return ---> Shift + Return or use only the German words
  • Gleichheitszeichen.(Das Zeichen ---> Gleichheitszeichen. (Das Zeichen

Some pictures (sin_plot.png, eigen_plot.png) are missing. I think they should be put inside doc/common and not be shipped by every language version itself.

When you fixed everything set status back to needs review.

comment:10 Changed 9 years ago by minz

  • Cc minz added

comment:11 Changed 6 years ago by jdemeyer

  • Milestone changed from sage-5.11 to sage-5.12

comment:12 Changed 6 years ago by vbraun_spam

  • Milestone changed from sage-6.1 to sage-6.2

comment:13 Changed 6 years ago by vbraun_spam

  • Milestone changed from sage-6.2 to sage-6.3

comment:14 Changed 5 years ago by chapoton

  • Keywords german added

comment:15 Changed 5 years ago by chapoton

  • Branch set to u/chapoton/8698
  • Commit set to 723df4a9ba89535c184bb58b3d6ef3cd8a79df7a
  • Status changed from needs_work to needs_review

Here is a git branch, passing tests and with html building correctly. I think it can be considered as needs review.


New commits:

407cfb0#8698: German translation of the document "A Tour of Sage"
4c2a998Proof reading for the German version of "Tour of Sage". Adding the two missing plots. Adding as section on the Sage notebook.
723df4atrac #8698 correct one doctest + put images in place

comment:16 Changed 5 years ago by aapitzsch

  • Status changed from needs_review to needs_work

See comments 7 and 9.

comment:17 Changed 5 years ago by git

  • Commit changed from 723df4a9ba89535c184bb58b3d6ef3cd8a79df7a to d614bbdfee007161bad350c77644978ff0f14ff8

Branch pushed to git repo; I updated commit sha1. New commits:

d614bbdtrac #8698 reviewer comments

comment:18 Changed 5 years ago by chapoton

  • Status changed from needs_work to needs_review

Done. Needs review now.

comment:19 Changed 5 years ago by aapitzsch

  • Branch changed from u/chapoton/8698 to u/aapitzsch/ticket/8698
  • Commit changed from d614bbdfee007161bad350c77644978ff0f14ff8 to d686ce571b526b01fd1cfeacc814b8eaca88fb46
  • Reviewers changed from Minh Van Nguyen to Minh Van Nguyen, André Apitzsch

Frédéric, if you are happy with my changes you can set the status to positive review.

comment:20 Changed 5 years ago by chapoton

  • Status changed from needs_review to positive_review

Danke schön !

comment:21 Changed 5 years ago by vbraun

  • Branch changed from u/aapitzsch/ticket/8698 to d686ce571b526b01fd1cfeacc814b8eaca88fb46
  • Resolution set to fixed
  • Status changed from positive_review to closed

comment:22 Changed 5 years ago by kcrisman

  • Commit d686ce571b526b01fd1cfeacc814b8eaca88fb46 deleted
  • Reviewers changed from Minh Van Nguyen, André Apitzsch to Minh Van Nguyen, André Apitzsch, Frédéric Chapoton, Simon King, Leif Leonhardy
Note: See TracTickets for help on using tickets.