# Funciones de vagejs Lo que vagejs hace por tu sitio.

> Todas las funciones de vagejs en un solo lugar: páginas Markdown y MDX, componentes React y Vue, varios idiomas, archivos SEO, revisiones y publicación segura.

vagejs es un generador de sitios estáticos gratuito y de código abierto creado para los asistentes de programación con IA. Sus funciones principales son las páginas Markdown y MDX, los componentes React y Vue, los sitios en varios idiomas, los archivos que buscan los buscadores y los asistentes de IA, una revisión de cada página antes de publicarla, la protección contra el spam y la publicación segura. Tú escribes las páginas, o dejas que tu asistente de IA las escriba. Aquí tienes todo lo que hace, con un enlace a la documentación de cada parte.

`npm create vagejs@latest my-site`

[Primeros pasos](https://vagejs.com/es/docs/getting-started/)[Úsalo con tu asistente de IA](https://vagejs.com/es/agents/)

## Escribe y genera tus páginas

Archivos sencillos que te pertenecen, con componentes solo donde los quieras.

-   ### Escribir páginas
    
    Cada página es un archivo Markdown en `src/pages`, y su carpeta decide su dirección: `src/pages/pricing.md` se convierte en `/pricing/`. Las páginas pueden ser borradores, llevar etiquetas que tienen sus propias páginas o esperar a una fecha de publicación. Una página con un `datePublished` futuro queda fuera de la compilación, del sitemap y de los feeds hasta ese día, y aparece con la siguiente compilación.
    
    Consulta [creación de contenido](https://vagejs.com/docs/content-authoring/)
    
-   ### Un editor local
    
    `npm run dev` también abre un editor en tu navegador: un formulario para cada página, el texto con una vista previa en directo con el diseño de tu sitio, subida de imágenes y los resultados de la revisión de la página. Se niega a sobrescribir una página que haya cambiado desde que la abriste, funciona solo en tu propio ordenador y nunca forma parte del sitio generado.
    
    Consulta [edita en tu navegador](https://vagejs.com/docs/content-authoring/#edit-in-your-browser)
    
-   ### React, Vue y MDX
    
    Las plantillas pueden ser funciones de TypeScript o componentes de React y Vue, y las páginas pueden ser MDX con componentes de React. Todo se convierte en HTML plano. Añade `client:visible` a un componente de React y se convierte en una isla interactiva solo en esa página.
    
    Consulta [React, Vue y MDX](https://vagejs.com/es/features/react-vue-mdx/)
    
-   ### Varios idiomas
    
    Pon las traducciones en una carpeta por idioma. vagejs define el idioma de cada página, escribe enlaces `hreflang` entre las versiones y te avisa de las páginas que aún hay que traducir.
    
    Consulta [sitios multilingües](https://vagejs.com/es/features/multi-language-sites/)
    

## Haz que te encuentren los buscadores y la IA

Todo lo que leen los buscadores y los asistentes de IA se escribe por ti, a partir de las páginas que tienes.

El sitemap, `robots.txt`, `llms.txt`, los enlaces canónicos, las etiquetas para compartir, los datos estructurados y los feeds RSS salen de las páginas que existen. En `robots.txt` puedes tratar los rastreadores de entrenamiento de IA (como GPTBot y ClaudeBot) de forma distinta a los rastreadores de búsqueda con IA (como OAI-SearchBot y PerplexityBot). Consulta [SEO y búsqueda con IA](https://vagejs.com/docs/seo/).

## Publica sin sorpresas

Cada página se revisa antes de publicarse, y no sale nada que no hayas aprobado.

-   ### Revisiones antes de publicar
    
    `vage check` lee todas las páginas sin escribir nada e informa de enlaces rotos, títulos y descripciones que faltan o están duplicados, datos estructurados no válidos y fallos básicos de accesibilidad, cada uno con el archivo que hay que corregir. `vage audit` genera el sitio y somete cada página a límites de tamaño, como 100 KB de JavaScript.
    
    Consulta [revisiones y auditorías](https://vagejs.com/docs/checks/)
    
-   ### Protección contra la inyección de spam
    
    Todos los sitios web externos a los que enlazan tus páginas aparecen en `links.lock.json`. Un enlace a un sitio web que no está en la lista, o un enlace oculto a los visitantes, hace fallar la revisión. `vage verify` compara el sitio publicado con tus archivos.
    
    Consulta [seguridad](https://vagejs.com/docs/security/)
    
-   ### Publicación segura
    
    `vage deploy` publica en GitHub Pages, Cloudflare Workers, Cloudflare Pages o Netlify. Primero ejecuta la revisión, muestra un plan y espera a que digas que sí, se niega a hacer commit de secretos y nunca hace un force push. Cualquier otro hosting estático, como Vercel, puede servir la carpeta `dist`.
    
    Consulta [publicación](https://vagejs.com/docs/deployment/)
    
-   ### Formularios de contacto sin JavaScript
    
    En Cloudflare Workers, un formulario de contacto no necesita ningún script en la página: `vage deploy` añade un pequeño Worker que envía cada mensaje por correo, con una trampa para spam y un límite por visitante.
    
    Consulta [formulario de contacto](https://vagejs.com/docs/deployment/#contact-form)
    

## Hecho para asistentes de programación con IA

Cada sitio nuevo incluye `AGENTS.md`, que les dice a Claude Code, Codex, Cursor y otros asistentes los comandos y las reglas. `vage info --json` describe todos los comandos y ajustes en una sola respuesta, y `vage mcp` permite que un asistente revise el sitio directamente. Consulta las [guías para agentes](https://vagejs.com/es/agents/).

terminal

```
npx vage info --json   # every command and setting, in one reply
claude mcp add --transport stdio --scope project vagejs -- npx -p vagejs vage mcp
```

## Guías y comparativas de las funciones de vagejs

Las [guías](https://vagejs.com/guides/) explican paso a paso tareas concretas, y [vagejs comparado](https://vagejs.com/compare/) muestra cómo se comparan estas funciones con las de otros generadores de sitios estáticos y CMS. Para saber quién hace vagejs y por qué, lee [acerca de vagejs](https://vagejs.com/es/about/).

## Preguntas sobre las funciones de vagejs

### ¿vagejs envía JavaScript a los visitantes?

No, a menos que lo pidas. Las páginas son HTML plano, así que un sitio nuevo envía 0 KB de JavaScript. Un componente de React marcado con `client:visible`, `client:load` o `client:idle` es lo único que añade algo, y solo en la página que lo usa.

### ¿Puedo usar componentes de React o Vue?

Sí. Las plantillas pueden ser componentes de React o Vue, y las páginas MDX pueden usar componentes de React. Se convierten en HTML plano al generar el sitio, así que los visitantes no descargan React ni Vue a menos que un componente tenga que ser interactivo.

### ¿Qué busca vage check?

Enlaces rotos, títulos y descripciones que faltan o están duplicados, datos estructurados no válidos, enlaces a sitios web que no has aprobado y fallos básicos de accesibilidad, como imágenes sin texto alternativo. Cada problema indica el archivo que hay que corregir, para que tú o tu asistente de IA lo arreglen enseguida.

### ¿Puedo editar páginas sin un editor de código?

Sí. `npm run dev` abre un editor en tu navegador con un formulario para cada página y una vista previa en directo con el diseño de tu sitio. Solo funciona en tu propio ordenador y nunca forma parte del sitio publicado.
