Migrar desde Pelican

Pelican es un generador de sitios estáticos de código abierto construido sobre Python.

Similitudes clave entre Pelican y Astro

Pelican y Astro comparten algunas similitudes que te ayudarán a migrar tu proyecto:

Pelican y Astro son ambos generadores de sitios estáticos, idealmente adecuados para sitios web orientados a contenido como blogs.
Tanto Pelican como Astro tienen soporte integrado para escribir en Markdown, incluyendo propiedades de frontmatter YAML para metadatos de página. Sin embargo, Astro tiene muy pocas propiedades de frontmatter reservadas en comparación con Pelican. Aunque muchas de tus propiedades de frontmatter existentes de Pelican no serán "especiales" en Astro, puedes continuar usando tus archivos Markdown existentes y tus valores de frontmatter.

Diferencias clave entre Pelican y Astro

Cuando reconstruyas tu sitio de Pelican en Astro, notarás algunas diferencias importantes:

Pelican soporta escribir contenido en Markdown y reStructured Text (.rst). Astro soporta crear páginas desde archivos Markdown y MDX, pero no soporta reStructured Text.
Pelican usa archivos HTML y sintaxis Jinja para plantillas. La sintaxis de Astro es un superset similar a JSX de HTML. Todo el HTML válido es sintaxis válida de .astro.
Pelican fue diseñado para construir sitios web ricos en contenido como blogs y tiene algunas características de blog integradas que tendrías que construir tú mismo en Astro. En su lugar, Astro ofrece algunas de estas características incluidas en un tema de blog oficial.

Cambiar de Pelican a Astro

Para convertir un sitio de documentación de Pelican a Astro, comienza con nuestra plantilla de inicio del tema de docs de Starlight oficial, o explora más temas de la comunidad en nuestro showcase de temas.

Puedes pasar un argumento --template al comando create astro para iniciar un nuevo proyecto de Astro con uno de nuestros starters oficiales. O, puedes iniciar un nuevo proyecto desde cualquier repositorio existente de Astro en GitHub.

npm create astro@latest -- --template starlight

pnpm create astro@latest --template starlight

yarn create astro --template starlight

Trae tus archivos de contenido Markdown existentes para crear páginas Markdown. Aún puedes aprovechar el enrutamiento basado en archivos copiando estos documentos desde la carpeta content/ de Pelican a src/pages/ en Astro. Puede que quieras leer sobre la estructura de proyecto de Astro para aprender dónde deben ubicarse los archivos.

Pelican puede haber gestionado gran parte del layout y metadatos de tu sitio por ti. Puede que quieras leer sobre cómo construir Layouts de Astro como wrappers de páginas Markdown para ver cómo gestionar las plantillas tú mismo en Astro, incluyendo el <head> de tu página.

Como Pelican, Astro tiene muchos plugins que extienden su funcionalidad. Explora la lista oficial de integraciones para añadir características como soporte MDX, y encuentra cientos más de integraciones mantenidas por la comunidad en el Directorio de Integraciones de Astro. Incluso puedes usar la API de Integración de Astro para construir tu propia integración personalizada y extender las características de tu proyecto.

Para convertir otros tipos de sitios, como un portafolio o un blog, consulta más plantillas de inicio oficiales en astro.new. Encontrarás un enlace al repositorio de GitHub de cada proyecto, así como enlaces de un solo clic para abrir un proyecto funcional en los entornos de desarrollo en línea StackBlitz y CodeSandbox.