MathBook XML
Write Once, Read Anywhere

Some short directions to get started very quickly. Complete documentation is at the documentation page. See link at the bottom of this page for videos.

  1. Prerequisite: if you do not already have xsltproc then install it. See the Tools page for more detail, including how you can easily check if you have it.
  2. You will want to do the following at a command-line (i.e. terminal, console). Or use a terminal provided by SageMathCloud which has everything you need: xsltproc, git, LaTeX, and an XML-aware editor (CodeMirror). There is zero setup required after you (easily) create a free account.
  3. Clone the GitHub repository, as described on the main page of this site.
  4. Set mathbook/examples/sample-article as your working directory.
  5. Issue the command xsltproc ../../xsl/mathbook-html.xsl sample-article.xml
  6. Open derivatives.html in your web browser.
  7. In mathbook/examples again, xsltproc ../../xsl/mathbook-latex.xsl sample-article.xml
  8. Process derivatives.tex with pdflatex, or to see Unicode font examples, process with xelatex.

To experiment further:

  1. Read the comments at the top of sample-article.xml with more general procedures for building documents, both HTML and PDF.
  2. Copy the sample-article directory into some other directory with a new name. Start adding in new material of your own near the beginning and customizing what is already there.
  3. Experiment with some of the other examples in the subdirectories of the examples directory.
  4. Read the first two chapters (or more!) of the Author's Guide, linked off the Documentation page.
  5. Return to the Gallery on this site and peruse projects that make their source XML publicly available.
  6. Participate in the Google Group (listed on the main page).

Video Quick Starts

Much of the above is covered, for Linux/SageMathCloud, Mac and Windows, in the Getting Started Videos.