# lux.harlelux.de

Meine persönliche Website mit Portfolio. Node.js und Express, die Seiten werden mit Nunjucks auf dem Server gerendert. Inhalte liegen als YAML und Markdown auf der Platte, gepflegt werden sie über ein paar Admin-Seiten, die nur im Heimnetz erreichbar sind.

## Entwicklung

Node 24 (siehe `.nvmrc`).

```sh
npm install
ADMIN_PASSWORD=test npm run dev   # Seite auf :3000, Admin auf :3001/admin
npm test
```

Im Dev-Modus sind Entwürfe auf der Seite sichtbar und bekommen ein Badge. Ohne `ADMIN_PASSWORD` bleiben die Admin-Seiten aus.

## Inhalte

Es gibt zwei Ordner:

- `content/` im Repo: Startinhalte und alles, was es im Admin nicht gibt (Texte und Kacheln der Startseite in `home.yml`).
- `data/` auf dem Server, nicht im Repo: alles, was über die Admin-Seiten bearbeitet wird.

Beim allerersten Start wird der bearbeitbare Teil von `content/` nach `data/` kopiert (Projekte, Werdegang, Profil, Homelab). Danach gilt nur noch `data/`, spätere Änderungen an diesen Dateien im Repo werden ignoriert.

```
data/
  site.yml          Name, Pronomen, Links, Skills, "Gerade dran"
  journey.yml       Stationen für den Werdegang
  homelab.yml       Hardware und Dienste
  pages/            Werdegang und Homelab als <name>.de.md / <name>.en.md
  projects/<slug>/  meta.yml, de.md, en.md und die Bilder
```

Die Dateien lassen sich auch von Hand bearbeiten, die Seite lädt sie bei Änderungen neu. Texte, die in beiden Sprachen gleich sind, stehen als einfacher String, sonst als `{ de, en }`.

## Admin-Seiten

Laufen im selben Container auf einem eigenen Port (im Container 3001, auf dem Server `ADMIN_HOST_PORT`, Standard 3051). Über `lux.harlelux.de` gibt es kein `/admin`. Der Port wird von der FRITZ!Box nicht freigegeben, ist also nur im Heimnetz erreichbar:

```
http://<server-ip>:3051/admin
```

Zusätzlich lässt die App dort nur private Adressen durch und verlangt das Passwort aus `ADMIN_PASSWORD`. Nach zehn Fehlversuchen ist der Login eine Viertelstunde gesperrt.

Unter derselben Adresse zeigt `/de/` die ganze Seite mit Entwürfen, als Vorschau.

Hochgeladene Bilder werden auf höchstens 2400 px verkleinert und neu gespeichert, dabei fallen EXIF-Daten wie der Aufnahmeort weg.

## Deployment

Läuft als Docker-Stack in Dockge hinter Nginx Proxy Manager.

```sh
cd ~/stacks
git clone https://git.harlelux.de/Harlekin/Personal-Website.git personal_website
cd personal_website
mkdir data              # muss dem Container-User (UID 1000) gehören
cp .env.example .env    # ADMIN_PASSWORD eintragen
docker compose up -d --build
```

Im Nginx Proxy Manager einen Proxy Host für `lux.harlelux.de` auf `personal-website:3000` anlegen, mit Let's-Encrypt-Zertifikat und Force SSL. Der Container hängt im Netzwerk `nginx_default`, ein anderer Name lässt sich über `PROXY_NETWORK` in der `.env` setzen.

Code-Updates: `git pull` und `docker compose up -d --build`. Wer statt Git mit `rsync` hochlädt, muss `data` und `.env` ausschließen, sonst sind die Inhalte weg.

**`data/` gehört ins Backup.** Dort liegt alles, was über die Admin-Seiten angelegt wurde.

## Lizenz

Der Code steht unter der MIT-Lizenz (siehe `LICENSE`). Texte und Bilder in `content/` und `data/` sind davon ausgenommen.