Jorge Iranzo-Sánchez Personal Website

Personal website built with Pelican static site generator.

Quick Start

# Install dependencies
uv sync

# Generate website
uv run python generate.py

# Preview locally (development server)
uv run pelican content -l -r -s pelicanconf.py

Then open http://localhost:8000 in your browser.

Project Structure

.
├── content/
│   ├── pages/           # Content pages (Markdown)
│   │   ├── about.md
│   │   ├── publications.md
│   │   ├── projects.md
│   │   ├── demos.md
│   │   └── contact.md
│   └── extras/          # Static demo pages
│       ├── simulstream-hybrid/
│       └── simulstream-client/
├── theme/               # Pelican theme
│   ├── templates/
│   └── static/
│       ├── css/web20.css
│       └── js/web20.js
├── output/              # Generated HTML (deploy this)
├── pelicanconf.py       # Pelican settings
├── publishconf.py       # Production settings
└── generate.py          # Build script

Development

Adding Content

Edit Markdown files in content/pages/. Run uv run python generate.py to regenerate.

Editing the Theme

• CSS: theme/static/css/web20.css
• Templates: theme/templates/base.html
• JS: theme/static/js/web20.js

Demo Pages

The Simulstream demo pages are static HTML files in content/extras/. They are copied to output/extras/ during build.

• Hybrid demo: content/extras/simulstream-hybrid/index.html - Requires Simulstream server
• Client demo: content/extras/simulstream-client/index.html - Browser-based (ONNX Runtime Web)

Deployment to GitHub Pages

Option 1: User/Organization Site (username.github.io)

1. Create a new repository named username.github.io
2. Push the contents of output/ to the main branch

cd output
git init
git add .
git commit -m "Deploy website"
git remote add origin https://github.com/username/username.github.io.git
git push -u origin main

Option 2: Project Site (username.github.io/repo-name)

1. Create a repository named your-repo
2. Push output/ contents to gh-pages branch

cd output
git init
git checkout -b gh-pages
git add .
git commit -m "Deploy website"
git remote add origin https://github.com/username/your-repo.git
git push -u origin gh-pages

3. Enable GitHub Pages in repository settings → Pages → Source: gh-pages

Option 3: Using the deploy script

# Edit publishconf.py with your repository URL first
# Then run:
uv run python generate.py
cd output
# Initialize git and push as shown above

Custom Domain (Optional)

1. Create output/CNAME with your domain (e.g., jorge-iranzo.com)
2. Configure your DNS to point to GitHub Pages
3. Add custom domain in repository settings

Content Updates

1. Edit content in content/pages/*.md
2. Run uv run python generate.py
3. Commit and push output/ to your GitHub Pages branch

Technologies Used

• Pelican - Static site generator
• Markdown - Content format
• Jinja2 - Template engine
• uv - Python package manager
• Chart.js - Latency visualization
• Web Audio API - Microphone capture (demo)
• ONNX Runtime Web - Client-side inference (demo)