This is the repository for the home page for PreTeXt, to be hosted at pretextbook.org.
The landing pages for the website are stored in the site directory, as markdown files. These are processed with Pelican to create the main pages.
However, most of the content in the site are builds of pretext documents. All this is controlled by build script: scripts/build.sh.
The static directory holds material that no build produces and is copied into the site as-is: CSS and Javascript of older PreTeXt versions (books built with those versions still load them from pretextbook.org), pages and images from earlier versions of the site, and the CNAME file for GitHub Pages. It was recovered from the Wayback Machine in October 2026, when the old server went down.
The workflow .github/workflows/build-site.yml runs scripts/build.sh ci on pushes to main, on pull requests, nightly, and on demand. It builds from the latest commits of PreTeXtBook/pretext, PreTeXtBook/pretext-projects, and BooksHTML/gfa. Runs on main deploy to GitHub Pages once the repository variable PAGES_DEPLOY is set to yes.
To build the pelican generated pages, from the site directory, run
pelican . -o ../output -s pelican_settings.pyThe easiest way to view the site is to spin up a python web server, using python -m http.server -d ../output/ (assuming you are still in the site directory).