¿Qué hace Landing estática del repositorio?
Genera una página de destino estática (docs/index.html + docs/style.css + docs/main.js) cuyo contenido se extrae del repositorio en el que se coloca. Nunca enumere características, proveedores o comandos que no existan realmente en el repositorio.
Fuente de verdad para el contenido
Antes de escribir cualquier cosa, lea lo siguiente:
README.*— descripción general, características, pila tecnológica, comandos de instalación/inicio rápidoLICENSE*— nombre de la licencia, versión, URLCHANGELOG.*— resumen del historial de cambiospackage.json,composer.json,requirements.txt, etc.: nombre, descripción, dependencias (la base para las insignias de la pila tecnológica)AGENTS.md,CLAUDE.md,config.toml,GEMINI.md, etc.: el propósito del proyecto y, si el proyecto los tiene, tablas de proveedores/configuraciones compatibles- Un
docs/index.htmlexistente (si está presente): a menos que se solicite explícitamente un rediseño, reutilice su estructura de secciones y edite el contenido en el lugar en lugar de reconstruirlo desde cero
Elementos requeridos
-
Tema claro/oscuro — Sobrescribir las propiedades personalizadas de CSS (
--bg,--text,--accent, etc.) con una consulta de mediosprefers-color-scheme: dark. No agregue un conmutador de tema JS a menos que se le solicite. -
OGP + Tarjeta de Twitter/X —
og:title,og:description,og:url,og:image,og:type,og:site_name,twitter:card,twitter:title,twitter:description,twitter:image. Apunteog:image/twitter:imagea un recurso que ya exista realmente en el repositorio (por ejemplo,social-preview.png). Si no existe ninguno, genere uno primero con la habilidadmake-social-preview. -
Esquema JSON-LD — Un bloque
<script type="application/ld+json">(SoftwareApplicationpara una aplicación/herramienta; de lo contrario, cualquier@typeque se ajuste al proyecto). Manténgalo coherente con la descripción de OGP. -
Favicon — Haga referencia a un SVG de Twemoji que se adapte al proyecto con
<link rel="icon">. -
Soporte multilingüe a través de
multilanguagejs(CDN, sin paso de compilación):<script src="https://unpkg.com/[email protected]/dist/multilanguagejs.umd.cjs"></script>Envuelva cada elemento que se va a traducir en
<template type="language-group">, y dentro de él coloque un elemento secundario por idioma, cada uno con un atributolanguage="xx"(nolang):<h2> <template type="language-group"> <span language="en">Features</span> <span language="ja">機能</span> </template> </h2>Cada
template[type=language-group]debe contener exactamente un elemento por idioma compatible —multilanguagejstoma el primer[language=X]que coincida por plantilla, por lo que los duplicados hacen que el contenido se pierda silenciosamente.Inicialícelo en
main.js:var ml = new MultilanguageJS({ languages: [...], defaultLanguage: "en" }); ml.setLanguage(lang); // al cargar y en el evento de cambio del selector <select><title>y<meta name="description">están fuera del alcance de las plantillas[language](la biblioteca solo actualiza eltextContentde los elementos coincidentes, y la traducción de una etiqueta<meta>reside en su atributocontent, no en su texto). Proporcione amain.jsun pequeño diccionario{ title, description }por idioma y actualice estas dos etiquetas manualmente junto conml.setLanguage().Detecte el idioma del visitante desde
navigator.language, guarde el idioma seleccionado enlocalStoragey al cargar, vuelva a aplicarlo antes de recurrir a la detección del navegador.Conjunto de idiomas requerido (siempre, independientemente de lo que admita la propia aplicación): Inglés (
en), Japonés (ja), Chino (zh), Español (es), Ruso (ru), Alemán (de) — al menos 6 idiomas. Esto aplica incluso sisrc/locales/*.jsono el propioi18n.ts/i18n.jsde la aplicación cubre solo algunos de ellos (por ejemplo, incluso para una aplicación soloen/ja, haga la página de destino en 6 idiomas). Si se solicita, puede agregar otros idiomas a estos 6. -
Botones de copia al portapapeles — Proporcione a cada comando de instalación/ejecución que se muestre en un bloque
<code>un botón de copia con un icono SVG en línea (nunca un emoji), con un estado de confirmación de marca de verificación a través denavigator.clipboard.writeText(). Para un diseño coherente, envuelva el<code>y su botón en un contenedor flexible.code-row. -
Responsivo — Prioridad móvil. No provoque desplazamiento horizontal en ventanas gráficas estrechas, excepto dentro de contenedores explícitamente destinados a desplazarse (por ejemplo, una tabla de comparación amplia).
-
Sin paso de compilación — Haga que la página funcione simplemente abriendo el archivo HTML o sirviendo la carpeta estática tal cual, independientemente del empaquetador (Vite, etc.) que use la propia aplicación. Mantenga
main.jscomo código fuente legible. Cárguelo directamente en la página con<script src="main.js">. -
Estructura semántica — Estructure estos semánticamente: héroe (título, texto principal, CTA, comando de ejecución principal), capturas de pantalla (reutilice las URL de activos existentes del repositorio/GitHub si las hay), cuadrícula de características, comandos de inicio rápido/instalación, insignias de pila tecnológica, pie de página.
-
Reutilizar CSS existente — Reutilice las propiedades personalizadas de CSS y los nombres de clase que ya están en el
docs/style.cssdel repositorio en lugar de crear un sistema de estilo separado y paralelo. -
Respetar el sistema de diseño — Respete el sistema de diseño en el entorno de ejecución del agente de IA existente. Al agregar nuevo CSS, reutilice las propiedades personalizadas y los nombres de clase existentes, y siga las convenciones de nomenclatura, el diseño, el diseño y el tono y la manera consistentes con el sistema de diseño del repositorio.
Flujo de trabajo
- Lea las fuentes de contenido anteriores.
- Si
docs/no existe, créelo. - Si
docs/index.htmlya existe, edítelo en el lugar — a menos que se solicite explícitamente un rediseño, no lo reemplace por completo; mantenga la estructura de la sección y actualice el contenido. - Estructure las secciones semánticamente: héroe (título, texto principal, CTA, comando de ejecución principal), capturas de pantalla (reutilice las URL de activos existentes del repositorio/GitHub si las hay), cuadrícula de características, tabla de comparación/configuración (si el proyecto tiene múltiples proveedores/modos/backends que valga la pena comparar), comandos de inicio rápido/instalación, insignias de pila tecnológica, pie de página.
- Reutilice las propiedades personalizadas de CSS y los nombres de clase que ya están en el
docs/style.cssdel repositorio en lugar de crear un sistema de estilo separado y paralelo. - Actualice
docs/main.js. - Verifique antes de terminar: no se utilizan emojis para iconos interactivos (solo SVG); cada
template[type=language-group]tiene exactamente un elemento secundario por idioma compatible, sin duplicados ni omisiones; OGP/JSON-LD apuntan a archivos/URL que realmente existen en el repositorio.