From 9b9b3ac839ce2643a61c959bba28bf92f6ba5c21 Mon Sep 17 00:00:00 2001 From: Waxer59 <78129249+Waxer59@users.noreply.github.com> Date: Thu, 27 Apr 2023 22:57:39 +0200 Subject: [PATCH] i18n(es): Translated `from-hugo.mdx` (#3103) * translate page * update page desc * update translation * update links * fix broken links --------- Co-authored-by: Paul Valladares <85648028+dreyfus92@users.noreply.github.com> Co-authored-by: Yan Thomas <61414485+Yan-Thomas@users.noreply.github.com> --- .../es/guides/migrate-to-astro/from-hugo.mdx | 68 +++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 src/content/docs/es/guides/migrate-to-astro/from-hugo.mdx diff --git a/src/content/docs/es/guides/migrate-to-astro/from-hugo.mdx b/src/content/docs/es/guides/migrate-to-astro/from-hugo.mdx new file mode 100644 index 0000000000000..88daa40dbe279 --- /dev/null +++ b/src/content/docs/es/guides/migrate-to-astro/from-hugo.mdx @@ -0,0 +1,68 @@ +--- +title: Migrando desde Hugo +description: Consejos para migrar un proyecto existente de Hugo a Astro +type: migration +stub: true +framework: Hugo +i18nReady: true +--- + +import PackageManagerTabs from '~/components/tabs/PackageManagerTabs.astro' + +[Hugo](https://gohugo.io) es un generador de sitios estáticos de codigo abierto construido en Go. + +## Principales similitudes entre Hugo y Astro + +Hugo y Astro comparten algunas similitudes que te ayudarán a migrar tu proyecto: + +- Hugo y Astro son generadores modernos de sitios estáticos, idealmente adaptados para [sitios web enfocados en contenido](/es/concepts/why-astro/#enfocado-en-el-contenido), como los blogs. + +- Hugo y Astro permiten [crear tu contenido en Markdown](/es/guides/content/#creación-de-markdown). Sin embargo, Hugo incluye varias propiedades especiales en el frontmatter y permite escribir este en YAML, TOML o JSON. Aunque muchas de las propiedades existentes de tu frontmatter de Hugo no serán "especiales" en Astro, puedes seguir utilizando tus archivos Markdown existentes y los valores del frontmatter en YAML. + +- Hugo y Astro permiten mejorar tu sitio con una variedad de [integraciones y paquetes externos](https://astro.build/integrations/). + + + +## Principales diferencias entre Hugo y Astro + +Cuando reconstruyas tu sitio de Hugo a Astro, notarás algunas diferencias importantes: + +- Hugo utiliza Go Templating para la generación de páginas. [La sintaxis de Astro](/es/core-concepts/astro-components/) es un superset de HTML similar a JSX. + +- Astro no utiliza shortcodes para insertar contenido dinámico en archivos Markdown estándar, pero [la integración de MDX en Astro](/es/guides/integrations-guide/mdx/) te permite usar JSX e importar componentes en archivos MDX. + +- Mientras que en Hugo se pueden usar "parciales" para elementos reutilizables del diseño, [Astro está completamente basado en componentes](/es/core-concepts/astro-components/). Cualquier archivo `.astro` puede ser un componente, diseño o una página completa, y puede importar y renderizar cualquier otro componente de Astro. Los componentes de Astro también pueden incluir [otros componentes de frameworks de UI (p. ej. React, Svelte, Vue, Solid)](/es/core-concepts/framework-components/) así como contenido o metadatos de [otros archivos en tu proyecto](/es/guides/imports/), como Markdown o MDX. + +## Migrar de Hugo a Astro + +Para migrar un blog de Hugo a Astro, empieza con nuestra plantilla inicial para blogs, o explora más temas de la comunidad para blogs en nuestro [mostrador de temas](https://astro.build/themes/). + +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](/es/install/auto/#plantillas-de-inicio). + + + + ```shell + npm create astro@latest -- --template blog + ``` + + + ```shell + pnpm create astro@latest --template blog + ``` + + + ```shell + yarn create astro --template blog + ``` + + + +Lleva tus archivos Markdown (o MDX, con nuestra integración opcional) existentes como contenido para [crear páginas en Markdown o MDX](/es/guides/markdown-content/). Es posible que necesites convertir tu frontmatter a YAML, ya que Astro solo permite YAML frontmatter en estos archivos. + +Para seguir utilizando contenido dinámico como variables, expresiones o componentes de la UI dentro del contenido de tu Markdown, añade la integración opcional MDX de Astro y convierte tus archivos Markdown existentes a [páginas MDX](/es/guides/markdown-content/). MDX soporta el frontmatter en YAML, para que puedas mantener las propiedades existentes de tu frontmatter. Pero, tienes que remplazar cualquier shortcode con [la propia sintaxis de MDX](https://mdxjs.com/docs/what-is-mdx/#mdx-syntax), lo que permite expresiones JSX y/o importaciones de componentes. + +Para convertir otros tipos de sitios, como un portafolio o sitio de documentatión, mira más plantillas oficiales de inicio en [astro.new](https://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. + +## Recursos de la Comunidad + +- Artículo de blog: [Hugo Vs Astro - Qué generador de sitios estáticos elegir en 2023](https://onebite.dev/hugo-vs-astro-which-static-site-generator-to-choose-in-2023/).