Skip to main content

Getting Started with PreTeXt

Section Writing and Authoring

Can I convert my existing files to PreTeXt?
Partially. PreTeXt.Plus includes a -to-PreTeXt converter, and Pandoc can produce rough PreTeXt source from .tex. Treat either tool’s output as a starting point that will likely need cleanup. For documents that are mostly prose and basic math, this is still faster than starting from scratch.
How do I include images?
This topic is outside the scope of this tutorial . Put the image file (PNG, JPG, or SVG) in your assets folder and reference it with <image source="filename.png"/>. Add a <shortdescription> for the alt text. See What You, the Author, Must Do for details. You can also generate figures using TikZ or PGFPlots, and PreTeXt will produce accessible SVG output automatically. For mathematical diagrams, PreFigure is also worth knowing: the same source can support tactile diagrams and accessibility annotations. See the PreTeXt overview of PreFigure.
Can exercises be auto-graded?
Yes, when the document is hosted on Runestone Academy. True/false, multiple-choice, fill-in-the-blank, matching, and clickable-area exercises are all auto-graded with per-answer feedback. If you host on GitHub Pages or embed them into your LMS instead, the exercises still display and work interactively, but they are not tracked in a gradebook.
What controls numbering?
PreTeXt numbers definitions, theorems, examples, exercises, and figures automatically in the order they appear. Cross-references update themselves when you reorganize. This is one of the big wins over word processors: numbers are always consistent, and you never have to fix them by hand.