Sage Tutorial

[Mike OS]

I just posted a revision of the tutorial I've been writing with David Monarres.
It is at my website
http://www-rohan.sdsu.edu/~mosulliv/Courses/sdsu-sage-tutorial/index.html
http://www-rohan.sdsu.edu/~mosulliv/Courses/sdsu-sage-tutorial/html.tar
http://www-rohan.sdsu.edu/~mosulliv/Courses/sdsu-sage-tutorial/SDSUSageTutorial.pdf

We'd love to have others contribute material.
(Creative Commons 3.01 license)
David Monarres has a bitbucket site for it.

http://bitbucket.org/ayeq123/sdsu-sage-tutorial

This may not be the best long term option. 
I may take it over, but he has the technical savvy.
We would welcome any suggestions.

Could someone update the previous version on the Sage website?

Thanks to those who commented previously. 
Please dive in if you'd like to improve it.

Mike

[Raniere Gaia Silva]

Hi Mike,
I like very much of your tutorial.

IMHO, will be great replace 'A Tour of Sage' with your tutorial. When
I start using Sage I have a lot of troubles after reading the 'Sage
Tutorial'.

And I will like to translate it to portuguese. Please notify me.

Raniere

> --
> You received this message because you are subscribed to the Google Groups
> "sage-edu" group.
> To view this discussion on the web visit
> https://groups.google.com/d/msg/sage-edu/-/i9d77EesNV8J.
> To post to this group, send email to sage...@googlegroups.com.
> To unsubscribe from this group, send email to
> sage-edu+u...@googlegroups.com.
> For more options, visit this group at
> http://groups.google.com/group/sage-edu?hl=en.

[kcrisman]

On Friday, October 26, 2012 3:59:16 PM UTC-4, Mike OS wrote:

I just posted a revision of the tutorial I've been writing with David Monarres.
It is at my website
http://www-rohan.sdsu.edu/~mosulliv/Courses/sdsu-sage-tutorial/index.html
http://www-rohan.sdsu.edu/~mosulliv/Courses/sdsu-sage-tutorial/html.tar
http://www-rohan.sdsu.edu/~mosulliv/Courses/sdsu-sage-tutorial/SDSUSageTutorial.pdf

Great to see this finally finished!  I wonder whether this would be appropriate for the standard documentation.  Apropos of which, you may be interested in (somewhat) parallel work done by Jason Grout, Rob Beezer, and myself which did recently make it in 

http://sagemath.org/doc/prep/index.html

aimed somewhat more at college faculty than students.  

In my view, the more stuff *easily* findable, the better.  We can use more thematic tutorials as well...

[Minh Nguyen]

Hi Mike,

On Sat, Oct 27, 2012 at 6:59 AM, Mike OS <mosu...@math.sdsu.edu> wrote:
> Could someone update the previous version on the Sage website?

Done.

--
Regards,
Minh Van Nguyen
http://bit.ly/mvngu

[Andrey Novoseltsev]

So, where is it linked on the main website?

Also - was it tested and if yes for what version? It still has

sage: integral(f, x,0,1)
x |--> 1

with a comment

On Oct 26, 8:03 pm, Minh Nguyen <mvngu.n...@gmail.com> wrote:
> Hi Mike,
>

[Andrey Novoseltsev]

Sorry for half-post before.

So, where is it linked on the main website? I'd like to give a link to
my students.

Also - was it tested and if yes for what version? It still has
sage: integral(f, x,0,1)
x |--> 1

with a comment:
In each case above, Sage returns a function as its result. Each of
these functions is a constant function, which is what we would expect.

But this is not what we expect and it was fixed in
http://trac.sagemath.org/sage_trac/ticket/12438

Thank you!
Andrey

On Oct 26, 8:03 pm, Minh Nguyen <mvngu.n...@gmail.com> wrote:

> Hi Mike,

[Minh Nguyen]

Hi Andrey,

On Tue, Oct 30, 2012 at 12:42 PM, Andrey Novoseltsev <novo...@gmail.com> wrote:
> So, where is it linked on the main website? I'd like to give a link to
> my students.

The tutorial is linked at

http://www.sagemath.org/help.html#furtherResources

Look for "Sage Tutorial by Mike O'Sullivan, Ryan Rosenbaum, and David Monarres".

[Andrey Novoseltsev]

Ah, thanks Minh! I was trying to find it in the standard
documentation.

Andrey

On Oct 29, 7:50 pm, Minh Nguyen <mvngu.n...@gmail.com> wrote:
> Hi Andrey,
>

[Mike OS]

Hi Raniere,

I'm sorry for the delay replying.  I've been at a conference and had a difficult time getting to my google groups.

I'm glad you like the tutorial.  Let me know if you I can be of with the translation.

I am wondering how updates to the tutorial will be smoothly integrated with the translated versions.

If you want to communicate directly with me:

mosul...@mail.sdsu.edu

Cheers

Mike

[Raniere Gaia Silva]

Hi,

> I am wondering how updates to the tutorial will be smoothly integrated with the translated versions.

Last week I try the Sphinx's internationalization module
(http://sphinx-doc.org/latest/intl.html). What I want to known and
maybe help answer Mike's questions is why Sage don't use this module
of Sphinx.

Thanks,
Raniere

[kcrisman]

On Friday, November 2, 2012 5:52:34 AM UTC-4, Raniere Gaia Silva wrote:

Hi,

> I am wondering how updates to the tutorial will be smoothly integrated with the translated versions.

This doesn't even happen with the standard documentation :( though it's understandable, given the effort that would entail.

 

Last week I try the Sphinx's internationalization module
(http://sphinx-doc.org/latest/intl.html). What I want to known and
maybe help answer Mike's questions is why Sage don't use this module
of Sphinx.

Does this do automatic idiomatic translations for you?  If it would help keep track of changes and alert translators to them, that would be a step, but it's not easy to translate the Sage materials, as those who have perused the long wait times for various ones to get into Sage will have noted :(

- kcrisman 

[Raniere Gaia Silva]

> Does this do automatic idiomatic translations for you?

No. The module use gettext to generate a file with the text to be
translate and a location where the translate must be write. After
that, Sphinx read the original file and the translation to generate
the documentation. It welp keep track the translation update using the
program msgmerge.

Raniere