Plantilla Starlight

La plantilla Starlight integra tu proyecto de Content Island con Astro Starlight, el motor de documentación de Astro.
De esta forma, todo tu contenido se gestiona directamente desde Content Island, y tu sitio se genera automáticamente con Starlight.

Edición sin código

Todo el contenido es editable desde el panel de Content Island, sin necesidad de conocimientos de programación.

Assets optimizados

Los recursos multimedia se sirven desde una CDN, optimizados y listos para usar en tu sitio Starlight.

Sincronización sencilla

El contenido se mantiene siempre actualizado gracias a la sincronización entre Content Island y tu proyecto local.

---

Crear un proyecto

Para crear un proyecto a partir de la plantilla Starlight, sigue estos pasos:

1. Abre Nuevo proyecto.
   

2. Selecciona la pestaña Plantillas.
   

3. Elige la plantilla Starlight.
   

4. Pulsa Crear proyecto.
   

Pestaña Quick Start

Una vez creado el proyecto, se abrirá automáticamente la pestaña Quick Start, donde encontrarás: - Un video explicativo sobre el funcionamiento del proyecto. - Los comandos necesarios para crear la solución de Starlight en local y sincronizarla con tu proyecto de Content Island.

Abre el terminal en Visual Studio Code y copia los comandos que aparecen en Quick Start:
el primero para crear un nuevo proyecto Starlight, y el segundo para conectarlo con tu proyecto de Content Island.

Una vez sincronizado, podrás editar y actualizar el contenido directamente desde Content Island.

---

Estructura de contenido en Content Island

Tu proyecto de Content Island vinculado con Starlight utiliza la siguiente estructura de entidades:

Root

Define la página principal del proyecto y las carpetas asociadas a la documentación.

Folder

Representa una carpeta dentro del árbol de documentación. En ella puedes incluir páginas.

Page

Contiene el contenido de cada página de documentación. Recuerda asociarla siempre a una carpeta.

Meta

Estructura interna de Content Island para identificar la plantilla y versión vinculadas.

Puedes gestionar todo esto desde la pestaña Content:

• Editar el objeto Root (solo hay uno por proyecto).
• Crear nuevas carpetas (Folder) y páginas (Page).

Consejo

Cuando crees una carpeta, recuerda asociarla a la entidad Root (abre Root y añade la carpeta en la lista de folders). Y al crear una página, puedes: - Añadirla a una carpeta existente. - O asociarla directamente a Root como página principal.

---

Actualizar el contenido en tu proyecto Starlight

Después de realizar cambios en Content Island, puedes sincronizarlos con tu proyecto local de Starlight ejecutando desde la raíz:

npm create contentisland@latest update