Skip to content

Replace PDFs with markdown-rendered pages#184

Merged
ScriptRaccoon merged 17 commits into
mainfrom
upgrade-content-pages
May 16, 2026
Merged

Replace PDFs with markdown-rendered pages#184
ScriptRaccoon merged 17 commits into
mainfrom
upgrade-content-pages

Conversation

@ScriptRaccoon
Copy link
Copy Markdown
Owner

@ScriptRaccoon ScriptRaccoon commented May 15, 2026

Long proofs were previously provided as PDFs, along with their source files, and treated as static assets. In this PR, TeX files are replaced with Markdown files. PDF files are removed and replaced with Markdown-rendered content pages available under /content/[id].

The set-theoretic foundations page (which was already rendered from Markdown) is now also integrated into this system, and its route has been changed from /foundations to /content/foundations.

Advantages

Advantages of Markdown-rendered content pages over PDF files:

  • unified content format, reducing the number of ways content can be added
  • consistent styling and navigation with the rest of CatDat
  • ability to link to other pages within CatDat
  • support for dark mode
  • fully responsive layout (PDFs are difficult to read on mobile devices)
  • support for defined macros
  • no binary files (PDFs) in version control
  • no need to manually build and sync PDFs
  • improved accessibility (screen reader compatibility, text selection, copy paste)

Screenshots

Dark Mode + Mobile

screenshot

Light Mode + Desktop

screenshot

Plan

I plan to also replace lemmas with that system. See also #176 for some context.

@ScriptRaccoon
Copy link
Copy Markdown
Owner Author

ScriptRaccoon commented May 15, 2026

@varkor [nevermind, the problem is solved now]

@ScriptRaccoon ScriptRaccoon changed the title Upgrade content pages Convert pdf files to content pages May 15, 2026
@ScriptRaccoon ScriptRaccoon changed the title Convert pdf files to content pages Convert pdf files to markdown-rendered pages May 15, 2026
@ScriptRaccoon ScriptRaccoon changed the title Convert pdf files to markdown-rendered pages Replace pdf files with markdown-rendered pages May 15, 2026
@ScriptRaccoon ScriptRaccoon changed the title Replace pdf files with markdown-rendered pages Replace PDFs with markdown-rendered pages May 15, 2026
@ScriptRaccoon ScriptRaccoon force-pushed the upgrade-content-pages branch from 5770f77 to eba46ad Compare May 16, 2026 15:37
@ScriptRaccoon ScriptRaccoon force-pushed the upgrade-content-pages branch from 354d119 to 62c95ee Compare May 16, 2026 22:38
@ScriptRaccoon ScriptRaccoon force-pushed the upgrade-content-pages branch 2 times, most recently from 0e86bbf to 292efd0 Compare May 16, 2026 23:20
@ScriptRaccoon ScriptRaccoon force-pushed the upgrade-content-pages branch from 292efd0 to 2fd9606 Compare May 16, 2026 23:21
@ScriptRaccoon ScriptRaccoon marked this pull request as ready for review May 16, 2026 23:21
@ScriptRaccoon ScriptRaccoon merged commit 9edbc0c into main May 16, 2026
1 check passed
@ScriptRaccoon ScriptRaccoon deleted the upgrade-content-pages branch May 16, 2026 23:26
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant