SageTeX / README

This is the SageTeX package. It allows you to embed code, results of
computations, and plots from the Sage mathematics software suite
(http://sagemath.org) into LaTeX documents.
====================================================================

SageTeX is included with Sage, so to use it, you only need to make the
file sagetex.sty known to TeX; that file will be in
SAGE_ROOT/local/share/texmf/tex/generic/sagetex, along with
documentation and examples. See the Sage installation guide at
http://sagemath.org/doc/installation/ for complete instructions and
http://sagemath.org/doc/tutorial/sagetex.html for a quick usage
introduction. The complete documentation is in sagetexpackage.pdf, in
the SAGE_ROOT/... directory mentioned above.

If you want to extract any of SageTeX's files from the .dtx sources, you
can do

  0. Run `latex sagetexpackage.ins'

To regenerate the documentation, do

  1. Run `latex sagetexpackage.dtx'
  2. Run `sage sagetexpackage.sage'
  3. Run the indexing commands that the .ins file told you about.
  4. Run `latex sagetexpackage.dtx' again.

You can skip step 3 if you don't care about the index. You will need the
pgf and tikz packages installed to typeset the figures.

The file example.tex has, as you likely guessed, a bunch of examples
showing you how this package works. You can compile it using a another
latex-sage-latex cycle as in steps 1-2-4 above. Note that example.tex
includes some PNG graphics which latex cannot use; to see those, use
pdflatex instead of regular latex or enable the imagemagick option. (See
the documentation.)

To use the SageTeX package with your own documents, see the
"Installation" section of the documentation.

SageTeX now includes `remote-sagetex.py', a plain Python script that
allows you to use a remote Sage server instead of a local Sage
installation, so now you can use SageTeX on any computer with TeX and
Python 2.6 installed.

This work builds on a lot of work by others; see the CONTRIBUTORS file
and the "Credits" section of the documentation for credits. The source
code may be modified and distributed under the terms of the GPL, version
2 or later; the documentation may be modified and distributed under a
Creative Commons Attribution - Share Alike 3.0 License. See the "Copying
and licenses" section of the documentation.

Please let me know if you find any bugs or have any ideas for
improvement!

- Dan Drake <http://mathsci.kaist.ac.kr/~drake/>
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.