MathTech.org

Public website for MathTechOrg.

The site is generated by Jekyll, based on the Minimal Mistakes template.

Posts

To submit a blog entry, create a md file in the _posts directory. Look for examples of posts there for formatting help.

Author bios in the sidebar are enabled for posts by default. Each author must have an entry in _data/authors.yml.

Then for a single author, add this to the post's metadata (matching the author's key in _data/authors.yml):

author: levin

Or for multiple authors, use:

authors:
	- levin
	- clontz

Building the site

When the site is pushed to github, it will automatically rebuild. To preview locally, run bundle exec jekyll serve. Note, some changes to _config.yml require stopping and starting this, while other changes to the site should be automatically incorporated.

See the Minimal Mistakes Documentation for more.

PR previews

This repo now includes a PR preview workflow at .github/workflows/pr-preview.yml.

For each pull request update, it:

1. Builds the site with Jekyll.
2. Deploys to Cloudflare Pages for a hosted preview URL.
3. Posts or updates a sticky PR comment with the preview link.

This gives reviewers a consistent way to preview rendered pages without running Jekyll locally.

Cloudflare Pages setup (optional)

If you want hosted preview links directly in PRs, set up Cloudflare Pages once and add repo settings.

1. In Cloudflare, create a Pages project (or use an existing one).
   • Project name should match CLOUDFLARE_PAGES_PROJECT exactly.
2. In GitHub repo settings, add Repository variables:
   • CLOUDFLARE_ACCOUNT_ID: your Cloudflare account ID
   • CLOUDFLARE_PAGES_PROJECT: the Cloudflare Pages project name
3. In GitHub repo settings, add Repository secret:
   • CLOUDFLARE_API_TOKEN: Cloudflare API token with Account -> Cloudflare Pages -> Edit
4. In Cloudflare, create the API token at My Profile -> API Tokens -> Create Token -> Custom token and scope it to the specific account.
5. Open or update a PR. The workflow will deploy _site and include preview status in the PR comment.
6. Open the PR Deployments panel to click through to the hosted Cloudflare preview URL.

Notes:

• Cloudflare deploy is skipped automatically if these vars/secrets are missing.
• Cloudflare deploy is also skipped for forked PRs for security.
• No local artifact or screenshot is generated by this workflow.