Opened 9 years ago
Closed 6 years ago
#12822 closed enhancement (fixed)
Portuguese translation of "Tutorial"
Reported by:  goliveira  Owned by:  mvngu 

Priority:  minor  Milestone:  sage6.6 
Component:  translations  Keywords:  translation, portuguese 
Cc:  r.gaia.cs, jhpalmieri, jdemeyer  Merged in:  
Authors:  Gustavo de Oliveira  Reviewers:  Paulo César Pereira de Andrade, Jeroen Demeyer, Frédéric Chapoton, KarlDieter Crisman 
Report Upstream:  N/A  Work issues:  
Branch:  9dc3771 (Commits, GitHub, GitLab)  Commit:  9dc3771aea869eaa342c98e535bc3d7681af2230 
Dependencies:  Stopgaps: 
Description (last modified by )
Portuguese translation of "Tutorial".
The current version of the translation includes "the first revision" and a minor modification (incorporating a suggestion above). "The first revision" originated from a discussion at sagedevel:
https://groups.google.com/d/topic/sagedevel/2fjtcJTTNr8/discussion
Everything is combined in a single patch.
Attachments (3)
Change History (53)
Changed 9 years ago by
comment:1 Changed 9 years ago by
 Description modified (diff)
comment:2 Changed 9 years ago by
 Status changed from new to needs_review
comment:3 Changed 9 years ago by
 Type changed from PLEASE CHANGE to enhancement
comment:4 Changed 9 years ago by
 Description modified (diff)
Changed 9 years ago by
comment:5 Changed 9 years ago by
 Description modified (diff)
comment:6 Changed 9 years ago by
comment:7 Changed 9 years ago by
 Cc r.gaia.cs added
comment:8 Changed 9 years ago by
 Description modified (diff)
I have rebase the #12502.
IMHO, it best to translate the comments of the codes, e.g., in the place of
sage: 2**3 # ** means exponent
should be use
sage: 2**3 # ** indica potenciação
comment:9 Changed 9 years ago by
I built my fedora sagemath 5.4.beta1 experimental package with procedure to copy png files and patch from #12502 and patches here, and it builds and works correctly.
comment:10 Changed 9 years ago by
 Description modified (diff)
 Status changed from needs_review to positive_review
comment:11 Changed 9 years ago by
 Dependencies changed from 12502 to #12502
 Description modified (diff)
 Merged in set to Paulo César Pereira de Andrade
comment:12 Changed 9 years ago by
 Milestone changed from sage5.4 to sage5.5
comment:13 Changed 9 years ago by
 Merged in Paulo César Pereira de Andrade deleted
 Reviewers set to Paulo César Pereira de Andrade
comment:14 Changed 9 years ago by
 Dependencies changed from #12502 to #12502, #9774
 Status changed from positive_review to needs_work
comment:15 Changed 9 years ago by
 Dependencies changed from #12502, #9774 to #12502, #9774, #13072, #12290
Changed 9 years ago by
comment:16 Changed 9 years ago by
 Dependencies changed from #12502, #9774, #13072, #12290 to sage5.5.rc0
 Description modified (diff)
 Status changed from needs_work to needs_review
comment:17 Changed 8 years ago by
 Milestone changed from sage5.11 to sage5.12
comment:18 Changed 8 years ago by
 Milestone changed from sage6.1 to sage6.2
comment:19 Changed 7 years ago by
 Milestone changed from sage6.2 to sage6.3
comment:20 Changed 7 years ago by
 Branch set to u/chapoton/12822
 Commit set to 3f66c432441d012c4623e13a45221e904d8a0bf8
 Dependencies sage5.5.rc0 deleted
 Status changed from needs_review to needs_work
comment:21 Changed 7 years ago by
 Work issues set to newstyle of doctest continuation
comment:22 Changed 7 years ago by
 Milestone changed from sage6.3 to sage6.4
comment:23 Changed 7 years ago by
 Commit changed from 3f66c432441d012c4623e13a45221e904d8a0bf8 to b0bebd69b21c0c0044938d6600afd860fb999abf
comment:24 Changed 7 years ago by
 Component changed from documentation to translations
comment:25 Changed 7 years ago by
 Status changed from needs_work to needs_review
 Work issues newstyle of doctest continuation deleted
comment:26 Changed 7 years ago by
Is it possible to also remove the nonstandard uses of \
line continuations, see #14512.
comment:27 Changed 7 years ago by
 Commit changed from b0bebd69b21c0c0044938d6600afd860fb999abf to 856f0ce66e42ecb276bf6998b5a27cfcb73cb97f
comment:28 Changed 7 years ago by
 Commit changed from 856f0ce66e42ecb276bf6998b5a27cfcb73cb97f to dc9bb19003020abac43f60d8b93e242336c4529c
Branch pushed to git repo; I updated commit sha1. New commits:
dc9bb19  trac #12822 one more \ missed

comment:29 followup: ↓ 30 Changed 7 years ago by
Anyone have a sense of what is still needed here? It's rather impressively complete.
comment:30 in reply to: ↑ 29 Changed 7 years ago by
Replying to kcrisman:
Anyone have a sense of what is still needed here? It's rather impressively complete.
In the file latex.rst, there are references to the obsolete jsMath, which was replaced by MathJax? in more recent versions. This has to be updated in the translation.
You are right, the above report is not clear at all (but thanks to the people that worked on this nevertheless). I think that the other issues that were raised are solved. For instance, the presence of obsolete \ to break lines, and old notation for line continuation in the sage prompt. I did a search on the files and I believe this is solved.
As far as I know, the only remaining issue is the reference to the obsolete jsMath. (I am going to fix this until the end of the week.)
comment:31 Changed 7 years ago by
As far as I know, the only remaining issue is the reference to the obsolete jsMath. (I am going to fix this until the end of the week.)
Sorry, I should have asked whether there was anything linguistic, but I think comment:10 answers that. Awesome, and thanks for fixing this. Then we can add it a link on the website as well  see http://www.sagemath.org/pt/ for a totally different, but apparently useful, tutorial.
comment:32 Changed 6 years ago by
 Commit changed from dc9bb19003020abac43f60d8b93e242336c4529c to 5fa1b0ddabb9f5f33760487477d44c53efa00140
comment:33 Changed 6 years ago by
 Reviewers changed from Paulo César Pereira de Andrade to Paulo César Pereira de Andrade, Jeroen Demeyer, Frédéric Chapoton
comment:34 Changed 6 years ago by
 Reviewers changed from Paulo César Pereira de Andrade, Jeroen Demeyer, Frédéric Chapoton to Paulo César Pereira de Andrade, Jeroen Demeyer, Frédéric Chapoton, KarlDieter Crisman
 Status changed from needs_review to needs_work
This apparently makes several graphics files while being tested. Can you look into this?
Also, there is a bad link  dive into Python now is at http://www.diveintopython.net/
Martin Albrecht (malb@…) is probably old, though also probably still in the regular tutorial.
Finally, numerous doctest failures  mostly trivial related to graphics, but quite a few others related to Pari and other stuff as well.
comment:35 Changed 6 years ago by
Also, shouldn't comment like # automatic coercion before addition
be translated too?
comment:36 Changed 6 years ago by
 Commit changed from 5fa1b0ddabb9f5f33760487477d44c53efa00140 to d15374c9cd4851145fc125d75c24cd8bb6927e6e
comment:37 Changed 6 years ago by
I think I have taken care of
 created graphics
 bad links and addresses
 failing doctests
There remains the question of traduction of comments.
comment:38 Changed 6 years ago by
 Milestone changed from sage6.4 to sage6.6
comment:39 Changed 6 years ago by
********************************************************************** File "src/doc/pt/tutorial/programming.rst", line 512, in doc.pt.tutorial.programming Failed example: X Expected: {1, 19, 'a'} Got: {'a', 1, 19}
This is because sets don't print deterministically.
https://docs.python.org/ref/ref.html doesn't work either, nor does http://ipython.scipy.org/doc/rel0.9.1/html/interactive/reference.html#magiccommands (a link in interactive_shell.html) ... sigh, I don't have time to just click on every link! And sage docbuild warnlinks
I think only works for internal links.
comment:40 Changed 6 years ago by
 Commit changed from d15374c9cd4851145fc125d75c24cd8bb6927e6e to d3540f32172cbd154ff37cd70e3b0734412c301a
Branch pushed to git repo; I updated commit sha1. New commits:
d3540f3  trac #12822 set order is random, corrected html links

comment:41 Changed 6 years ago by
 Commit changed from d3540f32172cbd154ff37cd70e3b0734412c301a to 429d63af85140282617e1df16567845001a77f1f
Branch pushed to git repo; I updated commit sha1. New commits:
429d63a  trac # ipython version typo

comment:42 Changed 6 years ago by
How do we deal with other set output? Maybe list(set)
? After all,
sage: Y {2/3, 1}
may be different on other systems, I assume. Thoughts/opinions?
comment:43 Changed 6 years ago by
 Commit changed from 429d63af85140282617e1df16567845001a77f1f to 61fdeb577cc6a043bb2f0013a7835e74b7b0fb30
Branch pushed to git repo; I updated commit sha1. New commits:
61fdeb5  trac #12822 sets are printed in random order (bis)

comment:44 followup: ↓ 48 Changed 6 years ago by
 Cc jhpalmieri jdemeyer added
Whenever I do the docbuild with warnlinks
I get
[tutorial ] /Users/.../sage/src/doc/pt/tutorial/interactive_shell.rst:403: WARNING: envvar reference target not found: EDITOR
but not without that, and not if I docbuild a second time. I'm not sure if that matters, unless perhaps we no longer have an EDITOR
variable? I'm cc:ing a couple people who know what that flag does better than I do.
comment:45 Changed 6 years ago by
https://docs.python.org/devguide/ seems to be the best link nowadays for the way one actually develops Python, I couldn't even easily find "Guido, Some Guys, and a Mailing List: How Python is Developed" on the official Python site.
http://sagemath.org/doc/thematic_tutorials/coercion_and_categories.html is the new link for tour_coercion.html and of course the Portuguese for that link ( como um arquivo Sage.) would not be quite right.
altermundus link is now http://altermundus.com/pages/tkz/graph/ (in latex.html)
Both links to the Python documentation at programming.html#dicionarios are dead
sagetex.html has (este link deve leválo a uma cópia local do guia de instalação para mais informações de como proceder.
but in any case "este link" is wrong because there is no pt installation guide. I say remove that whole bit.
Sorry for the laundry list, but I find that you and I have a good workflow on this sort of thing! It's really very close to being done, thanks for helping shepherd some of these lesspopular tickets to completion.
comment:46 Changed 6 years ago by
(Which is all to say that these are cosmetic changes intended to make sure that users coming to this aren't confronted with tons of bad links; this is basically ready to go.)
comment:47 Changed 6 years ago by
 Commit changed from 61fdeb577cc6a043bb2f0013a7835e74b7b0fb30 to 9dc3771aea869eaa342c98e535bc3d7681af2230
Branch pushed to git repo; I updated commit sha1. New commits:
9dc3771  trac #12822 more care about the links

comment:48 in reply to: ↑ 44 Changed 6 years ago by
Replying to kcrisman:
Whenever I do the docbuild with
warnlinks
I get[tutorial ] /Users/.../sage/src/doc/pt/tutorial/interactive_shell.rst:403: WARNING: envvar reference target not found: EDITORbut not without that, and not if I docbuild a second time. I'm not sure if that matters, unless perhaps we no longer have an
EDITOR
variable? I'm cc:ing a couple people who know what that flag does better than I do.
I don't think this matters. The issue is that :envvar:`EDITOR`
can create a crossreference to an entry in a construction like .. envvar:: name
. We only use the :envvar:`...`
markup to typeset environment variables consistently, not for the crossreferencing. So in fact you will get lots of such errors if you build the installation manual with warnlinks
, because there are lots of environment variables discussed there.
comment:49 Changed 6 years ago by
 Status changed from needs_work to positive_review
Okay, then anything else I saw is also a problem in the actual tutorial, soooo let's get this in!!! Awesome.
comment:50 Changed 6 years ago by
 Branch changed from u/chapoton/12822 to 9dc3771aea869eaa342c98e535bc3d7681af2230
 Resolution set to fixed
 Status changed from positive_review to closed
In
doc/pt/tutorial/programming.rst
Removed untranslated "preparsing", should have used "préprocessamento".
I know I commented about "macro" not having a proper translation in pt_BR, but it is already so commonly used, that it should be better to use it instead of "função" (english function).
Remaining looks good, but I still make considerations about conversion and coercion, that by themselves are also confusing in english, and pt_BR makes things worse by having several translations for coercion, most of which are about forced to do something, slavering, etc :)
It is also funny that "coercion" accordingly to sage documentation stand for "implicit conversion", but common lisp has the function "coerce" that is used for "explicit conversion".