sws2tex /

Filename Size Date modified Message
967 B
2.4 KB
761.1 KB
18.5 KB
5.6 KB
188 B
16.3 KB
###############################################################################
#   Sage: Open Source Mathematical Software
#       Copyright (C) 2009-2010 Wilfried Huss <huss@finanz.math.tugraz.at>
#       Copyright (C) 2009-2010 Robert Marik <marik@mendelu.cz>
#  Distributed under the terms of the GNU General Public License (GPL),
#  version 2 or any later version.  The full text of the GPL is available at:
#                  http://www.gnu.org/licenses/
###############################################################################

Program sws2tex
---------------

The program sws2tex converts worksheet written in computer algebra
system Sage (http://www.sagemath.org) from sws file into a LaTeX file
and compiles the LaTeX file into nice formatted PDF.

The features include:
* conversion of font types, colors and faces. Syntax highlight.
* conversion of tables, hyperlinks and images (including external
  images, excluding 3D images rendered by jmol plugin)
* customizing several options (language of the document, author's
  name, table of contents, ignoring unknown HTML tags, handling hidden
  input cells) in command line parameters or in a configuration file
* the sws file is attached to the resulting PDF and hence the
  worksheet can be restored from the PDF file easily

The script attempts to parse Sage and HTML constructions using
Python's HTMLParser module.

Installation
------------
No special installation is necessary. Simply download the files
included in sws2tex distribution from
http://bitbucket.org/whuss/sws2tex/ and put the scripts to your
desired location.

You may want to customize the file .sws2tex_example, rename to
.sws2tex and put into your home directory. You need working Sage and
LaTeX installation. If the worksheet contains links to external
images, the images are downloaded by using wget utility.

Usage
-----
Run the file sws2tex.py to see command line parameters and a list of
available options and switches.

You may want to use the file conversion.sws to test most of the
supported features.


Reporting bugs
--------------
Use the "Issues" capability at http://bitbucket.org/whuss/sws2tex/ or
report problems to email addresses of the authors.


Acknowledgment
--------------
The second author (Robert Marik) s supported by the grant 131/2010 of
the Fund for Development of Czech Universities (FRVS, project "Using
open source software in teaching mathematics").
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.