Migrando desde Pelican

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

Principales similitudes entre Pelican y Astro

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

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

Principales diferencias entre Pelican y Astro

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

Pelican admite escribir contenido en Markdown y reStructured Text (.rst). Astro admite crear páginas a partir de archivos Markdown y MDX, pero no admite reStructured Text.
Pelican usa archivos HTML y sintaxis Jinja para la plantilla. La sintaxis de Astro es un subconjunto de HTML similar a JSX. Todo el HTML válido es una sintaxis válida para .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.

Migrar de Pelican a Astro

Para convertir un sitio de documentación de Pelican a Astro, comienza con nuestra plantilla oficial de inicio para documentación Starlight o explora más temas de blog de la comunidad en nuestro catálogo de temas.

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

npm create astro@latest -- --template starlight

pnpm create astro@latest --template starlight

yarn create astro --template starlight

Lleva tus archivos existentes de contenido Markdown para crear páginas Markdown. Aún puedes tomar ventaja del enrutamiento basado en archivos copiando estos documentos de la carpeta content/ de Pelican a src/pages/ en Astro. Puede que desees leer sobre la estructura del proyecto de Astro para aprender dónde deben estar ubicados los archivos.

Pelican puede haber manejado gran parte del diseño y los metadatos de tu sitio por ti. Puede que desees leer sobre la construcción de diseños de Astro como envoltorios de páginas Markdown para ver cómo administrar las plantillas tú mismo en Astro, incluido tu <head> de página.

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 de trabajo en los entornos de desarrollo en línea de StackBlitz, CodeSandbox y Gitpod.