Migrar desde Jekyll

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

Similitudes clave entre Jekyll y Astro

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

Tanto Jekyll como Astro son generadores de sitios estáticos, comúnmente usados para crear blogs.
Tanto Jekyll como Astro te permiten escribir tu contenido en Markdown y HTML. Tanto Jekyll como Astro proporcionan algunas propiedades especiales de frontmatter YAML para el layout de página y posts borradores no publicados. Puedes continuar usando tus archivos Markdown existentes en Astro.
Tanto Jekyll como Astro usan enrutamiento basado en archivos para crear páginas a partir de tus blog posts. Astro proporciona un directorio especial src/pages/ para todas las páginas y posts. Jekyll usa una carpeta especial similar llamada _posts/ para tus blog posts en Markdown, sin embargo las páginas de tu sitio pueden existir en otros lugares. Crear nuevos blog posts debería resultarte familiar.

Diferencias clave entre Jekyll y Astro

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

Como Jekyll es principalmente una plataforma de blogging, varias características de blog están integradas que puede que tengas que construir tú mismo en Astro. O, elige un tema de plantilla de inicio 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 está incluido en un proyecto mínimo de Astro.
Jekyll usa plantillas Liquid para elementos de layout reutilizables y plantillas. Astro usa archivos .astro similares a JSX para plantillas y componentes. Cualquier archivo .astro puede ser un componente, un layout o una página completa, y puede importar y renderizar cualquier otro componente de Astro. También puedes construir usando otros componentes de frameworks de UI (p. ej. React, Svelte, Vue, Solid) así como contenido o metadatos de otros archivos en tu proyecto, como Markdown o MDX.

Cambiar de Jekyll a Astro

Para convertir un blog de Jekyll a Astro, comienza con nuestra plantilla de inicio del tema de blog, o explora más temas de blog 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 blog

pnpm create astro@latest --template blog

yarn create astro --template blog

Trae tus archivos Markdown existentes como contenido para crear páginas Markdown, usando un layout de Markdown de Astro en lugar de una plantilla Liquid.

Gran parte de tu contenido de páginas HTML existente puede convertirse en páginas de Astro, y además podrás usar variables, expresiones similares a JSX e imports de componentes directamente en tus plantillas HTML.

Astro no tiene una propiedad permalink que acepte placeholders. Puede que necesites leer más sobre el enrutamiento de páginas de Astro si quieres conservar tu estructura de URL existente. O, considera configurar redirecciones en un host como Netlify.

Para convertir otros tipos de sitios, como un portafolio o sitio de documentación, consulta 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 clic para abrir un proyecto funcional en los entornos de desarrollo en línea StackBlitz y CodeSandbox.