Skip to main content

The PreTeXt Guide

Section 46.1 Setup

There are two components to processing your document, the PreTeXt stylesheets and the xsltproc program. We work at the command-line inside of a terminal or console . If you do not know what this is, it will seem very primitive at first. Sometimes the old ways are the best ways. This will be called a “Command Prompt” in Windows or a “Terminal” on a Mac. In Linux it may be known as a “console” or a “shell”. A tutorial, which is Linux-specific, can be found at Ryan’s Tutorials
 1 
ryanstutorials.net/linuxtutorial/
and certainly others exist.
The operating system on a Mac is built on Unix, which is very similar to Linux, so most of the directions here will be little changed between the two. Procedures can be very different in Windows (Appendix L ,Appendix M ). One alternative is CoCalc
 2 
cocalc.com
which provides a full Linux computer for free in your web browser, so that may be an excellent place for initial experiments (Section 5.14 ).

Step 1: PreTeXt.

You need to obtain the PreTeXt stylesheets, which are the main part of PreTeXt . Since you are reading this, it may be possible that you have this already. You can use git to clone the PreTeXt from the GitHub repository, and then be sure to checkout the dev branch to have the latest version. This is the best way to go, and you should only download the repository as a zip file once for an initial experiment, and then switch to using a clone instead.
Once you have a clone of the repository, you can issue git pull, and git will update your local copy with any recent changes. You should do this regularly — meaning on the order of daily. See the FAQ entry for more about why we expect you to do this.
See the PreTeXt site
 3 
pretextbook.org
for details and commands for this step, right on the main page.

Step 2: xsltproc.

This is the command-line program which takes your document and a PreTeXt stylesheet to together produce output. On Linux or a Mac you probably already have it installed as part of system software. On Windows it is not so simple.
In either case see the website for details abut verifying you have this, or how to install it.