64 lines
2.2 KiB
Markdown
64 lines
2.2 KiB
Markdown
<!-- markdownlint-disable MD013 -->
|
|
<!-- markdownlint-disable MD040 -->
|
|
|
|
# Site
|
|
|
|
Personal portfolio website at gugulet.hu. Three sections: Words, Visuals, Technical.
|
|
|
|
## Architecture
|
|
|
|
```
|
|
content/ Source content (Markdown, assets, templates)
|
|
assets/css/ Per-page stylesheets
|
|
assets/js/ JavaScript (GSAP animations, loader, protection)
|
|
assets/fonts/ Custom fonts (ttf)
|
|
assets/media/ Images, favicons
|
|
overrides/ Jinja2 templates (extends Zensical theme)
|
|
index.md Homepage
|
|
resume.md Resume page
|
|
deploy/ Generated static site (build output)
|
|
zensical.toml Build config (site metadata, extensions, theme)
|
|
minify.py Post-build CSS/JS/HTML minification
|
|
Dockerfile Multi-stage build (Zensical builder + Caddy server)
|
|
```
|
|
|
|
## Build and serve
|
|
|
|
```bash
|
|
# Development
|
|
source .venv/bin/activate
|
|
zensical serve --watch
|
|
|
|
# Production build
|
|
zensical build
|
|
rm ./deploy/sitemap.xml
|
|
python minify.py
|
|
|
|
# Docker
|
|
docker build -t site:latest .
|
|
docker run -p 80:80 site:latest
|
|
```
|
|
|
|
## Key conventions
|
|
|
|
- **Zensical** (MkDocs-based) static site generator with `zensical.toml` as single config source.
|
|
- **Markdown + YAML frontmatter** for all content. Each page declares its template, extra_css, and extra_js.
|
|
- **Jinja2 templates** in `content/overrides/` extend the Zensical base theme.
|
|
- **GSAP + ScrollTrigger** for homepage scroll animations. No other JS frameworks.
|
|
- **Per-section typography:** serif (Words), monospace (Technical), display (Visuals).
|
|
- **CSS custom properties** for theming. Responsive sizing via `clamp()` and viewport units.
|
|
- **Post-build minification** via `minify.py` (terser for JS, clean-css for CSS, inline for HTML). Preserves `<pre>`/`<code>` blocks.
|
|
- **No database.** Fully static output served by Caddy.
|
|
- **Content protection:** `protect.js` prevents right-click and copying.
|
|
- **Anti-AI crawling:** meta robots tag with `noai, noimageai`.
|
|
|
|
## CI/CD
|
|
|
|
GitHub Actions runs Vale prose linting and MegaLinter on push/PR to main. Fail on errors.
|
|
|
|
## Dependencies
|
|
|
|
```bash
|
|
pip install -r requirements.txt # Python (Zensical, Jinja2, pymdown-extensions)
|
|
npm install -g terser clean-css-cli # Node (minification)
|
|
```
|