First template

.gitea/workflows/deploy.yml

@@ -0,0 +1,57 @@
+name: Deploy Hugo site
+
+on:
+  push:
+    branches:
+      - main
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@v4
+
+      - name: Install Hugo
+        run: |
+          set -eu
+          HUGO_VERSION="0.145.0"
+          install -d "$HOME/.local/bin"
+          wget -q "https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
+          tar -xzf "hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz"
+          mv hugo "$HOME/.local/bin/hugo"
+          export PATH="$HOME/.local/bin:$PATH"
+          hugo version
+
+      - name: Build site
+        run: |
+          export PATH="$HOME/.local/bin:$PATH"
+          hugo --minify
+
+      - name: Configure SSH key
+        env:
+          DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }}
+        run: |
+          set -eu
+          install -d -m 700 ~/.ssh
+          printf '%s\n' "$DEPLOY_SSH_KEY" > ~/.ssh/id_ed25519
+          chmod 600 ~/.ssh/id_ed25519
+
+      - name: Trust deployment host
+        env:
+          DEPLOY_HOST: ${{ secrets.DEPLOY_HOST }}
+          DEPLOY_PORT: ${{ secrets.DEPLOY_PORT }}
+        run: |
+          set -eu
+          ssh-keyscan -p "$DEPLOY_PORT" -H "$DEPLOY_HOST" >> ~/.ssh/known_hosts
+
+      - name: Upload generated site
+        env:
+          DEPLOY_HOST: ${{ secrets.DEPLOY_HOST }}
+          DEPLOY_PATH: ${{ secrets.DEPLOY_PATH }}
+          DEPLOY_PORT: ${{ secrets.DEPLOY_PORT }}
+          DEPLOY_USER: ${{ secrets.DEPLOY_USER }}
+        run: |
+          set -eu
+          rsync -az --delete -e "ssh -p $DEPLOY_PORT" public/ "$DEPLOY_USER@$DEPLOY_HOST:$DEPLOY_PATH/"

.gitignore

@@ -0,0 +1,3 @@
+/public/
+/resources/
+.hugo_build.lock

README.md

@@ -2,7 +2,12 @@
 
 This repository hosts my personal website and project portfolio.
 
-The site is built with [Hugo](https://gohugo.io/), a fast static site generator, and is intended to showcase my work, projects, background, and selected professional information in a simple and maintainable format.
+The site is built with [Hugo](https://gohugo.io/), and this repository now includes a minimal custom Hugo setup with:
+
+- a homepage
+- a projects section
+- reusable layouts
+- custom styling without an external theme
 
 ## Purpose
 
@@ -61,7 +66,7 @@ The generated files will be placed in the `public/` directory.
 
 ## Project Structure
 
-Typical Hugo projects use a structure similar to the following:
+This repository currently follows a structure similar to the following:
 
 ```text
 .
@@ -70,12 +75,11 @@ Typical Hugo projects use a structure similar to the following:
 ├── content/
 ├── layouts/
 ├── static/
-├── themes/
+├── hugo.toml
-├── config.toml
 └── README.md
 ```
 
-Depending on the Hugo version and configuration style, the main config file may also be named `hugo.toml`, `hugo.yaml`, or `hugo.json`.
+Depending on the Hugo configuration style, the main config file may also be named `config.toml`, `hugo.yaml`, or `hugo.json` in other projects.
 
 ## Content Management
 
@@ -86,6 +90,23 @@ Portfolio content is generally managed through the `content/` directory. Typical
 - updating images and downloadable assets in `static/`
 - adjusting layouts and partials in `layouts/`
 
+The current starter content is in:
+
+- `content/_index.md`
+- `content/projects/_index.md`
+- `content/projects/*.md`
+
+The current templates are in:
+
+- `layouts/index.html`
+- `layouts/_default/list.html`
+- `layouts/_default/single.html`
+- `layouts/partials/`
+
+The current styles are in:
+
+- `assets/css/main.css`
+
 To create a new content page:
 
 ```bash
@@ -105,6 +126,76 @@ Typical deployment options include:
 
 Deployment generally consists of building the site with Hugo and publishing the contents of the `public/` directory.
 
+### Automated Deployment With Gitea
+
+If your repository is hosted on Gitea, a practical approach is to use Gitea Actions with a workflow that:
+
+- runs on every push to `main`
+- builds the Hugo site
+- uploads the generated `public/` directory to your server over SSH
+
+This repository includes a starter workflow in `.gitea/workflows/deploy.yml`.
+
+This assumes Gitea Actions is enabled and that you have at least one runner available for the repository.
+
+To use it, you need a Gitea runner and the following repository secrets:
+
+- `DEPLOY_HOST`: hostname or IP of your server
+- `DEPLOY_PORT`: SSH port, usually `22`
+- `DEPLOY_USER`: SSH user used for deployment
+- `DEPLOY_PATH`: target directory served by your web server
+- `DEPLOY_SSH_KEY`: private SSH key for the deployment user
+
+Example target path:
+
+```text
+/var/www/portfolio
+```
+
+Typical server-side setup:
+
+- create a dedicated deployment user
+- add the matching public SSH key to `~/.ssh/authorized_keys`
+- configure Nginx or Caddy to serve the deployment directory
+- ensure the deployment user has write permission on the target directory
+
+#### Nginx Example
+
+An example Nginx server block is included in `deploy/nginx/portfolio.conf`.
+
+Typical installation steps on the server:
+
+1. copy the config to `/etc/nginx/sites-available/portfolio.conf`
+2. update `server_name` with your real domain
+3. keep the `root` aligned with `DEPLOY_PATH`, for example `/var/www/portfolio`
+4. enable the site with a symlink into `/etc/nginx/sites-enabled/`
+5. test the configuration with `nginx -t`
+6. reload Nginx with `systemctl reload nginx`
+
+Example commands:
+
+```bash
+sudo cp deploy/nginx/portfolio.conf /etc/nginx/sites-available/portfolio.conf
+sudo ln -s /etc/nginx/sites-available/portfolio.conf /etc/nginx/sites-enabled/portfolio.conf
+sudo nginx -t
+sudo systemctl reload nginx
+```
+
+If your server already uses HTTPS, keep Nginx terminating TLS and serving the files from `/var/www/portfolio`. If you do not yet have HTTPS, a common next step is to issue a certificate with Let's Encrypt and Certbot.
+
+The deployment flow is then:
+
+1. push changes to `main`
+2. Gitea Actions builds the site with `hugo --minify`
+3. the workflow synchronizes `public/` to the server with `rsync`
+4. Nginx serves the static files directly from the deployment directory
+
+If you prefer, this can also be adapted to:
+
+- deploy to a Docker container
+- publish to object storage such as S3-compatible hosting
+- trigger a remote script on your server after upload
+
 ## Notes
 
 - keep content in Markdown for simple maintenance

archetypes/default.md

@@ -0,0 +1,7 @@
+---
+title: "{{ replace .File.ContentBaseName "-" " " | title }}"
+date: {{ .Date }}
+draft: true
+description: ""
+tags: []
+---

assets/css/main.css

@@ -0,0 +1,253 @@
+:root {
+  --bg: #f3efe6;
+  --surface: rgba(255, 250, 240, 0.86);
+  --surface-strong: #fff9ef;
+  --text: #1e1a16;
+  --muted: #6d6258;
+  --line: rgba(30, 26, 22, 0.12);
+  --accent: #b44f2f;
+  --accent-dark: #7e3018;
+  --shadow: 0 20px 60px rgba(77, 55, 33, 0.12);
+}
+
+* {
+  box-sizing: border-box;
+}
+
+html {
+  scroll-behavior: smooth;
+}
+
+body {
+  margin: 0;
+  color: var(--text);
+  background:
+    radial-gradient(circle at top left, rgba(180, 79, 47, 0.16), transparent 28%),
+    radial-gradient(circle at 85% 20%, rgba(113, 142, 106, 0.22), transparent 20%),
+    linear-gradient(180deg, #f7f2e8 0%, var(--bg) 100%);
+  font-family: Georgia, "Times New Roman", serif;
+  line-height: 1.6;
+}
+
+a {
+  color: inherit;
+  text-decoration: none;
+}
+
+p,
+li {
+  color: var(--muted);
+}
+
+.page-shell {
+  width: min(1120px, calc(100% - 2rem));
+  margin: 0 auto;
+}
+
+.site-header {
+  position: sticky;
+  top: 0;
+  z-index: 10;
+  backdrop-filter: blur(14px);
+  background: rgba(247, 242, 232, 0.72);
+  border-bottom: 1px solid var(--line);
+}
+
+.header-inner,
+.footer-inner {
+  display: flex;
+  align-items: center;
+  justify-content: space-between;
+  gap: 1rem;
+  padding: 1rem 0;
+}
+
+.brand {
+  font-size: 1.1rem;
+  font-weight: 700;
+  letter-spacing: 0.08em;
+  text-transform: uppercase;
+}
+
+.site-nav,
+.footer-links {
+  display: flex;
+  gap: 1rem;
+  flex-wrap: wrap;
+}
+
+.site-nav a,
+.footer-links a {
+  color: var(--muted);
+}
+
+.hero {
+  display: grid;
+  grid-template-columns: 1.5fr 1fr;
+  gap: 2rem;
+  padding: 4rem 0 2rem;
+}
+
+.hero-copy,
+.hero-panel,
+.project-card,
+.section-alt,
+.project-single {
+  background: var(--surface);
+  border: 1px solid var(--line);
+  border-radius: 28px;
+  box-shadow: var(--shadow);
+}
+
+.hero-copy {
+  padding: 3rem;
+}
+
+.hero-panel {
+  padding: 2rem;
+  align-self: end;
+}
+
+.hero h1,
+.section h1,
+.section h2,
+.project-card h2,
+.project-card h3 {
+  color: var(--text);
+  line-height: 1.05;
+  margin: 0;
+}
+
+.hero h1 {
+  font-size: clamp(2.8rem, 7vw, 5.8rem);
+  margin-top: 0.2rem;
+}
+
+.hero-text,
+.section-text,
+.lead {
+  font-size: 1.1rem;
+  max-width: 62ch;
+}
+
+.eyebrow,
+.meta,
+.panel-label {
+  text-transform: uppercase;
+  letter-spacing: 0.14em;
+  font-size: 0.78rem;
+  color: var(--accent-dark);
+}
+
+.hero-actions,
+.project-links {
+  display: flex;
+  gap: 0.75rem;
+  flex-wrap: wrap;
+  margin-top: 1.5rem;
+}
+
+.button {
+  display: inline-flex;
+  align-items: center;
+  justify-content: center;
+  min-height: 46px;
+  padding: 0.75rem 1.2rem;
+  border-radius: 999px;
+  border: 1px solid transparent;
+  font-weight: 700;
+}
+
+.button-primary {
+  background: var(--accent);
+  color: #fff7f2;
+}
+
+.button-secondary {
+  border-color: var(--line);
+  background: transparent;
+  color: var(--text);
+}
+
+.section {
+  padding: 2rem 0;
+}
+
+.section-heading {
+  margin-bottom: 1.25rem;
+}
+
+.card-grid {
+  display: grid;
+  grid-template-columns: repeat(2, minmax(0, 1fr));
+  gap: 1.25rem;
+}
+
+.project-card,
+.project-single,
+.section-alt {
+  padding: 1.75rem;
+}
+
+.tag-list {
+  list-style: none;
+  display: flex;
+  flex-wrap: wrap;
+  gap: 0.6rem;
+  padding: 0;
+  margin: 1rem 0 0;
+}
+
+.tag-list li {
+  padding: 0.3rem 0.7rem;
+  border-radius: 999px;
+  background: rgba(180, 79, 47, 0.08);
+  color: var(--accent-dark);
+}
+
+.tag-list-spaced {
+  margin-bottom: 2rem;
+}
+
+.content-body h2,
+.content-body h3 {
+  color: var(--text);
+  margin-top: 2rem;
+}
+
+.content-body ul {
+  padding-left: 1.25rem;
+}
+
+.site-footer {
+  padding: 2rem 0 3rem;
+}
+
+@media (max-width: 860px) {
+  .hero,
+  .card-grid,
+  .header-inner,
+  .footer-inner {
+    grid-template-columns: 1fr;
+    flex-direction: column;
+    align-items: flex-start;
+  }
+
+  .hero-copy {
+    padding: 2rem;
+  }
+}
+
+@media (max-width: 560px) {
+  .page-shell {
+    width: min(100% - 1.2rem, 1120px);
+  }
+
+  .hero {
+    padding-top: 2rem;
+  }
+
+  .hero h1 {
+    font-size: 2.6rem;
+  }
+}

content/_index.md

@@ -0,0 +1,4 @@
+---
+title: "Home"
+description: "Portfolio homepage"
+---

content/projects/_index.md

@@ -0,0 +1,6 @@
+---
+title: "Projects"
+description: "A selection of projects from my portfolio."
+---
+
+This section highlights recent work, experiments, and case studies.

content/projects/design-system.md

@@ -0,0 +1,19 @@
+---
+title: "Design System"
+date: 2026-03-10T10:00:00Z
+draft: false
+description: "A reusable UI system for consistent product interfaces."
+summary: "Component patterns, documentation, and shared visual rules for product teams."
+tags: ["Design", "Frontend", "Components"]
+weight: 20
+project_url: "https://example.com/"
+featured: false
+---
+
+This project documents a reusable approach to interface consistency across multiple products.
+
+## Scope
+
+- reusable components
+- spacing and typography rules
+- documentation for contributors

content/projects/portfolio-platform.md

@@ -0,0 +1,20 @@
+---
+title: "Portfolio Platform"
+date: 2026-03-16T10:00:00Z
+draft: false
+description: "A modular portfolio website built with Hugo."
+summary: "A fast static portfolio built to present projects with clarity and maintainability."
+tags: ["Hugo", "Static Site", "Portfolio"]
+weight: 10
+project_url: "https://example.com/"
+repo_url: "https://github.com/"
+featured: true
+---
+
+This project is the foundation of my personal website. It focuses on speed, straightforward content management, and a clean presentation of selected work.
+
+## Highlights
+
+- static generation for fast page loads
+- lightweight structure with reusable templates
+- project-first content organization

deploy/nginx/portfolio.conf

@@ -0,0 +1,21 @@
+server {
+    listen 8090;
+    listen [::]:8090;
+    server_name portfolio.bouchard.sytes.net;
+
+    root /var/www/portfolio;
+    index index.html;
+
+    access_log /var/log/nginx/portfolio.access.log;
+    error_log /var/log/nginx/portfolio.error.log;
+
+    location / {
+        try_files $uri $uri/ =404;
+    }
+
+    location ~* \.(?:css|js|jpg|jpeg|gif|png|svg|ico|webp|woff2?)$ {
+        expires 7d;
+        add_header Cache-Control "public, max-age=604800, immutable";
+        try_files $uri =404;
+    }
+}

hugo.toml

@@ -0,0 +1,23 @@
+baseURL = "https://example.com/"
+languageCode = "en-us"
+title = "Ludovic Portfolio"
+
+[params]
+  author = "Ludovic"
+  role = "Developer"
+  tagline = "Selected projects, work, and experiments."
+  intro = "I build thoughtful digital products and showcase the projects that matter most."
+  email = "hello@example.com"
+  github = "https://github.com/"
+  linkedin = "https://www.linkedin.com/"
+
+[menus]
+  [[menus.main]]
+    name = "Home"
+    pageRef = "/"
+    weight = 10
+
+  [[menus.main]]
+    name = "Projects"
+    pageRef = "/projects"
+    weight = 20

layouts/_default/baseof.html

@@ -0,0 +1,18 @@
+<!DOCTYPE html>
+<html lang="{{ site.Language.LanguageCode | default `en-us` }}">
+  <head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1">
+    <title>{{ if .IsHome }}{{ site.Title }}{{ else }}{{ .Title }} | {{ site.Title }}{{ end }}</title>
+    <meta name="description" content="{{ with .Description }}{{ . }}{{ else }}{{ site.Params.intro }}{{ end }}">
+    {{ $styles := resources.Get "css/main.css" | minify | fingerprint }}
+    <link rel="stylesheet" href="{{ $styles.RelPermalink }}" integrity="{{ $styles.Data.Integrity }}">
+  </head>
+  <body>
+    {{ partial "header.html" . }}
+    <main class="page-shell">
+      {{ block "main" . }}{{ end }}
+    </main>
+    {{ partial "footer.html" . }}
+  </body>
+  </html>

layouts/_default/list.html

@@ -0,0 +1,28 @@
+{{ define "main" }}
+  <section class="section page-header">
+    <p class="eyebrow">Collection</p>
+    <h1>{{ .Title }}</h1>
+    {{ with .Content }}
+      <div class="section-text">{{ . }}</div>
+    {{ end }}
+  </section>
+
+  <section class="section">
+    <div class="card-grid">
+      {{ range .Pages.ByWeight }}
+        <article class="project-card">
+          <p class="meta">{{ .Date.Format "Jan 2, 2006" }}</p>
+          <h2><a href="{{ .RelPermalink }}">{{ .Title }}</a></h2>
+          <p>{{ with .Params.summary }}{{ . }}{{ else }}{{ .Description }}{{ end }}</p>
+          {{ with .Params.tags }}
+            <ul class="tag-list">
+              {{ range . }}
+                <li>{{ . }}</li>
+              {{ end }}
+            </ul>
+          {{ end }}
+        </article>
+      {{ end }}
+    </div>
+  </section>
+{{ end }}

layouts/_default/single.html

@@ -0,0 +1,30 @@
+{{ define "main" }}
+  <article class="section project-single">
+    <p class="eyebrow">Project</p>
+    <h1>{{ .Title }}</h1>
+    {{ with .Description }}
+      <p class="lead">{{ . }}</p>
+    {{ end }}
+
+    <div class="project-links">
+      {{ with .Params.project_url }}
+        <a class="button button-primary" href="{{ . }}">Live Project</a>
+      {{ end }}
+      {{ with .Params.repo_url }}
+        <a class="button button-secondary" href="{{ . }}">Source Code</a>
+      {{ end }}
+    </div>
+
+    {{ with .Params.tags }}
+      <ul class="tag-list tag-list-spaced">
+        {{ range . }}
+          <li>{{ . }}</li>
+        {{ end }}
+      </ul>
+    {{ end }}
+
+    <div class="content-body">
+      {{ .Content }}
+    </div>
+  </article>
+{{ end }}

layouts/index.html

@@ -0,0 +1,54 @@
+{{ define "main" }}
+  {{ $projects := where site.RegularPages "Section" "projects" }}
+  {{ $featured := where $projects "Params.featured" true }}
+  <section class="hero">
+    <div class="hero-copy">
+      <p class="eyebrow">{{ site.Params.role }}</p>
+      <h1>{{ site.Params.tagline }}</h1>
+      <p class="hero-text">{{ site.Params.intro }}</p>
+      <div class="hero-actions">
+        <a class="button button-primary" href="/projects/">View Projects</a>
+        <a class="button button-secondary" href="mailto:{{ site.Params.email }}">Contact</a>
+      </div>
+    </div>
+    <div class="hero-panel">
+      <p class="panel-label">Focus</p>
+      <ul>
+        <li>Portfolio-driven presentation</li>
+        <li>Fast static delivery with Hugo</li>
+        <li>Clean, maintainable content structure</li>
+      </ul>
+    </div>
+  </section>
+
+  <section class="section">
+    <div class="section-heading">
+      <p class="eyebrow">Selected Work</p>
+      <h2>Featured projects</h2>
+    </div>
+    <div class="card-grid">
+      {{ range $featured }}
+        <article class="project-card">
+          <p class="meta">{{ .Date.Format "Jan 2006" }}</p>
+          <h3><a href="{{ .RelPermalink }}">{{ .Title }}</a></h3>
+          <p>{{ with .Params.summary }}{{ . }}{{ else }}{{ .Description }}{{ end }}</p>
+          {{ with .Params.tags }}
+            <ul class="tag-list">
+              {{ range . }}
+                <li>{{ . }}</li>
+              {{ end }}
+            </ul>
+          {{ end }}
+        </article>
+      {{ end }}
+    </div>
+  </section>
+
+  <section class="section section-alt">
+    <div class="section-heading">
+      <p class="eyebrow">About this site</p>
+      <h2>Built to evolve with the portfolio</h2>
+    </div>
+    <p class="section-text">This Hugo setup is designed to make project updates straightforward. Add Markdown content, adjust templates when needed, and keep the site fast without introducing unnecessary complexity.</p>
+  </section>
+{{ end }}

layouts/partials/footer.html

@@ -0,0 +1,16 @@
+<footer class="site-footer">
+  <div class="page-shell footer-inner">
+    <p>{{ site.Title }}.</p>
+    <div class="footer-links">
+      {{ with site.Params.github }}
+        <a href="{{ . }}">GitHub</a>
+      {{ end }}
+      {{ with site.Params.linkedin }}
+        <a href="{{ . }}">LinkedIn</a>
+      {{ end }}
+      {{ with site.Params.email }}
+        <a href="mailto:{{ . }}">Email</a>
+      {{ end }}
+    </div>
+  </div>
+</footer>

layouts/partials/header.html

@@ -0,0 +1,10 @@
+<header class="site-header">
+  <div class="page-shell header-inner">
+    <a class="brand" href="/">{{ site.Title }}</a>
+    <nav class="site-nav" aria-label="Main navigation">
+      {{ range site.Menus.main }}
+        <a href="{{ .URL }}">{{ .Name }}</a>
+      {{ end }}
+    </nav>
+  </div>
+</header>