Was macht Statische Repo-Landingpage?
Generieren Sie eine statische Landingpage (docs/index.html + docs/style.css + docs/main.js), deren Inhalt aus dem Repository stammt, in dem sie sich befindet. Führen Sie niemals Funktionen, Anbieter oder Befehle auf, die im Repository nicht tatsächlich vorhanden sind.
Quelle der Wahrheit für Inhalte
Lesen Sie vor dem Schreiben Folgendes:
README.*— Überblick, Funktionen, Technologie-Stack, Installations-/SchnellstartbefehleLICENSE*— Lizenzname, -version, -URLCHANGELOG.*— Zusammenfassung des Änderungsverlaufspackage.json,composer.json,requirements.txt, usw.: Name, Beschreibung, Abhängigkeiten (Grundlage für Tech-Stack-Badges)AGENTS.md,CLAUDE.md,config.toml,GEMINI.md, usw.: Der Zweck des Projekts und, falls das Projekt solche hat, Tabellen der unterstützten Anbieter/Einstellungen- Ein vorhandenes
docs/index.html(falls vorhanden): Die Abschnittsstruktur wiederverwenden und den Inhalt direkt bearbeiten, anstatt von Grund auf neu zu erstellen, sofern nicht ausdrücklich eine Neugestaltung verlangt wird.
Erforderliche Elemente
-
Helles/dunkles Design — Überschreiben Sie CSS-Custom-Properties (
--bg,--text,--accent, usw.) mit einerprefers-color-scheme: darkMedia Query. Fügen Sie keinen JS-Design-Umschalter hinzu, es sei denn, dies wird verlangt. -
OGP + Twitter/X-Karte —
og:title,og:description,og:url,og:image,og:type,og:site_name,twitter:card,twitter:title,twitter:description,twitter:image. Verweisen Sieog:image/twitter:imageauf ein Asset, das tatsächlich bereits im Repository existiert (z.B.social-preview.png). Falls keines existiert, generieren Sie zuerst eines mit dem Skillmake-social-preview. -
JSON-LD-Schema — Ein
<script type="application/ld+json">-Block (SoftwareApplicationfür eine App/ein Tool; andernfalls jeder@type, der zum Projekt passt). Halten Sie ihn konsistent mit der OGP-Beschreibung. -
Favicon — Referenzieren Sie ein Twemoji-SVG, das zum Projekt passt, mit
<link rel="icon">. -
Mehrsprachigkeitsunterstützung mittels
multilanguagejs(CDN, kein Build-Schritt):<script src="https://unpkg.com/[email protected]/dist/multilanguagejs.umd.cjs"></script>Umschließen Sie jedes zu übersetzende Element mit
<template type="language-group">, und platzieren Sie darin ein untergeordnetes Element pro Sprache, jedes mit einemlanguage="xx"-Attribut (nichtlang):<h2> <template type="language-group"> <span language="en">Features</span> <span language="ja">機能</span> </template> </h2>Jedes
template[type=language-group]muss genau ein Element pro unterstützter Sprache enthalten –multilanguagejsnimmt das erste passende[language=X]pro Template, daher führen Duplikate dazu, dass Inhalte stillschweigend verloren gehen.Initialisieren Sie es in
main.js:var ml = new MultilanguageJS({ languages: [...], defaultLanguage: "en" }); ml.setLanguage(lang); // beim Laden und beim Change-Event des <select>-Umschalters<title>und<meta name="description">liegen außerhalb des Geltungsbereichs der[language]-Templates (die Bibliothek aktualisiert nur dentextContentpassender Elemente, und die Übersetzung eines<meta>-Tags befindet sich in seinemcontent-Attribut, nicht in seinem Text). Geben Siemain.jsein kleines sprachspezifisches Wörterbuch{ title, description }mit und aktualisieren Sie diese beiden Tags manuell zusammen mitml.setLanguage().Erkennen Sie die Sprache des Besuchers über
navigator.language, speichern Sie die ausgewählte Sprache inlocalStorageund wenden Sie sie beim Laden erneut an, bevor Sie auf die Browsererkennung zurückfallen.Erforderlicher Sprachsatz (immer, unabhängig davon, was die App selbst unterstützt): Englisch (
en), Japanisch (ja), Chinesisch (zh), Spanisch (es), Russisch (ru), Deutsch (de) – mindestens 6 Sprachen. Dies gilt auch, wennsrc/locales/*.jsonoder die eigenei18n.ts/i18n.jsder App nur einige davon abdeckt (z.B. erstellen Sie die Landingpage selbst für eineen/ja-App in 6 Sprachen). Auf Wunsch können Sie weitere Sprachen zu diesen 6 hinzufügen. -
Copy-to-Clipboard-Buttons — Statten Sie jeden Installations-/Ausführungsbefehl, der in einem
<code>-Block angezeigt wird, mit einem Kopierbutton und einem Inline-SVG-Icon (niemals ein Emoji) sowie einem Bestätigungszustand mit Häkchen übernavigator.clipboard.writeText()aus. Verwenden Sie für ein konsistentes Layout einen.code-row-Flex-Container, der das<code>-Element und seinen Button umschließt. -
Responsiv — Mobile First. Vermeiden Sie horizontales Scrollen auf schmalen Ansichtsfenstern, außer in Containern, die explizit zum Scrollen vorgesehen sind (z.B. eine breite Vergleichstabelle).
-
Kein Build-Schritt — Stellen Sie sicher, dass die Seite allein durch das Öffnen der HTML-Datei oder das Bereitstellen des statischen Ordners wie besehen funktioniert, unabhängig davon, welches Bündelungstool (Vite, usw.) die App selbst verwendet. Halten Sie
main.jsals lesbaren Quellcode. Laden Sie es direkt in die Seite mit<script src="main.js">. -
Semantische Struktur — Strukturieren Sie diese semantisch: Heldenbereich (Überschrift, Einleitungstext, CTA, primärer Ausführungsbefehl), Screenshots (verwenden Sie vorhandene Repository-/GitHub-Asset-URLs, falls vorhanden), Feature-Raster, Schnellstart-/Installationsbefehle, Tech-Stack-Badges, Footer.
-
Vorhandenes CSS wiederverwenden — Verwenden Sie die bereits im
docs/style.cssdes Repositorys vorhandenen CSS-Custom-Properties und Klassennamen, anstatt ein paralleles, separates Stilsystem zu erstellen. -
Respektieren Sie das Designsystem — Respektieren Sie das Designsystem der bestehenden KI-Agenten-Laufzeitumgebung. Wenn Sie neues CSS hinzufügen, verwenden Sie vorhandene Custom Properties und Klassennamen wieder und befolgen Sie Namenskonventionen, Design, Layout sowie Ton und Stil, die mit dem Designsystem des Repositorys konsistent sind.
Arbeitsablauf
- Lesen Sie die oben genannten Inhaltsquellen.
- Wenn
docs/nicht existiert, erstellen Sie es. - Wenn
docs/index.htmlbereits existiert, bearbeiten Sie es direkt – sofern nicht ausdrücklich eine Neugestaltung verlangt wird, ersetzen Sie es nicht vollständig, sondern behalten Sie die Abschnittsstruktur bei und aktualisieren Sie den Inhalt. - Strukturieren Sie die Abschnitte semantisch: Heldenbereich (Überschrift, Einleitungstext, CTA, primärer Ausführungsbefehl), Screenshots (verwenden Sie vorhandene Repository-/GitHub-Asset-URLs, falls vorhanden), Feature-Raster, Vergleichs-/Einstellungstabelle (falls das Projekt mehrere Anbieter/Modi/Backends hat, die einen Vergleich lohnen), Schnellstart-/Installationsbefehle, Tech-Stack-Badges, Footer.
- Verwenden Sie die bereits im
docs/style.cssdes Repositorys vorhandenen CSS-Custom-Properties und Klassennamen wieder, anstatt ein paralleles, separates Stilsystem zu erstellen. - Aktualisieren Sie
docs/main.js. - Überprüfen Sie vor dem Abschluss: Es werden keine Emojis für interaktive Icons verwendet (nur SVG); jedes
template[type=language-group]enthält genau ein untergeordnetes Element pro unterstützter Sprache, ohne Duplikate oder Auslassungen; OGP/JSON-LD verweisen auf Dateien/URLs, die tatsächlich im Repository vorhanden sind.