# About

A lightweight XML application for authors of research articles, textbooks and monographs.

The best of DocBook, LaTeX, and HTML.

Outputs: print, PDF, web, and soon, EPUB, Jupyter Notebooks, …

(Before June 2017, PreTeXt was called “MathBook XML”, so many of those references remain.)

# Discuss

Authors, readers, and developers congregate on Google Groups (in addition to GitHub issues). The support forum is the easiest, quickest, most accurate way to get help from experienced authors, even if you are just starting out, and have only read the Author's Guide once.

- Support forum/mailing-list:
`pretext-support` - Announcements only, low-volume:
`pretext-announce` - Feature discussions and implementation:
`pretext-dev`

The inactive `mathbook-xml-support` group can be searched for old questions and their answers.

# Code

Fork the repository at GitHub (GPL license).

OR, install `git` on your system, then at a command line: `git clone https://github.com/rbeezer/mathbook.git`

And then it is easy to update, and you should do this regularly (daily):

cd mathbook

git checkout dev`git pull`

You can download a zip file of the `dev` branch for initial experiments, but it will very quickly become out-of-date, so this is not recommended. Take the time to setup and become comfortable with “pulling” as described above.

# Gallery

- A First Course in Linear Algebra (Beta) [Mature Prototype]
- The book that started it all, available now as the functional prototype, and the partially converted PreTeXt version (which is not yet reliable enough to study from). (2016-01-02)
- Abstract Algebra: Theory and Applications [Print] [Source]
- This is a comprehensive undergraduate mathematics textbook for a year-long course, which has been converted to PreTeXt from LaTeX. The PreTeXt version debuted for the 2015-16 academic year and displays many of the capabilities of PreTeXt, especially multiple output formats. (2017-08-16)
- Active Calculus [PDF] [Hardcopy - coming soon] [Source]
- From Matthew Boelkins, David Austin, and Steven Schlicker at Grand Valley State University: “There are very few worked examples in the text, with there instead being 3-4 activities per section that engage students in connecting ideas, solving problems, and developing understanding of key calculus concepts; each section begins with motivating questions, a brief introduction, and a preview activity, all of which are designed to be read and completed prior to class; following the WeBWorK exercises in each section, there are several challenging problems that require students to connect key ideas and write to communicate their understanding.” [Home] [Active Calculus Multivariable]. (2017-08-16)
- Number Theory: In Context and Interactive
- "Karl-Dieter Crisman's Number Theory: In Context and Interactive is a free textbook for an upper-level (US) number theory course, with a clear vision to expose students to the connections to all areas of mathematics. There are many exercises, both proof-based and computational, and nearly every concept can be visualized or experimented with using the open source mathematics software SageMath." This is an excellent example of using the Sage Cell Server to run interactive point-and-click demonstrations. (2017-01-26)
- The Ordinary Differential Equations Project [Web Version] [Print]
- A “work in progress,” features extensive computational examples and high-quality graphics created by Sage. (2016-01-02)
- Geometry, with an introduction to Cosmic Topology [Web Version] [Print]
- Originally published by Jones & Bartlett in 2009, now freely available in print and online from PreTeXt source. (2017-08-09)
- Music Theory for the 21st-Century Classroom [Web Version]
- A “work in progress,” but well underway, features musical notation, score snippets, and embedded YouTube video examples. (2017-08-09)
- Introduction to Computer Organization: ARM Assembly Language Using the Raspberry Pi by Bob Plantz
- Computer science textbook for super-affordable hardware, a work-in-progress. This is being derived from a similar text, Introduction to Computer Organization with x86-64 Assembly Language & GNU/Linux, which you can see has many of the features of PreTeXt. (2016-04-24)
- Applied Combinatorics by Mitch Keller and William Trotter [HTML][PDF]][Print, $15] [Source]
- Comprehensive undergraduate textbook on basic and advanced combinatorial techniques, discrete structures, discrete optimization, and other topics. CC-BY-SA license. (2017-08-09)
- Explorations in Algebraic Graph Theory with Sage [Source]
- Research monograph with many embedded Sage cells.
- The Story of 8 by Mike Hitchman [Source]
- A very light-hearted experiment in PreTeXt authoring and publishing, which also showcases a variety of features. Source available. (2017-08-09)
- Applied Discrete Structures [Source]
- Undergraduate mathematics textbook for computer science students, dating to 1984. Recently released as open source, and now being converted from previous formats, starting in late 2015. (2016-01-04)
- Calculus Lab Manual [Print] [Source]
- From Portland Community College, a supplement for a standard differential calculus course. Alex Jordan has customized PreTeXt in places and some of his improvements will migrate into the mainline distribution. More information is available, including color and electronic PDFs. (2015-08-28)
- A Modeling Approach to Calculus
- Lecture notes for a calculus course, in-progress with regular updates through Spring 2017. (2017-08-09)
- A Second Course in Linear Algebra [Source]
- A mathematics textbook (in progress). And the beginnings of a friendly fork. (2017-08-09)
- Linear Algebra Workbook [Source]
- Textbook supplement for an inquiry-based approach to teaching linear algebra. Includes an example of custom extensions, “tasks”. (2014-12-01)
- Extended Echelon Form and Four Subspaces [Published PDF]
- The first article written in PreTeXt was this short note for the American Mathematical Monthly in Summer 2013. LaTeX output (slightly edited) was sent to the publisher as the original submission. Since then, the XML source has been edited to keep up with revisions requested by the publisher and to keep up with changes to PreTeXt. You can compare the web version with the PDF of the published version. A few very minor differences will be ironed out as PreTeXt matures.
- Financial Mathematics [Source]
- John Travis, at Mississippi College has started a textbook on financial mathematics for his course on the topic. Be sure to look at the Sage interacts such as in the chapter on Bonds. (2016-03-21)
- Probability [Source]
- John Travis, at Mississippi College has started a textbook on probability for his course on the topic. (2016-03-21)
- Math 1220, Linear Algebra I, University of Manitoba
- Michael Doob has made materials for his course available online using PreTeXt. (2016-02-20)
- OpenMathDocs [XML Source]
- Modelling-based approach to pre-calculus materials. Using a forked version of PreTeXt and contributing back changes. In-progress.
- Treatises III, IV, V by Jahrme Risner
- Undergraduate term project, Fall 2015. (Treatises I and II are available as PDFs here). (2016-04-24)
- Third-Order Tensor Decompositions and Their Application in Quantum Chemistry
- Undergraduate term paper by Tyler Ueltschi, Spring 2014. (2014-05-01)

# Presentations

Authoring Online Open Textbooks with MathBook XML, Robert Beezer, David Farmer. Second International Conference on Mathematics Textbook Research and Development, Rio de Janiero, Brazil, May 2017.

Open Software and Open Textbooks for Mathematics, Robert Beezer. Korean Mathematical Society Invited Lecture, Annual Spring Meeting of the Korean Mathematical Society, Chosun University, Gwangju, Korea, April 2017.

Textbooks for the Web from MathBook XML, Robert Beezer. Presentation from the 2017 US Joint Mathematics Meetings as the WEBSIGMAA Guest Lecture. A good introduction to open textbooks and PreTeXt. Includes more technical details than usual, with a good example of source XML converted to LaTeX and HTML. To mimic the demonstration portion of the talk, explore the online version of Tom Judson's Abstract Algebra: Theory and Applications.

WeBWorK-MathBook XML Bridge, Robert Beezer, Alex Jordan. A project from Summer 2015 to incorporate WeBWork problems into PreTeXt documents, supported by OpenOregon.org and the University of Puget Sound. Report of the project's work in a streaming webinar, along with plenty of technical hiccups, especially a gap from about 34 minutes to 43 minutes. December 2015.

Mathematics Department Colloquium, Robert Beezer. University of Manitoba, Manitoba, Canada. May 2015.

Overview talk at Sage Edu Days 6: Part 1 Part 2, Robert Beezer. June 2014.

History talk at University of Puget Sound Math/CS Department Seminar: Modern Textbooks for Modern Times, Robert Beezer. September 2014.

# Supporters

- National Science Foundation
- A two-year $700,000 grant has been awarded to the UTMOST Project through the NSF Improving Undergraduate STEM Education program. (Award No. 1626455) The project will perform an educational research study into the design and use of online textbooks with embedded computational examples. (September 2016–August 2018)
- University of Puget Sound
- Arts, Humanities, Social Sciences Summer Research for Undergraduates Summer 2016. Jahrme Risner is a Mellon Humanities Research Scholar and his project is to add support to PreTeXt for various features that will be useful for arts and humanitites scholars. Examples include: poetry, bibliographies, musical scores, historical timelines, font support, and translations.
- American Institute of Mathematics
- Author workshop, April 25-29, 2016.
- University of Puget Sound
- Course Release Unit Grant, Spring 2016, for PreTeXt development.
- OpenOregon and University of Puget Sound
- “Enabling Successful, Accessible OER in Mathematics with a WeBWorK-MathBook XML Bridge”, with Alex Jordan, Michael Gage, Goeff Goehle, Summer 2015. Funding from Oregon Community College Distance Learning Association with a matching grant from the University of Puget Sound. [HTML] [PDF]
- Michael Doob and the The University of Manitoba
- “Faculty of Science Online and Blended Learning Development Grant,” Summer 2015.
- University of Puget Sound
- Course Release Unit Grant, Spring 2014, for textbook writing, which aided design decisions.
- Shuttleworth Flash Grant
- Initial support, Summer and Fall 2013.
- UTMOST
- Undergraduate Teaching of Mathematics and Open Software and Textbooks, National Science Foundation (Grant No. DUE-1022574), Summer 2013.