Skip to content

cuinixam/cuinixam.github.io

Repository files navigation

My personal website

CI Status uv Ruff pypeline pre-commit


This is my personal website at maxiniuc.com.

How it's built

Two builders, one output directory:

  • Sphinx + ABlog renders the blog (build/docs/blogs/**). That's all Sphinx does.
  • jarvis landing (a small typer CLI in src/jarvis/) renders the landing page from JSON data files and copies the presentation / notebook directories into the build root.

The principle is "Sphinx for blogs only." Everything else is hand-crafted HTML/CSS/JS, generated from data files so there is exactly one source of truth per piece of content.

See AGENTS.md for the architecture in detail and the "where do I add X" table.

Build

The project uses pypeline to orchestrate the build. Install it once:

pipx install pypeline-runner

Then build everything (Sphinx blog + jarvis landing, into build/docs/):

pypeline run

Always use pypeline run to regenerate the site — running sphinx-build on its own only produces the blog pages and a stub index.html, leaving the landing and about pages stale.

VS Code tasks for the common commands live in .vscode/tasks.json.

About

https://cuinixam.github.io/

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors