diff --git a/docs/src/config.ts b/docs/src/config.ts index 307fa140f4..ada905ab27 100644 --- a/docs/src/config.ts +++ b/docs/src/config.ts @@ -54,6 +54,7 @@ export const SIDEBAR = { es: [ { text: 'Configuración', header: true }, { text: 'Empezando', link: 'es/getting-started' }, + { text: 'Instalación', link: 'es/installation' }, ], 'zh-CN': [ { text: '起步', header: true }, diff --git a/docs/src/pages/es/installation.md b/docs/src/pages/es/installation.md new file mode 100644 index 0000000000..cd97088bcc --- /dev/null +++ b/docs/src/pages/es/installation.md @@ -0,0 +1,172 @@ +--- +layout: ~/layouts/MainLayout.astro +title: Installation +lang: es +--- + +Hay diferentes formas de instalar Astro en un nuevo proyecto. + +## Prerrequisitos + +- **Node.js** - `v12.20.0`, `v14.13.1`, `v16.0.0`, o mayor. +- **Editor de texto** - Te recomendamos [VS Code](https://code.visualstudio.com/) con nuestra [extensión oficial de Astro](https://marketplace.visualstudio.com/items?itemName=astro-build.astro-vscode). +- **Terminal** - Principalmente, puedes ingresar a Astro por medio de linea de comando del terminal. + +Con el propósito de realizar una demostración, usaremos [`npm`](https://www.npmjs.com/) en los siguientes ejemplos, pero también puedes usar [`yarn`](https://yarnpkg.com/) o [`pnpm`](https://pnpm.io/), si prefieres un empaquetador alternativo. + +## Crear un Proyecto en Astro + +`npm init astro` es la forma más fácil de instalar Astro en un proyecto nuevo. Ejecuta este comando en tu terminal para iniciar nuestro asistente de instalación `create-astro` para ayudarte a configurar un nuevo proyecto. + +```shell +# With NPM +npm init astro + +# Yarn +yarn create astro +``` + +El asistente de instalación [`create-astro`](https://github.com/snowpackjs/astro/tree/main/packages/create-astro), te permite escoger de una lista de [plantillas de inicio](/examples); por otro lado, puedes importar tus propios proyectos de Astro directamente desde GitHub. + +```bash +# Nota: Reemplaza "my-astro-project" con el nombre de tu proyecto. + +# npm 6.x +npm init astro my-astro-project --template starter +# npm 7+ (el doble guión extra es necesario) +npm init astro my-astro-project -- --template starter +# yarn +yarn create astro my-astro-project --template starter +# Usando una plantilla de un tercero +npm init astro my-astro-project -- --template [GITHUB_USER]/[REPO_NAME] +# Usando una plantilla de un tercero, dentro de un repositorio +npm init astro my-astro-project -- --template [GITHUB_USER]/[REPO_NAME]/path/to/template +``` + +Después de que `create-astro` cree la estructura básica de tu proyecto, recuerda instalar las dependencias del proyecto usando npm o el manejador de paquetes que prefieras. En este ejemplo, usaremos npm: + +```bash +npm install +``` + +Ahora puedes [Iniciar](#start-astro) tu proyecto de Astro. Una vez, que hayas completado tu proyecto, puedes [Compilar](#build-astro) tu proyecto. Astro va a empaquetar tu aplicación y después generará los archivos estáticos, que estarán listos para ser [Desplegados](/guides/deploy) en tu proveedor de hosting favorito. + +## Manual de Instalación + +También puedes configurar Astro sin ayuda del asistente `create-astro`, a continuación, hay algunos pasos adicionales que son necesarios para que Astro funcione. + +### Crear un proyecto + +```bash +# Crea un nuevo directorio y navega a el +mkdir my-astro-project +cd my-astro-project +``` + +Crea un directorio vacío con el nombre de tu proyecto, y entonces navega a él: + +### Crear `package.json` + +```bash +# Este comando creará un simple package.json en el directorio actual +npm init --yes +``` + +Astro está diseñado para trabajar con todo el ecosistema de paquetes npm. Este es gestionado por un manifiesto del proyecto en la raíz de tu proyecto llamado `package.json`. Si no estás familiarizado con el archivo `package.json`, te recomendamos que leas un poco sobre él en la [documentación de npm](https://docs.npmjs.com/creating-a-package-json-file). + +### Instalar Astro + +Siguiendo las instrucciones anteriores, deberías tener un directorio con un único archivo `package.json`. Ahora puedes configurar Astro dentro de tu proyecto. + +```bash +npm install astro +``` + +Ahora, puedes reemplazar la sección de "scripts" del archivo `package.json` que `npm init` creó, por lo siguiente: + +```diff + "scripts": { +- "test": "echo \"Error: no test specified\" && exit 1" ++ "dev": "astro dev", ++ "build": "astro build", ++ "preview": "astro preview" + }, +} +``` + +El comando [`dev`](#start-astro) inicia el servidor de desarrollo de Astro en `http://localhost:3000`. Una vez que tu proyecto esté listo, el comando [`build`](#build-astro) genera tu proyecto en el directorio `dist/`. [Lee más sobre cómo desplegar Astro en la guía de despliegue](/guides/deploy). + +### Crear tu primera página + +Abre astro en tu editor de texto favorito, y crea un nuevo archivo en tu proyecto: + +1. Crea un archivo nuevo en `src/pages/index.astro` +2. Copia-y-pega el siguiente código (incluyendo `---` ) + +```astro +--- +// El bloque de código escrito entre (---) de JS/TS +// Funcionará sólo en el lado del servidor! +console.log('Mírame en la Terminal') +--- + + + +

¡Hola Mundo!

+ + + + + + +``` + +Arriba hay un ejemplo de la sintaxis del componente de Astro, que comprende HTML y JSX. + +Puedes crear más páginas en el directorio `src/pages` y Astro utilizará los archivos creados para generar nuevas páginas de tu sitio web. Por ejemplo, Al crear el archivo `about.astro` en `src/pages/about.astro` (reusando el fragmento de código anterior), Astro generará una página HTML en la dirección URL: `http://localhost/about`. + + +## [Iniciar Astro](#start-astro) + +```bash +npm run dev +``` + +Ahora Astro estará corriendo tu aplicación en `http://localhost:3000`. Al abrir esta URL en tu navegador, deberías ver el “¡Hola, Mundo!” de Astro. + +Si necesitas compartir tu progreso de desarrollo en la red local o revisar la aplicación desde un teléfono, sólo agrega la siguiente opción [snowpack](https://www.snowpack.dev/reference/configuration#devoptionshostname) en `astro.config.mjs`: + +```js +devOptions: { + hostname: '0.0.0.0'; +} +``` + +## [Compilar Astro](#build-astro) + +```bash +npm run build +``` + +Con esta instrucción Astro generará tu sitio web y lo guardará directamente en el directorio `dist/`. Tu aplicación está ahora lista en el directorio `dist/`. + +## Próximos pasos + +¡Felicidades! ¡Ahora estás listo para comenzar a desarrollar! + +Te recomendamos fervientemente que te familiarices con la forma en que Astro funciona. Lo puedes hacer explorando nuestra [documentación](/docs/), te sugerimos que consideres las siguientes lecturas: + +📚 Aprende más sobre la estructura de proyectos de Astro, en nuestra [guía de estructura de proyecto](/core-concepts/project-structure). + +📚 Aprende más sobre la sintaxis de los componentes de Astro, en nuestra [guía de componentes de Astro](/core-concepts/astro-components). + +📚 Aprende más sobre la rutas basada en archivos de Astro, en nuestra [guía de rutas](core-concepts/astro-pages).