Blogbeiträge hinzufügen
Ziel
Benutzerinhalte zu einem bestehenden statischen Blog hinzufügen, ohne ein neues Blogsystem zu erzwingen.
Dieser Skill muss zuerst verstehen, wie die aktuelle Website Beiträge bereits darstellt, und dann neue Inhalte in diesem Stil hinzufügen. Er ist kein generischer Markdown-zu-HTML-Konverter.
Vertrag
Eingaben:
- Vorhandener statischer Site-Ordner und sein aktuelles Beitrags-/Index-/Vorlagensystem.
- Ein oder mehrere Quellbeiträge: Markdown, Obsidian-Notizen, Word-Dokumente, altes HTML, eingefügter Text, Bilder, Anhänge oder Inhaltsordner.
- Optionale Metadaten wie Titel, Datum, Tags, Zusammenfassung, Slug, Titelbild und Importumfang.
Ausgaben:
- Neue Artikel-/Detailseiten, die dem vorhandenen Artikelstil der Website entsprechen.
- Aktualisierte Einstiegspunkte wie Blog-Index, Archiv, Tags/Kategorien, aktuelle Beiträge auf der Startseite, Suchdaten, RSS oder Sitemap, wenn diese Systeme bereits vorhanden sind.
- Kopierte/neu verlinkte lokale Bilder und Anhänge mit seitenrelativen Pfaden.
- Aktualisierte
EDITING.md-Beitragsanweisungen, sofern zutreffend.
Grenzen:
- Die Website nicht neu gestalten oder ein neues Beitragssystem erstellen, wenn ein vorhandenes klar ist.
- Keine Metadaten, Daten, Autoren oder Behauptungen erfinden, die die Quelle nicht unterstützt.
- Keine entfernten Mathe-/CDN-Abhängigkeiten stillschweigend hinzufügen.
- Nicht veröffentlichen;
publish-static-siteverwenden.
Erfolgskriterium:
- Neue Beiträge werden im vorhandenen Stil gerendert und sind über die entsprechenden Indizes erreichbar.
- Bilder, Mathe, Links, Code, Tabellen und umfangreiche Inhalte funktionieren oder ungelöste Elemente werden explizit gemeldet.
- Pfade sind seitenrelativ von Artikel- und Indexseiten aus.
- Betroffene Seiten bestehen die Browser-Validierung und
review-static-sitekann bestehen oder nur akzeptierte Einschränkungen melden.
Bei Fehlschlagen des Kriteriums:
- Konvertierung, Metadaten, Pfade, Assets oder Index-Verknüpfungen in diesem Skill korrigieren.
edit-site-partfür kleine visuelle Korrekturen verwenden, die durch den Import verursacht wurden.review-static-sitenach den Korrekturen erneut ausführen.
Verwendung
Diesen Skill verwenden, wenn der Benutzer Folgendes möchte:
- Einen neuen Artikel, eine Notiz, einen Essay oder einen Blogbeitrag hinzufügen.
- Mehrere Markdown-Dateien in eine statische Website importieren.
- Beiträge von einem alten Blog in eine neue generierte Website verschieben.
- Eingefügten Artikeltext in eine Artikel-Seite der Website konvertieren.
- Den Blog-Index, das Archiv, die Tags, die aktuellen Beiträge auf der Startseite oder verwandte Einstiegspunkte aktualisieren.
- Die visuelle Sprache der aktuellen Website beim Hinzufügen von Inhalten beibehalten.
Diesen Skill nicht verwenden, um ein Theme auszuwählen, eine neue Website von Grund auf zu erstellen, den Stil einer Website neu zu erstellen, Profil-/Über-Inhalte zu personalisieren, eine kleine visuelle Anpassung vorzunehmen, die Website zu veröffentlichen oder das Projekt in ein Framework zu konvertieren.
Eingaben
Verwenden, was verfügbar ist:
- Statischer Site-Ordner, normalerweise
site/,dist/,out/oderpublic/. - Eine oder mehrere Markdown-Dateien, Word-Dokumente, eingefügte Beiträge, alte HTML-Dateien, Bildordner oder Inhaltsordner.
EDITING.md, Seitenübersicht oder Übergabenotizen von vorherigen Skills.- Vorhandene Artikel-Vorlagenseiten oder repräsentative Beiträge.
- Vom Benutzer bereitgestellter Titel, Datum, Tags, Kategorie, Zusammenfassung, Slug, Titelbild und Veröffentlichungspräferenz.
- Ob alle Beiträge, eine ausgewählte Teilmenge oder zuerst ein repräsentativer Batch importiert werden soll.
Wenn der Quellinhalt groß ist, zuerst die Struktur überprüfen und vermeiden, alles blind zu importieren.
1. Das vorhandene Beitragssystem verstehen
Bevor neue Beiträge geschrieben werden, überprüfen, wie die Website derzeit funktioniert.
Prüfen auf:
- Beitragsdateien wie
posts/*.html,notes/*.html,articles/*.htmloder verschachtelte Routenordner. - Indexseiten wie
blog.html,archive/index.html,notes/index.html,tags/index.htmlodercategory/index.html. - Datendateien wie
data/posts.json,data/notes.json,data/site.jsonoderprofile.json. - JavaScript-Datenarrays in
assets/script.jsoder ähnlichen Dateien. - Startseitenabschnitte für aktuelle Beiträge, vorgestellte Beiträge, Notizen, Leselisten oder Schreiber-Highlights.
- Vorhandene Artikel-/Detailseiten, die als Vorlagen verwendet werden können.
- Vorhandene Pfadstrategie: Ob Vorlagen seitenrelative Links wie
../assets/style.cssoder Server-Stamm-Links wie/assets/style.cssverwenden. - RSS, Atom, Sitemap, Suchindex oder Tag-/Kategorieseiten, falls bereits vorhanden.
EDITING.md-Anweisungen zum Hinzufügen von Beiträgen.- Vorhandene Bild- und Anhangskonventionen, wie
assets/images/posts/, kollokierte Beitragsordner, Cover-Felder, Figure-Klassen, Lightbox-Markup, Bildunterschriften oder responsive Bild-Wrapper. - Vorhandene Konventionen für umfangreiche Inhalte, wie Mathe-Rendering, Code-Highlighting, Tabellen, Fußnoten, Callouts, Überschriftenanker, Inhaltsverzeichnis, Linkkarten, Einbettungen, Diagramme und Zitier-/Referenzabschnitte.
Der vorhandenen Struktur folgen. Kein neues Beitragssystem erfinden, wenn die Website bereits eines hat.
2. Metadaten von Beiträgen extrahieren
Für jeden Quellbeitrag Folgendes extrahieren oder ableiten:
- Titel.
- Datum.
- Slug.
- Tags oder Kategorie.
- Zusammenfassung oder Auszug.
- Titelbild oder Heldenbild, falls vorhanden und verwendbar.
- Quellpfad.
- Lesezeit, nur wenn die aktuelle Website sie bereits verwendet oder sie einfach konsistent zu berechnen ist.
Frontmatter verwenden, wenn vorhanden. Andernfalls aus der ersten Überschrift, dem Dateinamen, dem umgebenden Ordner, dem sichtbaren Datumstext oder dem ersten Absatz ableiten.
Keine spezifischen Daten, Tags, Autoren oder Behauptungen erfinden. Wenn ein Feld fehlt und nicht abgeleitet werden kann, einen klaren Platzhalter verwenden oder das Feld weglassen, wenn es der Seitenstil erlaubt.
3. Inhalt an den Stil der Website anpassen
Neue Artikelseiten erstellen, indem die vorhandene Artikelvorlage und das Leseerlebnis nachgeahmt werden.
Beibehalten:
- Kopfzeile, Navigation, Fußzeile, Seitenleisten und gemeinsame Hülle.
- Artikeltypografie, Abstände, Metadaten-Layout, Tags, Backlinks und verwandte Links.
- Jegliche spezielle Themensprache, wie Logeinträge, Feldnotizen, Karten, Terminal-/Archiv-Rahmen oder minimalistische Essays.
- Vorhandene CSS-Klassenkonventionen und Datenstrukturen.
Für Markdown:
- Überschriften, Absätze, Blockzitate, Listen, Aufgabenlisten, Tabellen, Codeblöcke, Links, Fußnoten, Callouts und Bilder in semantisches HTML konvertieren.
- Code-Sprachbezeichnungen beibehalten, wenn verfügbar.
- Bildreferenzen seitenrelativ halten und lokale Bilder nur bei Bedarf kopieren.
- Chinesischen, japanischen, koreanischen, akzentuierten lateinischen und anderen nicht-ASCII-Text als lesbares UTF-8 beibehalten.
Für altes HTML:
- Den Artikelkörper und die Metadaten extrahieren.
- Altes Site-Chrome, Analysen, Kommentare, nicht zusammenhängende Navigation und die Identität der Quellseite entfernen.
- Den Inhalt in die Artikelvorlage der neuen Website einpacken.
3.5. Statische Pfadkompatibilität beibehalten
Beim Hinzufügen von Beiträgen Pfade vom Speicherort jeder generierten Seite aus berechnen. Pfade nicht blind von index.html in verschachtelte Artikelseiten kopieren.
Standardregeln:
- Neue Artikelseiten sollten seitenrelative Links für gemeinsames CSS, JavaScript, Schriftarten, Bilder und Navigation verwenden.
- Wenn der Beitrag unter
posts/my-post.htmlgeneriert wird, benötigen gemeinsame Assets normalerweise../assets/style.css,../assets/script.jsund Beitragsbilder wie../assets/images/posts/my-post/figure.png. - Links von Stammseiten zum Beitrag sollten normalerweise
posts/my-post.htmlsein. - Links vom Beitrag zurück zu Stammseiten sollten normalerweise
../index.html,../blog.htmloder../archive/index.htmlsein, abhängig von der Struktur. - Keine stammabsoluten Pfade wie
/assets/...,/posts/...,/data/...oder/images/...einführen, es sei denn, die vorhandene Website verwendet sie absichtlich und der Benutzer akzeptiert, dass das direkte Öffnen vonfile://und das Hosting in Unterpfaden möglicherweise nicht mehr funktioniert. - JavaScript-generierte Links, Suchergebnisse, Tag-Filter, verwandte Beitragslinks, Cover-Pfade, RSS/Sitemap-Einträge und alle Datendateien mit derselben Pfadstrategie aktualisieren.
- Wenn die vorhandene Website bereits versehentlich stammabsolute Links hat, dies melden und vorziehen, die betroffenen Pfade zu korrigieren, anstatt das Problem zu erweitern.
Lokale Datei-Fetch-Probleme vermeiden:
- Neu hinzugefügte Beiträge nicht von
fetch()von lokalem JSON/Markdown für den Artikelkörper abhängig machen. - Wenn Indizes aus Daten gerendert werden, wesentliche Beitragslinks im HTML sichtbar halten oder ein relatives JavaScript-Datenobjekt verwenden, das mit der Direktvorschau funktioniert.
4. Umfangreiche Inhaltsformate handhaben
Umfangreiche Inhalte absichtlich beibehalten, anstatt alles in einfache Absätze zu glätten.
Zunächst prüfen, ob die aktuelle Website bereits Folgendes unterstützt:
- Mathe-Rendering mit KaTeX, MathJax, benutzerdefiniertem CSS oder rohen TeX-Blöcken.
- Code-Highlighting, Sprachbezeichnungen, Kopier-Buttons oder terminalartige Code-Rahmen.
- Tabellen, responsive Tabellen-Wrapper, Fußnoten, Callouts, Hinweise, Zitate und Aufgabenlisten.
- Überschriftenanker, Inhaltsverzeichnis, Backlinks, verwandte Notizen oder Abschnittslinks.
- Linkkarten, Lesezeichenlisten, URL-Indexseiten, Zitate, Referenzlisten oder Bibliographie-Abschnitte.
- Eingebettete Medien wie Video, Audio, PDFs, iframes, Mermaid-Diagramme, Excalidraw/SVG-Diagramme oder herunterladbare Anhänge.
Dem vorhandenen Muster folgen, wenn eines existiert. Wenn kein Muster existiert, einfaches semantisches HTML verwenden und alle Funktionen melden, die einen zusätzlichen Renderer benötigen.
Mathe und Formeln:
- Inline- und Display-Mathe aus
$...$,$$...$$,\(...\),\[...\]oder Word-Gleichungsexporten beibehalten. - Den vorhandenen Mathe-Renderer der Website verwenden, falls vorhanden.
- Wenn die Quelle viele Formeln enthält und kein Renderer existiert, eine lokale KaTeX-Integration für statische Seiten bevorzugen: KaTeX CSS/JS/Schriftarten in einem lokalen vendor-Ordner speichern, ein kleines lokales Render-Skript hinzufügen und nicht auf ein CDN angewiesen sein.
- Keine entfernte MathJax/KaTeX-Abhängigkeit stillschweigend zu einer ansonsten abhängigkeitsfreien Website hinzufügen.
- Das ursprüngliche TeX in mathematisch markierten Elementen als Fallback beibehalten und dann im Browser rendern. Wenn das Rendern einer Formel fehlschlägt, sollte der lesbare TeX-Fallback sichtbar bleiben, anstatt die Seite zu beschädigen.
- Offensichtliche Quellsyntax normalisieren, die KaTeX benötigt, wie Softmax-Pfeile,
\cdot,\times, versehentlich in Formeln gemischte Satzzeichen und häufige Q/K/V-Ausdrücke. - Keine formelreichen Beiträge als codeartige TeX-Blöcke belassen, wenn ein Mathe-Renderer hinzugefügt wurde.
- Formeln in der Quelle und im Browser-Fallback lesbar halten.
Codeblöcke:
- Code-Sprachbezeichnungen in Fenced-Blöcken beibehalten.
- HTML in Codeblöcken escapen.
- Lange Codezeilen scrollbar halten, anstatt das Seitenlayout zu beschädigen.
- Vorhandene Codeblock-Stile, Kopier-Buttons und Syntax-Highlighting-Konventionen wiederverwenden.
- Quellcode aus Beiträgen nicht ausführen.
Tabellen:
- Markdown-, Word- oder HTML-Tabellen in semantische Tabellen konvertieren.
- Breite Tabellen in den vorhandenen responsiven Tabellen-Container der Website einwickeln oder einen kleinen lokalen Wrapper hinzufügen.
- Kopfzeilen, Ausrichtungsabsicht und Bildunterschriften beibehalten, wenn verfügbar.
Links, URL-Indizes und interne Verweise:
- Externe Links mit klarem Linktext beibehalten.
- Relative Links und Markdown-
.md-Links in den generierten statischen HTML-Pfad konvertieren, wenn der Zielbeitrag importiert wird. - Obsidian-Wikilinks wie
[[Notiz]],[[Notiz#Überschrift]]und[[Notiz|Alias]]in normale Links konvertieren, wenn das Ziel aufgelöst werden kann. - Ungelöste interne Links als sichtbare Platzhalter oder Klartext beibehalten und melden.
- Stabile Überschriften-IDs generieren, wenn die Website Ankerlinks oder ein Inhaltsverzeichnis verwendet.
- Bei URL-Index-, Lesezeichen- oder Link-Roundup-Beiträgen die Listenstruktur beibehalten. Den vorhandenen Linkkarten-/Listenstil der Website verwenden, wenn vorhanden; keine Vorschaubilder erfinden, die das Abrufen entfernter Metadaten erfordern, es sei denn, der Benutzer fragt danach.
Fußnoten, Zitate und Referenzen:
- Markdown-Fußnoten in einen Fußnotenabschnitt konvertieren, wobei der vorhandene Stil der Website verwendet wird, falls vorhanden.
- Zitierbezeichnungen, Bibliographieeinträge und Referenzlinks beibehalten.
- Wenn der Quelltext ungelöste Zitierschlüssel wie
[@paper2024]verwendet, diese sichtbar lassen und melden, dass Zitiermetadaten fehlen, es sei denn, eine Bibliographiedatei wird bereitgestellt.
Callouts, Hinweise und Blocktypen:
- Obsidian/GitHub-ähnliche Callouts wie
> [!NOTE],> [!TIP],> [!WARNING]und> [!IMPORTANT]in das nächstgelegene Callout-/Karten-/Blockzitatmuster der Website konvertieren. - Aufgabenlisten als Checklisten beibehalten, wenn die aktuelle Website Checkbox-Stile hat; andernfalls deaktivierte Kontrollkästchen-Markups oder einfache Listen verwenden.
Einbettungen und Anhänge:
- Für PDFs, Folien, Datensätze, Downloads, Audio und Video einen klaren Link oder eine Download-Karte bevorzugen, es sei denn, die Website bettet diesen Medientyp bereits ein.
- Lokale Anhänge nur kopieren, wenn sie vom Benutzer bereitgestellt werden.
- Entfernte Einbettungen nur beibehalten, wenn der Benutzer sie besitzt oder absichtlich darauf verweist.
- Für Mermaid- oder Diagrammblöcke den vorhandenen Renderer verwenden, falls vorhanden. Wenn kein Renderer existiert, den Quellblock beibehalten und melden oder nur dann in ein statisches SVG/PNG konvertieren, wenn es praktisch und angemessen ist.
5. Beitragsbilder und -assets handhaben
Bilder gemäß den vorhandenen Asset-Konventionen der Website handhaben.
Zunächst prüfen, wie vorhandene Beiträge Bilder speichern und rendern:
- Gemeinsamer Asset-Ordner wie
assets/images/posts/<slug>/. - Kollokierte Beitrags-Assets wie
posts/<slug>/images/. - Datenfelder wie
cover,heroImage,thumbnailoderimages. - Figure-Markup, Bildunterschriften, Lightbox-Links, Lazy Loading, Breite-/Höhenattribute und responsive CSS-Klassen.
Das vorhandene Muster bevorzugen. Wenn kein Muster existiert, eine einfache statische Konvention verwenden wie:
assets/images/posts/<post-slug>/
Für Markdown-Quellen:
- Relative Bildlinks aus dem Ordner der Markdown-Datei auflösen.
- Lokale Bilder bei Bedarf in den Beitragsbildordner der Website kopieren.
- Markdown-Bildreferenzen in die neuen relativen Website-Pfade umschreiben.
- Für verschachtelte Artikelseiten die korrekte
../-Tiefe in Bildpfaden einfügen. - Alt-Text aus Markdown beibehalten, wenn vorhanden.
- Bildunterschriften konvertieren, wenn die Quelle benachbarten kursiven Text, Titelattribute oder Obsidian-ähnliche Einbettungen verwendet.
- Keine Links hinterlassen, die auf absolute lokale Festplattenpfade verweisen.
Für Obsidian-Notizen:
- Häufige Einbettungen wie
![[image.png]]und relative Anhangsordner unterstützen. - Wahrscheinliche Anhangsordner in der Nähe der Notiz durchsuchen, wie
attachments/,assets/,images/oder den konfigurierten Anhangsordner der Wissensdatenbank, wenn sichtbar. - Einbettungen in normales HTML-Bild- oder Figure-Markup umschreiben.
Für Word .docx-Quellen:
- Eingebettete Bilder aus dem Dokumentpaket extrahieren oder verfügbare Dokumentwerkzeuge verwenden.
- Die Bildreihenfolge relativ zum umgebenden Text beibehalten, wenn möglich.
- Extrahierte Bilder unter dem Beitragsbildordner mit stabilen Namen speichern.
- Benachbarte Bildunterschriften oder Alt-Text verwenden, wenn verfügbar.
6. Indizes und Einstiegspunkte aktualisieren
Nachdem neue Beiträge geschrieben wurden, alle vorhandenen Indizes und Navigationen aktualisieren, um sie einzubeziehen.
Prüfen und aktualisieren:
- Blog-Startseite, Index, Archiv oder
blog.html. - Kategorie- oder Tag-Seiten und deren Indizes.
- Abschnitt „Neueste Beiträge“ oder „Vorgestellte Beiträge“ auf der Startseite.
- RSS / Atom-Feed.
- Sitemap.
- Suchdatendatei oder clientseitiges Suchindex-JSON.
- Daten-JSON wie
data/posts.jsonoderdata/notes.json. - Verwandte Beitragslisten oder Abschnitte „Weiterlesen“ in Artikeln.
- Paginierung, wenn vorhanden.
- Link-Roundup- oder URL-Index-Seiten, falls zutreffend.
EDITING.md, wenn es eine Beitragsliste enthält.
Dieselbe Sortier- und Filterlogik wie der vorhandene Index der Website verwenden. Beiträge nicht nach einem neuen Schema sortieren.
Wenn die Website Paginierung verwendet, neue Beiträge in die richtigen Seiten einfügen.
Wenn die Website mehrere Beitragstypen hat (Blog, Notizen, Artikel, Logs), jede neue Seite in ihren richtigen Abschnittsindex einfügen.
Diesen Schritt nicht überspringen. Ein Beitrag, der nicht mit einem Index verknüpft ist, ist unsichtbar.
7. Überprüfen und testen
Nach dem Hinzufügen von Inhalten validieren, ob alles funktioniert.
Testen:
- Dass alle neuen Seiten vom Browser ohne Fehler gerendert werden.
- Dass Bilder und Anhänge relativ zur Seite laden.
- Dass Links innerhalb der Website funktionieren und zu den richtigen Seiten führen.
- Dass Mathe, Code-Blöcke und umfangreiche Inhalte korrekt gerendert werden.
- Dass Indizes und Navigation aktualisiert wurden und alle neuen Beiträge einschließen.
- Dass keine Abhängigkeiten von entfernten Ressourcen hinzugefügt wurden (insbesondere für Mathe-Rendering), die der Benutzer nicht erwartet.
review-static-site verwenden, um die allgemeine Gültigkeit der Website zu überprüfen.
Wenn etwas defekt ist:
- Probleme in diesem Skill protokollieren.
edit-site-partfür kleine visuelle Korrekturen verwenden.- Den Schritt wiederholen, bis der Test erfolgreich ist.
Häufige Probleme
- Pfade: Vergessen, die Tiefe für seitenrelative Links in verschachtelten Artikelseiten anzupassen. Teste Links sowohl von der Stammseite als auch von der Artikelseite.
- Fehlende Assets: Lokale Bilder oder Anhänge nicht kopiert. Alte Pfade hinterlassen.
- Indizes nicht aktualisiert: Der Blog-Index, die Startseite oder Tag-Seiten enthalten keine neuen Beiträge.
- Unveränderter Frontmatter: Das Datum/die Tags des Beitrags nicht aus Frontmatter abgeleitet, wenn verfügbar.
- Mathe-Abhängigkeiten: Stilles Hinzufügen eines CDN für Mathe-Rendering, wenn der Benutzer die Website offline oder ohne CDN-Abhängigkeit haben möchte.
- CMS-spezifische Syntax: Nicht konvertierte Obsidian-Wikilinks oder Hugo-Kurzcodes, die in der generierten Ausgabe erscheinen.
Zusammenfassung der Schritte
- Das vorhandene Beitragssystem verstehen
- Metadaten aus Quellen extrahieren
- Inhalte an den Stil der Website anpassen
- Pfadkompatibilität beibehalten
- Umfangreiche Formate (Mathe, Code, Tabellen, Links, Fußnoten, Callouts, Einbettungen) handhaben
- Bilder und Assets gemäß den Site-Konventionen handhaben
- Indizes, Navigation und Einstiegspunkte aktualisieren
- Testen und validieren
Diese Reihenfolge einhalten. Einen Schritt nicht überspringen, nur weil er einfach erscheint.
Beziehung zu anderen Skills
get-site-specwird verwendet, um die Website anfangs zu verstehen. Wenn sie noch nicht ausgeführt wurde, jetzt ausführen: Führeget-site-specaus und lies die Ausgabe, um die Site-Architektur und -Konventionen zu verstehen.edit-site-partwird für kleine visuelle Korrekturen nach dem Import verwendet, z. B. um ein Ungleichgewicht im Abstand oder eine falsch ausgerichtete Schaltfläche zu beheben.review-static-sitewird verwendet, um zu überprüfen, ob die Änderungen gültig sind.publish-static-sitewird verwendet, um die Website nach Fertigstellung zu veröffentlichen.- Dieser Skill ist so konzipiert, dass er unabhängig von der verwendeten Technologie ist: Hugo, Jekyll, Eleventy, Astro, Next.js, einfaches HTML, 11ty, Zola oder ein anderes statisches Site-Generierungssystem.
⚠️ Wichtig: Lese vor der Ausführung die README der Website. Die README könnte Konventionen dokumentieren, die hier nicht beschrieben sind, oder wichtige Workflow-Anweisungen enthalten. Lese während der Ausführung auch site.json oder das Äquivalent, falls vorhanden; die Site-Konfiguration spezifiziert oft die tatsächliche Verzeichnisstruktur, die sich von den hier gezeigten Beispielen unterscheiden kann.