Migrando desde Jekyll

Jekyll es un generador de sitios estáticos construido en Ruby.

Principales similitudes entre Jekyll y Astro

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

Jekyll y Astro son generadores de sitios estáticos, comúnmente utilizados para crear blogs.
Jekyll y Astro te permiten escribir tu contenido en Markdown y HTML. Tanto Jekyll como Astro proporcionan algunas propiedades YAML especiales para el diseño de páginas y publicaciones de borrador no publicadas. Puedes continuar utilizando tus archivos Markdown existentes en Astro.
Jekyll y Astro utilizan enrutamiento basado en archivos para crear páginas a partir de tus publicaciones de blog. Astro proporciona un directorio especial src/pages/ para todas las páginas y publicaciones. Jekyll utiliza una carpeta especial similar llamada _posts/ para tus publicaciones de blog en Markdown, aunque tus páginas del sitio pueden estar en otros lugares. La creación de nuevas publicaciones de blog debería resultar familiar.

Principales diferencias entre Jekyll y Astro

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

Como Jekyll es principalmente una plataforma de blogs, incluye varias características de blog integradas que es posible que debas construir por tu cuenta en Astro. O bien, elige una plantilla de inicio de tema de blog que incluya estas características. Por ejemplo, Jekyll tiene soporte integrado para etiquetas y categorías que encontrarás en varios temas de blog de Astro, pero no se incluye en un proyecto Astro básico.
Jekyll utiliza plantillas Liquid para elementos de diseño reutilizables y plantillas. Astro utiliza archivos .astro similares a JSX para plantillas y componentes. Cualquier archivo .astro puede ser un componente, un diseño o una página completa, y puede importar y renderizar cualquier otro componente de Astro. También puedes construir utilizando componentes de otros frameworks de UI (p. ej. React, Svelte, Vue, Solid) así como contenido o metadatos de otros archivos en tu proyecto, como Markdown o MDX.

Migrar de Jekyll a Astro

Para migrar un blog de Jekyll a Astro, empieza con nuestra plantilla inicial para blogs, o explora más temas de la comunidad para blogs en nuestro mostrador de temas.

Puedes pasar el argumento --template al comando create astro para empezar un nuevo proyecto de Astro con una de nuestras plantillas oficiales. O, puedes comenzar un nuevo proyecto desde cualquier repositorio de Astro existente en GitHub.

npm create astro@latest -- --template blog

pnpm create astro@latest --template blog

yarn create astro --template blog

Trae tus archivos Markdown existentes como contenido para crear páginas en Markdown, utilizando un diseño de Markdown de Astro en lugar de una plantilla Liquid template.

Gran parte de tu contenido de página HTML existente se puede convertir en páginas de Astro, y además podrás usar variables, expresiones similares a JSX e importaciones de componentes directamente en tu plantilla HTML.

Astro no tiene una propiedad permalink que acepte marcadores de posición. Es posible que debas leer más acerca del enrutamiento de página en Astro si deseas mantener tu estructura de URL existente. O bien, considera configurar redireccionamientos en un host como Netlify.

Para convertir otros tipos de sitios, como un portafolio o sitio de documentatión, mira más plantillas oficiales de inicio 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.