<h2 id="NewContent">Adding Content - Word Processing, links, and LaTeX</h2>
-<p>Thanks to <a href="" target="_blank" class="external" title="Open external site in a new window">the
-mini-word processor TinyMCE</a> and a TeX rendering engine called <a href="" target="_blank"
-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: Or MathJax?</p>
+<p>Thanks to <a href="" target="_blank" class="external" title="Open external site in a new window">the
+mini-word processor TinyMCE</a> and a TeX rendering engine called <a href="" target="_blank"
+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>Here, we give a small sample of what is
+<p>Here, we give a small sample of what is
<p>Recall that between any two "computation cells" there is a thin blue line waiting, which a scroll
over with the mouse reveals. Clicking on this line gives a new computational cell.</p>
-<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.
This is where one can do just about any normal word processing one wishes.</p>
-<p>FIXME: Add screenshots.</p>
+<img src="screenshots/ShiftClick.png" />
<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>FIXME: Screenshot with a few of these.</p>
+<img src="screenshots/StrikeThrough.png" />
-<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
close the editor with the button, or press Shift-Enter as in evaluating a cell; either option will
close the editor and give nicely formatted text.</p>
<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
-object, or to some fun site like the <a href="http://www.mersenne.org">Great Internet Mersenne
+object, or to some fun site like the <a href="http://www.mersenne.org">Great Internet Mersenne
Prime Search</a>. Course management system sites or course home pages are also useful links.</p>
-<p>Adding a link is easy inside the editor.
+<p>Adding a link is easy inside the editor.
<li>Open the editor.</li>
<li>Type some text to be linked.</li>
<li>Highlight the exact text which will be linked.</li>
-<li>Click on the icon for a web link. (FIXME: picture)</li>
+<li>Click on the icon for a web link (see screenshot below).</li>
<li>Put in the <em>entire</em> address, including "http://", of the link.</li>
-<li>(Alternately, you may want to choose the "open in new window" option.)</li>
+<li>(Optionally, you may want to choose the "open in new window" option.)</li>
<li>Close the web link window, and the editor.</li>
Your link should now work!</p>
+<img src="screenshots/WebLink.png" />
-<p>One of the most annoying things about most word processing for mathematicians
-is that it can be tedious to insert formulas. What we wouldn't give for just being able to
-put dollar signs around "x^2" and have it instantly be understood.</p>
+<p>One of the most annoying things about most word processing for mathematicians
+is that it can be tedious to insert formulas. What wouldn't we give for just being able to
+put dollar signs around "x^2" and have it instantly be understood?</p>
-<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>
and <a href="http://mathoverflow.net/">Math Overflow</a> to make this easy. Once again, open up
a TinyMCE editor in the notebook, but this time put some dollar signs around some math notation.</p>
-<p>FIXME: Add a screenshot</p>
+<img src="screenshots/AddLaTeX.png" />
-<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,
-and easier to understand for your students.</p>
+<p>Once you close the window, things should render properly. It's possible to do quite complicated things.</p>
+<img src="screenshots/LaTeXAdded.png" />
+<p>It can take a while to render a long worksheet, but it's well worth it; things look much more professional,
+and are easier to understand for your students.</p>
<h2 id="CommandLine">What if I want a command line?</h2>
-<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 one-off 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 one-off computation for which opening a new worksheet
seems overly much, or to interact more easily with the computer itself.</p>
-<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
computer, so see <a href="Started.html#Offline">below</a> for how to do that.</p>
<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 should be 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
-like "sage-4.7.1" or something similar. Then simply type "./sage", and you are on your way.
+like "sage-4.7.1" or something similar. Then simply type "./sage", and you are on your way.
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 commands.
+<img src="screenshots/Terminal.png" />
+<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>
<li>"sage -notebook" will start your very own notebook server.</li>
+<li>"sage -advanced" will give you a complete list of advanced commands.</li>
<h2 id="Offline">How do I use Sage offline?</h2>
-<p>Most of this article assumes that one is using Sage through a notebook browser on the internet.
-However, in reality one often wants to work when the wider web is not available. What should you do
+<p>Most of this article assumes that one is using Sage through a notebook browser on the internet.
+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
<a href="Evaluate.html#CommandLine" class-"internal">command line</a> access to Sage.</p>
<h4 id="Windows">Windows</h4>
-<p>On Windows, the current best option is through a virtual machine. These instructions are from
+<p>On Windows, the current best option is through a virtual machine. These instructions are from
+the current <a href="http://wiki.sagemath.org/SageApplianceInstallation">Sage Appliance installation instructions</a> and
+<a href="http://wiki.sagemath.org/SageAppliance">usage instructions</a>.
<li>First, download <a href="http://www.virtualbox.org/wiki/Downloads">VirtualBox</a>, a free
-virtual machine system. Version 4 or later is required.</li>.
-<li>Go to the <a href="http://www.sagemath.org">Sage website</a> and
+virtual machine system. Version 4 or later is required.</li>
+<li>Go to the <a href="http://www.sagemath.org/download-windows.html">Sage website</a> and
download the file Sage-x.y.z.ova corresponding to the current version of Sage.</li>
-<li>Open VirtualBox, and import Sage by clicking 'File', then 'Import Appliance'. FIXME: Screenshot?</li>
-<li>You choose a password, and can then use the notebook as you ordinarily would.</li>
+<li>Open VirtualBox, and import Sage by clicking 'File', then 'Import Appliance'.</li>
+<li>Power on the Sage appliance, and the notebook should start up.</li>
-There are <em>much</em> more detailed instructions in the README.txt located where the .ova file
-is downloaded, and we encourage reading them.</p>
+There are <em>many</em> screenshots and much more detailed information in the instruction links above,
+as well as the README.txt where the .ova file is downloaded; we encourage reading them.</p>
-<p>A more native Windows solution has been in the works for a long time, but we simply lack the manpower
-to finish it off. Sage welcomes volunteers!</p>
<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
-choose to have none of those, and use a mini-browser included in the app.</li>
+<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 mini-browser 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
-very easy to start up a Sage session whenever you want. FIXME: Screenshot</li>
+start a command line or browser as you wish (as well as several more advanced items). This makes it
+very easy to start up a Sage session whenever you want. <img src="screenshots/MenuBar.png" /></li>
+<li>Naturally, you can also access the Sage program from the Terminal program if you wish.</li>
-We cannot currently double-click Sage worksheet files to open them in Sage, but this functionality is
-in the review process.</p>
+FIXME: The ability to double-click Sage worksheet files is coming in the near future.</p>
<h4 id="Linux">Linux</h4>
-<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.</p>
-<p>FIXME: Make this more detailed</p>
+<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>
+with any issues. Sage also works on Solaris and FreeBSD.</p>
<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>