Saltearse al contenido

Migrando desde Jekyll

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

Principales similitudes entre Jekyll y Astro

Sección titulada 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

Sección titulada Principales diferencias entre Jekyll y Astro

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

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.

Ventana de terminal
npm create astro@latest -- --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.

Más guías de migración

Contribute

¿Qué tienes en mente?

Community