Personal website and technical blog of Kévin THÉRAGE — Symfony Lead Developer, Expert Symfony 7 Certified.
Built with Cecil (PHP static site generator), Twig, and Bootstrap. Bilingual EN/FR. Deploys to GitHub Pages from main.
- PHP 8.5+
- Node.js 22+
- Cecil (
php cecil.phar) - Composer (for PHP linting tools)
# Build the site
make build
# Start dev server with watcher
make dev
# Open http://localhost:8080├── cecil.yml # Cecil configuration
├── pages/ # Content (Markdown)
│ ├── index.md # Homepage (EN)
│ ├── index.fr.md # Homepage (FR)
│ ├── about-me.md # About page
│ ├── legal.md # Legal notices
│ └── blog/ # Blog posts by year
│ └── 2026/
│ ├── my-post.md
│ └── my-post.fr.md
├── layouts/ # Twig templates
├── assets/ # Pipeline-managed (CSS, JS, images)
├── static/ # Verbatim-copied (fonts, favicons)
├── translations/ # i18n catalogs (EN/FR)
├── data/ # YAML data files
├── extensions/ # Custom Cecil extensions
├── tests/ # E2E tests (Gherkin + Cucumber.js)
│ ├── features/ # .feature files
│ ├── steps/ # Step definitions
│ └── support/ # World class & hooks
├── doc/adr/ # Architecture Decision Records
└── .github/workflows/ # CI/CD
- Posts live in
pages/blog/<year>/<slug>.md - French translations: same slug, same year folder —
<slug>.fr.md - URLs:
/blog/<year>/<slug>/— slugs use hyphens, never underscores - Required frontmatter:
title,date,description,cover,published,tags,excerpt - When a URL changes: add
alias: /old/url/(Cecil generates meta-refresh redirects for GitHub Pages)
| Command | Description |
|---|---|
make build |
Clear cache + build site to _site/ |
make dev |
Dev server with watcher on localhost:8080 |
make lint |
Twig lint + HTML structural checks |
make test-e2e |
Run E2E tests (headless, Cucumber.js) |
make test-e2e-ui |
Same tests, headed + Playwright Inspector |
make validate-llmstxt |
Validate LLM feed files |
make banner |
Regenerate banner PNG from SVG |
Tests use Cucumber.js with Playwright as the browser engine, interpreting Gherkin .feature files.
# Run all tests
make test-e2e
# Run specific feature
npx cucumber-js tests/features/theme-toggle.feature
# Interactive: headed browser, Playwright Inspector pauses on each scenario
make test-e2e-uiFeature files follow strict Gherkin conventions:
Given= preconditions / stateWhen= actionsThen= assertions (must contain "should")Andcontinues the previous step type
Three GitHub Actions workflows:
deploy.yml— Build + deploy to GitHub Pages on push tomainlint.yml— Twig lint + HTML structural checkse2e.yml— E2E tests via Cucumber.js + Playwright
All workflows require PHP 8.5+ and Node.js 22+.
ADRs are stored in doc/adr/ using the log4brains format:
| ADR | Title |
|---|---|
| 001 | Cecil configuration conventions |
| 002 | Twig template conventions |
| 003 | E2E test architecture |
| 004 | Deployment and SEO |
| 005 | Social media publishing |
Personal website — all rights reserved.