Overview
Byte is the magazine published by the Computer Engineering department at Sharif University of Technology. I designed and built its website as a fully static site.
Why a static site generator
Articles are written by students and published on an irregular schedule. That shapes the requirements more than traffic does: contributors need to submit prose without operating a CMS, and the site should not carry a database and an application server for content that changes a few times a term.
Docusaurus fits because articles are Markdown files in the repository. Writing an article means opening a pull request, which gives review and version history for free from tooling the department already uses. The output is static files, so hosting is trivial and there is no runtime to keep patched.
Mathematics
A computer engineering magazine carries real notation, and images of equations are a poor substitute — they do not scale, do not respond to theme changes, and are invisible to search and screen readers. KaTeX renders LaTeX notation directly at build time, so equations arrive as text with correct typography and no client-side rendering cost.
Deployment
GitHub Actions builds and deploys on every merge to the main branch. Merging a contributor's article publishes it, with no separate step for anyone to forget.