Que fait Landing statique du dépôt ?
Génère une page d'accueil statique (docs/index.html + docs/style.css + docs/main.js) dont le contenu provient du dépôt dans lequel elle est placée. Ne listez jamais de fonctionnalités, fournisseurs ou commandes qui n'existent pas réellement dans le dépôt.
Source de vérité pour le contenu
Avant d'écrire quoi que ce soit, lisez ce qui suit :
README.*— aperçu, fonctionnalités, stack technique, commandes d'installation/démarrage rapideLICENSE*— nom de la licence, version, URLCHANGELOG.*— résumé de l'historique des modificationspackage.json,composer.json,requirements.txt, etc. : nom, description, dépendances (base pour les badges de stack technique)AGENTS.md,CLAUDE.md,config.toml,GEMINI.md, etc. : l'objectif du projet et, si le projet en possède, les tableaux des fournisseurs/paramètres pris en charge- Un
docs/index.htmlexistant (s'il est présent) : sauf demande explicite de refonte, réutilisez sa structure de sections et modifiez le contenu sur place plutôt que de reconstruire à partir de zéro
Éléments requis
-
Thème clair/sombre — Remplacez les propriétés personnalisées CSS (
--bg,--text,--accent, etc.) avec une media queryprefers-color-scheme: dark. N'ajoutez pas de bouton de basculement de thème JS sauf demande explicite. -
OGP + carte Twitter/X —
og:title,og:description,og:url,og:image,og:type,og:site_name,twitter:card,twitter:title,twitter:description,twitter:image. Pointezog:image/twitter:imagevers un actif qui existe déjà réellement dans le dépôt (par exemple,social-preview.png). S'il n'en existe pas, générez-en d'abord un avec la compétencemake-social-preview. -
Schéma JSON-LD — Un bloc
<script type="application/ld+json">(SoftwareApplicationpour une application/outil ; sinon tout@typequi correspond au projet). Gardez-le cohérent avec la description OGP. -
Favicon — Référencez un SVG Twemoji qui convient au projet avec
<link rel="icon">. -
Prise en charge multilingue via
multilanguagejs(CDN, sans étape de build) :<script src="https://unpkg.com/[email protected]/dist/multilanguagejs.umd.cjs"></script>Enveloppez chaque élément à traduire dans
<template type="language-group">, et à l'intérieur placez un élément enfant par langue, chacun avec un attributlanguage="xx"(paslang) :<h2> <template type="language-group"> <span language="en">Features</span> <span language="ja">機能</span> </template> </h2>Chaque
template[type=language-group]doit contenir exactement un élément par langue prise en charge —multilanguagejsprend le premier élément correspondant[language=X]par template, donc les doublons entraînent une perte silencieuse de contenu.Initialisez-le dans
main.js:var ml = new MultilanguageJS({ languages: [...], defaultLanguage: "en" }); ml.setLanguage(lang); // au chargement, et sur l'événement change du sélecteur <select><title>et<meta name="description">sont hors de la portée des templates[language](la bibliothèque ne met à jour que letextContentdes éléments correspondants, et la traduction d'une balise<meta>réside dans son attributcontent, pas dans son texte). Donnez àmain.jsun petit dictionnaire par langue{ title, description }et mettez à jour ces deux balises manuellement avecml.setLanguage().Détectez la langue du visiteur à partir de
navigator.language, enregistrez la langue sélectionnée danslocalStorage, et au chargement réappliquez-la avant de revenir à la détection du navigateur.Ensemble de langues requis (toujours, indépendamment de ce que l'application elle-même prend en charge) : Anglais (
en), Japonais (ja), Chinois (zh), Espagnol (es), Russe (ru), Allemand (de) — au moins 6 langues. Ceci s'applique même sisrc/locales/*.jsonou le proprei18n.ts/i18n.jsde l'application ne couvre que certaines d'entre elles (par exemple, même pour une application uniquementen/ja, faites la page d'accueil en 6 langues). Si demandé, vous pouvez ajouter d'autres langues à ces 6. -
Boutons copier dans le presse-papiers — Donnez à chaque commande d'installation/exécution affichée dans un bloc
<code>un bouton de copie avec une icône SVG en ligne (jamais un emoji), avec un état de confirmation de coche vianavigator.clipboard.writeText(). Pour une mise en page cohérente, enveloppez le<code>et son bouton dans un conteneur flexible.code-row. -
Responsive — Mobile-first. Ne provoquez pas de défilement horizontal sur les fenêtres étroites, sauf à l'intérieur de conteneurs explicitement destinés à défiler (par exemple, un tableau comparatif large).
-
Pas d'étape de build — Faites en sorte que la page fonctionne simplement en ouvrant le fichier HTML ou en servant le dossier statique tel quel, indépendamment du bundler (Vite, etc.) utilisé par l'application elle-même. Gardez
main.jscomme source lisible. Chargez-le directement dans la page avec<script src="main.js">. -
Structure sémantique — Structurez sémantiquement : hero (titre, texte d'accroche, CTA, commande d'exécution principale), captures d'écran (réutilisez les URL d'actifs existants du dépôt/GitHub s'il y en a), grille de fonctionnalités, commandes de démarrage rapide/installation, badges de stack technique, pied de page.
-
Réutiliser le CSS existant — Réutilisez les propriétés personnalisées CSS et les noms de classe déjà présents dans le
docs/style.cssdu dépôt plutôt que de créer un système de style parallèle et séparé. -
Respecter le système de design — Respectez le système de design dans l'environnement d'exécution d'agent IA existant. Lors de l'ajout de nouveau CSS, réutilisez les propriétés personnalisées et les noms de classe existants, et suivez les conventions de nommage, le design, la mise en page, le ton et la manière cohérents avec le système de design du dépôt.
Workflow
- Lisez les sources de contenu ci-dessus.
- Si
docs/n'existe pas, créez-le. - Si
docs/index.htmlexiste déjà, modifiez-le sur place — sauf demande explicite de refonte, ne le remplacez pas en totalité ; conservez la structure de sections et mettez à jour le contenu. - Structurez les sections sémantiquement : hero (titre, texte d'accroche, CTA, commande d'exécution principale), captures d'écran (réutilisez les URL d'actifs existants du dépôt/GitHub s'il y en a), grille de fonctionnalités, tableau de comparaison/paramètres (si le projet a plusieurs fournisseurs/modes/backends qui valent la peine d'être comparés), commandes de démarrage rapide/installation, badges de stack technique, pied de page.
- Réutilisez les propriétés personnalisées CSS et les noms de classe déjà présents dans le
docs/style.cssdu dépôt plutôt que de créer un système de style parallèle et séparé. - Mettez à jour
docs/main.js. - Vérifiez avant de terminer : aucun emoji n'est utilisé pour les icônes interactives (SVG uniquement) ; chaque
template[type=language-group]a exactement un élément enfant par langue prise en charge, sans doublons ni omissions ; OGP/JSON-LD pointent vers des fichiers/URL qui existent réellement dans le dépôt.