Anleitung: Beitrag schreiben und Website veröffentlichen

Kurzfassung für den Alltag. Alle Befehle laufen im Ordner Claude Code/Webseite_Überarbeitet_16.8.26/DentBlanc_Eleventy.

Terminal öffnen und einmal dorthin wechseln:

cd "/Users/oleglivschits/Claude Code/Webseite_Überarbeitet_16.8.26/DentBlanc_Eleventy"

A · Neuen Beitrag unter „Aktuelles" schreiben

1. Bild ablegen

Nach media/health/dental/news/Praxis/

als .webp, höchstens etwa 1600 px breit
Dateiname ohne Leerzeichen und ohne Umlaute
Der Ordner heißt Praxis – mit großem P

Falle: Dein Mac unterscheidet Groß- und Kleinschreibung nicht, der Server bei IONOS schon. Schreibst du praxis statt Praxis, funktioniert alles lokal – und auf der echten Website fehlt das Bild.

2. Datei anlegen

Vorlage kopieren und umbenennen:

cp news/_vorlagen/vorlage-ein-foto.md news/2610_MeinThema.md

Namensschema: JJMM_Thema.md – also Jahr, Monat, Stichwort.

3. Kopf ausfüllen

title: "Die Überschrift"
description: "Ein Satz, 50–100 Zeichen. Erscheint in der Kachel und bei Google."
displayDate: "Oktober 2026"
date: 2026-10-01
image: "/media/health/dental/news/Praxis/dein-bild.webp"
category: "praxis"          # oder "dental"
permalink: "/news/2026/2610_MeinThema.html"
tags: news

Falle: In der Vorlage stehen permalink: false und eleventyExcludeFromCollections: true. Beide müssen weg, sonst erscheint der Beitrag nicht in der Übersicht.

4. Text schreiben

Keine eigene Überschrift – die entsteht automatisch aus title
Neuer Absatz: eine Leerzeile dazwischen
Fett: **so**
Zeilenumbruch innerhalb eines Absatzes: <br> ans Zeilenende
Bildpfad im Text ebenfalls anpassen, samt alt-Beschreibung

5. Ansehen

npm run dev

Dann im Browser: http://localhost:8080/neues.html

Solange dieses Fenster offen ist, siehst du jede Änderung sofort. Mit Strg + C beenden.

Wer lieber klickt statt tippt: http://localhost:8080/werkzeuge/news-generator/ – Editor mit Vorschau, erzeugt fertigen Code zum Einfügen.

B · Veröffentlichen

1. Sauber bauen

npm run build

Wichtigste Falle überhaupt:npm run dev schaltet die Bildoptimierung ab und legt die internen Werkzeuge mit in den Bau. Ergebnis: 83 MB statt 46 MB und werkzeuge/ auf dem Server. Nach jedem npm run dev also immer npm run build.

Zur Kontrolle – so sieht ein sauberer Bau aus:

[media-prune] 202 nicht referenzierte Datei(en) entfernt (33.8 MB)
[11ty] Copied 370 Wrote 63 files
[Aufraeumen] 13 unbenutzte Bilddateien aus dem Bau entfernt (2.35 MB)

Und:

du -sh _site          # muss ~46M sein, nicht 83M
ls _site/werkzeuge    # muss "No such file" sagen

2. Hochladen

Mit FileZilla den Inhalt von _site in das Verzeichnis der Website. Nicht den Ordner _site selbst – index.html muss direkt im Ziel liegen.

Falle: Die .htaccess ist eine versteckte Datei. FileZilla zeigt sie standardmäßig nicht und lädt sie dann auch nicht hoch. Einschalten unter Server → Versteckte Dateien anzeigen erzwingen. Ohne sie fehlen alle Weiterleitungen alter Adressen und die Schutzregeln.

Nicht hochladen:node_modules, _includes, _data, werkzeuge, .git, package.json, .eleventy.js – der ganze Quellordner bleibt auf dem Rechner.

3. Danach prüfen

Prüfen	Erwartung
`https://www.dentblanc.de/api/termine.php`	JSON, beginnt mit `{"ok":true`
Startseite	Terminkachel zeigt drei Termine
Der neue Beitrag	Bild ist da (Groß-/Kleinschreibung!)
`https://www.dentblanc.de/neues.html`	Kachel steht oben

Kommt bei api/termine.php PHP-Quelltext statt JSON, ist PHP für das Verzeichnis nicht aktiv. Die Seite bleibt trotzdem heil – die Terminkachel blendet sich dann einfach aus.

C · Google Bescheid geben (nur bei Bedarf)

https://search.google.com/search-console

Anmelden mit dem Google-Konto der Praxis
Sitemap eintragen – nur einmal nötig: Menü Sitemaps → sitemap.xml → absenden
Für einen einzelnen neuen Beitrag: oben die volle Adresse eingeben → Indexierung beantragen

Die Datei sitemap.xml wird bei jedem Bau automatisch neu erzeugt. Dort musst du nie etwas von Hand eintragen.

D · Sichern

Das Projekt liegt nur auf dieser Festplatte, es gibt kein Online-Backup. Nach größeren Änderungen:

git add -A
git commit -m "Kurz beschreiben, was geändert wurde"

Und den Ordner gelegentlich (ohne node_modules) auf eine externe Platte oder in die iCloud kopieren.

Kurzreferenz

cd "/Users/oleglivschits/Claude Code/Webseite_Überarbeitet_16.8.26/DentBlanc_Eleventy"

npm run dev      # ansehen und schreiben     -> localhost:8080
npm run build    # sauber bauen zum Hochladen -> _site/  (~46 MB)

Die drei Fallen, die wirklich weh tun:

Nach npm run dev das npm run build vergessen → 83 MB und die internen Werkzeuge landen auf dem Server
praxis statt Praxis im Bildpfad → Bild fehlt nur auf der echten Website
eleventyExcludeFromCollections: true stehen lassen → Beitrag erscheint nicht in der Übersicht