0cafb3e
Draft
committed
Commits
Comments (0)
Files changed (7)

+39 23Classroom.html

+18 13Help.html

+7 5Intro.html

+68 59NextSteps.html

+19 16Started.html

+10 4WhySage.html

+7 3index.html
Classroom.html
<p>If the reader has come this far, she probably is ready to start talking about how to use Sage in
+<p>If the reader has come this far, she probably is ready to start talking more about how to use Sage in
<p>What should we say about this? My main point is that whether it is used as a cheat sheet or used
for showing people how to do certain things, it's good. Maybe start pointing to great examples, like
John Perry's at USM or some of Rob Beezer's, or something? Probably that is a good idea. But we want
+<p>What should we say about this? My main point is that whether it is used as a cheat sheet or used
+for showing people how to do certain things, it's good. Maybe start pointing to great examples, like
+John Perry's at USM or some of Rob Beezer's, or something? Probably that is a good idea. But we want
Help.html
similar to resources such as <a href="http://mathoverflow.net">MathOverflow</a> or <a href="http://answers.yahoo.com/">Yahoo! Answers</a>.</p>
Intro.html
<p>Although many readers will have used comprehensive mathematics software before, we will assume <em>no</em> background knowledge here. Further, although one can easily download and use Sage on a variety of operating systems, our goal is to demonstrate actual classroom use, and hence we'll focus on how to get started using <em>only</em> the notebook interface.</p>
<p>So to follow along, open up another browser window and get ready to use Sage! Standardscompliant browsers like Firefox are best, but most modern browsers should work just fine.</p>
+<p>So to follow along, open up another browser window and get ready to use Sage! Standardscompliant browsers like Firefox are best, but most modern browsers should work just fine.</p>
+<p>If you are already comfortable with the idea of evaluating cells and want to get right to the good stuff,
+please go to the <a href="Mathematics.html">"Doing Mathematics with Sage" section</a>. You can either follow along
+with the commands in a Sage notebook session, at a Sage cell server like <a href="http://aleph.sagemath.org/">http://aleph.sagemath.org/</a>,
NextSteps.html
<p>Thanks to <a href="" target="_blank" class="external" title="Open external site in a new window">the
class="external" title="Open external site in a new window">jsmath</a>, you can put much more in Sage
+<p>Thanks to <a href="" target="_blank" class="external" title="Open external site in a new window">the
+class="external" title="Open external site in a new window">jsmath</a>, you can put much more in Sage
+than Mathematics  making it perfect for making class notes. FIXME: By the time this is published, probably MathJax?</p>
<p>Recall that between any two "computation cells" there is a thin blue line waiting, which a scroll
<p>Go over one such line, but do <em>not</em> click. Instead, first press (and hold down) the Shift key.
<em>Then</em> click, while still holding the Shift key. Once you let go, a tiny word processor should open up.
+<p>Go over one such line, but do <em>not</em> click. Instead, first press (and hold down) the Shift key.
+<em>Then</em> click, while still holding the Shift key. Once you let go, a tiny word processor should open up.
<p>Simply typing will behave as normal. There are buttons for ordered and unordered lists, various typefaces,
<b>bold</b>, <em>italic</em>, and so forth. This is especially useful for annotating class notes; however,
it is also heavily used for putting brief <em>formatted</em> explanations in research worksheets as well.</p>
<p>Once one is done (this is a WYSIWYG editor, so it should look pretty much like the output), one can
+<p>Once one is done (this is a WYSIWYG editor, so it should look pretty much like the output), one can
<p>Because a Sage worksheet is a webpage as well, and in this article we assume it is being accessed through
the internet and not locally, it is incredibly helpful to take advantage of web links. For instance,
+the internet and not locally, it is incredibly helpful to take advantage of web links. For instance,
the authors often will use this to put in a reference to a reference to more information about a mathematical
<p>Sage uses the same technology as sites like <a href="http://www.ams.org/mathscinet/index.html">MathSciNet</a>
+<p>Sage uses the same technology (FIXME: jsmath or MathJax?) as sites like <a href="http://www.ams.org/mathscinet/index.html">MathSciNet</a>
a TinyMCE editor in the notebook, but this time put some dollar signs around some math notation.</p>
<p>Once you close the window, things should render properly. It's possible to do quite complicated things. FIXME: Screenshot</p>
<p>It can take a while to render a long worksheet, but it's well worth it; things look much more professional,
+<p>Once you close the window, things should render properly. It's possible to do quite complicated things.</p>
+<p>It can take a while to render a long worksheet, but it's well worth it; things look much more professional,
<p>The user aimed at in this article is one who has used the computer mostly in a graphical interface,
so we focus on the notebook. However, once one has gained minimal facility with Sage, it can be nice to
have direct access to Sage. This could be for a oneoff computation for which opening a new worksheet
+<p>The user aimed at in this article is one who has used the computer mostly in a graphical interface,
+so we focus on the notebook. However, once one has gained minimal facility with Sage, it can be nice to
+have more direct access to Sage. This could be for a oneoff computation for which opening a new worksheet
<p>The first thing you will need is a connection to a Sage program that is not on the web. This could
+<p>The first thing you will need is a connection to a Sage program that is not on the web. This could
be on a college network, or in a local copy. Most readers would probably just use a local Sage on their
<p>In either case, the next thing to do is open a terminal window of some kind. If you do not know what that means,
then this section is not for you. In fact, the developers of Sage are pretty explicit about believing that the
main interaction with Sage shouldbe through the browser, because it is so much easier to share and see.</p>
+main interaction with Sage should always be possible through the browser, because it is so much easier to share and see.</p>
<p>Once you are there, you will need to "cd" to the directory in which Sage is located. This will probably look
Many people will make an alias so they can just use "sage"; adding the Sage directory to your "PATH"
+<p>There are a few particularly useful options to the "sage" command which access different things.
<li>"sage maxima", "sage gap", and so forth, will start version of the constituent programs.</li>
+<li>"sage maxima", "sage gap", and so forth, will start version of the constituent programs.</li>
However, in reality one often wants to work when the wider web is not available. What should you do
+However, in reality one often wants to work when the wider web is not available. What should you do
<p>Luckily, Sage is just a free download away! It is easiest to go to <a href="http://www.sagemath.org"
target="_blank" class="external" title="Open external site in a new window">the Sage website</a> and
follow instructions there for your system, but we also provide brief instructions here for starting up a
notebook server right on your own computer. You should also note that this is the easiest way to obtain
+<p>Luckily, Sage is just a free download away! It is easiest to go to <a href="http://www.sagemath.org"
+target="_blank" class="external" title="Open external site in a new window">the Sage website</a> and
+follow instructions there for your system, but we also provide brief instructions here for starting up a
+notebook server right on your own computer. You should also note that this is the easiest way to obtain
+the current <a href="http://wiki.sagemath.org/SageApplianceInstallation">Sage Appliance installation instructions</a> and
<li>Open VirtualBox, and import Sage by clicking 'File', then 'Import Appliance'. FIXME: Screenshot?</li>
+There are <em>many</em> screenshots and much more detailed information in the instruction links above,
<p>A more native Windows solution has been in the works for a long time, but we simply lack the manpower
<p>On Mac, there is a native app that can be downloaded from the Sage website. Here are a few useful
<li>The app will start up in the browser you have set (in Safari) as your default browser. You can also
+<li>The app will start up in the browser you have set as your default browser (this preference is located in Safari's
+preferences). You can also choose to have none of those, and use a minibrowser included in the app.</li>
<li>A <em>very</em> useful tool is to have a menu item along the top of the screen for Sage, where you can
start a command line or browser as you wish (as well as several more advanced items). This makes it
+start a command line or browser as you wish (as well as several more advanced items). This makes it
We cannot currently doubleclick Sage worksheet files to open them in Sage, but this functionality is
<p>There are binaries on the Sage page for most major Linux distributions. If you don't find yours there,
+<p>There are binaries on the Sage page for most major Linux distributions. If you don't find yours there,
+it is not hard to download the source and compile it. Ask the Sage support list or at <a href="http://ask.sagemath.org/questions/">ask.sagemath.org</a>
<p>Previous: <a href="Classroom.html" class="internal">How to Use Sage in the Classroom</a>  Up: <a href="index.html#Contents" class="internal">Contents</a>  Next: <a href="WhySage.html" class="internal">Why Sage?</a></p>
Started.html
<p>Since this article is itself online, we assume that you have access to some server running Sage  most
window">this one</a>. However, it is easy to use the same interface on an <a href="NextSteps.html#Offline" class="internal">offline
+<p>Since this article is itself online, we assume that you have access to some server running Sage  most
+window">this one</a>. However, it is easy to use the same interface on an <a href="NextSteps.html#Offline" class="internal">offline
+<p>(If you want to simply try out Sage commands in a <a href="http://aleph.sagemath.org/">cell server</a>
+or to see what they look like first, just skip ahead to <a href="Mathematics.html">"Doing Mathematics with Sage"</a>.)</p>
<p>Most of the time, a Sage user will simply evaluate commands of her own choosing; however, particularly in a situation with many users all needing the same content, one can also upload a worksheet directly to Sage or edit a previously "published" worksheet.</p>
<p>No matter when you use Sage, if you intend to use it through a browser, then you'll have to log in!</p>
+FIXME: it seems pointless to update the screenshots, but should we at least mention that they should
syntax from scratch to do homework. Instead, we will usually provide something predigested, so that
+syntax from scratch to do homework. Instead, we will usually provide something predigested, so that
options. Key here is that one can upload a worksheet on one's local computer <b>or</b> enter a URL for any worksheet available on the internet.
In fact, <a href="">here</a> is a specific URL to upload the worksheet with all examples from this article.</p>
+options. Key here is that one can upload a worksheet on one's local computer <b>or</b> enter a URL for any worksheet available on the internet.
+In fact, <a href="FIXME">here</a> is a specific URL to upload the worksheet with all examples from this article.</p>
WhySage.html
<p>But many other programs are proprietary. This particularly bothered the founder of Sage, William Stein,
computational number theory, but then not be able to afford the software it was implemented in. Starting
from scratch, he started a new program based on the Python language to glue together many other pieces.</p>
+from scratch, he started a new program based on the Python language; it was not long before he glued in
<p>Over the past several years, these pieces (including Maxima, GAP, Pari, MathJax, and many others)
+were added to many, many thousands of lines of new code to provide a comprehensive system. And it's
a system that is licensed in such a way that improvements to it will always be fully available to the
+entire mathematical community, no matter how many resources one has. <a href="http://www.sagemath.org/developmentack.html">Funding
+support</a> has come from the NSF and other government agencies, Sun, Google, and Microsoft, as well as many
<p>This approach is also quite friendly to pedagogy, because we can actually point students to the underlying
+it's also possible for them to directly contribute. <a href="http://wiki.sagemath.org/prep/2012">MAA PREP workshops</a>
<p>Though Sage's mission is to be a viable alternative to similar proprietary software, the developers do not
of the places mentioned in the section on <a href="Help.html" class="internal">help</a> are great places to ask. For
those who don't mind signing up for a developer account on <a href="http://trac.sagemath.org/sage_trac/">the Sage Trac</a>
of bugs and enhancement requests, you can create a ticket there complete with details of what went wrong.</li>
+<li>Along similar lines, there is a new community <a href="http://interact.sagemath.org/">Sage interact database</a>
+as a place to share functionality snippets, and which provides a great opportunity for sharing ideas.</li>
<li>Finally, for those who don't mind actually typing a little bit in the actual files or have some programming experience,
<a href="https://groups.google.com/forum/?fromgroups#!forum/sagedevel">Sage developer list</a> for details:
index.html
 <li><a href="Classroom.html#Sharing" class="internal">Sharing and Publishing Sage Worksheets</a></li>