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.
- 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.
- 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.
- Clone the GitHub repository, as described on the main page of this site.
- Set mathbook/examples/sample-article as your working directory.
- Issue the command
xsltproc ../../xsl/mathbook-html.xsl sample-article.xml
- Open derivatives.html in your web browser.
- In mathbook/examples again,
xsltproc ../../xsl/mathbook-latex.xsl sample-article.xml
- Process derivatives.tex with pdflatex, or to see Unicode font examples, process with xelatex.
To experiment further:
- Read the comments at the top of sample-article.xml with more general procedures for building documents, both HTML and PDF.
- 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.
- Experiment with some of the other examples in the subdirectories of the examples directory.
- Read the first two chapters (or more!) of the Author's Guide, linked off the Documentation page.
- Return to the Gallery on this site and peruse projects that make their source XML publicly available.
- 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.