# Introducción y requisitos (Antes de trabajar un proyecto Red Planet)
# Introducción
Red Planet es una herramienta de Life On Mars (opens new window) (LOM), creada con el objetivo de generar sitios sencillos con una estructura one page, a través del uso de un grupo de componentes predefinidos. Facilitando así, el flujo de trabajo de LOM en este tipo de proyectos.
Red Planet tiene como finalidad, generar sitios web accesibles para negocios en crecimiento (PyME’s). Por lo que generar una página web Red Planet debe ser ágil, rápido y sencillo.
# Requisitos
Para generar un sitio Red Planet es necesario tener instaladas las siguientes herramientas:
| Software | Versión | Uso |
|---|---|---|
| Node (opens new window) | Versión 12.0 LTS o superior | Indispensable |
| VS Code (opens new window) | Última versión disponible | Indispensable |
| Git (opens new window) | Última versión disponible | Recomendado |
| Filezilla (opens new window) | Última versión disponible | Indispensable |
# Instalación del repositorio
Para poder trabajar un proyecto Red Planet, es necesario tener instalado el repositorio del mismo. Para eso, existen dos opciones: la instalación manual y clonando el repositorio con Git.
Sólo es necesario hacer la instalación de una sola manera. Si se descarga la carpeta .Zip desde GitHub, ya no es necesario clonar el repositorio y viceversa.
Importante: Siempre hay que tener en cuenta que debemos descargar la última versión del repositorio. La última versión siempre es la que está disponible en GitHub, por lo que si se tienen archivos anteriores ya descargados en la computadora, es necesario desecharlos.
# Opción 1: Instalación manual
Para la instalación manual, hay que seguir los siguientes pasos:
Entrar al repositorio (opens new window) en GitHub.
Descargar el proyecto, dando click en el botón verde de código (Code) y después, en Descargar . Zip.
Repositorio → Código (Code) → Descargar .Zip
- Una vez descargado el .Zip del repositorio, descomprimir el archivo y abrir la carpeta resultante con VS Code.
# Opción 2: Instalación clonando el repositorio con Git
Si se cuenta con Git instalado en el sistema, se puede hacer la instalación clonando el repositorio. Para hacerlo de esta manera, hay que seguir los siguientes pasos:
Entrar a la terminal.
Escribir y ejecutar el comando:
git clone https://github.com/luriasb/red-planet.git
Después, escribir y ejecutar el siguiente comando:
cd red-planet
# Instalar dependencias
Para instalar las dependencias del proyecto se realizan los siguientes pasos:
Abrir VS Code.
Ir al menú Archivo, dar click en Abrir y seleccionar la carpeta del proyecto.
Archivo → Abrir → Seleccionar carpeta del proyecto.
- Abrir la terminal en el VS Code.
- Comando en Mac:
cmd + j - Comando en Windows:
ctrl + ñ - O dar click en el botón Ver de la barra de menú y después en Terminal
Ver → Terminal
- Dentro de la terminal, es necesario verificar que ya tenemos instalado el Node. Para esto, escribir y ejecutar el comando:
node -v
- La terminal nos indica qué versión de Node tenemos instalada.
Para poder trabajar necesitamos la versión 12 LTS o superior. Sólo en caso de tener una versión inferior a ésta, escribir y ejecutar:
nvm use 12
Nota: Si previamente se instaló una versión superior a la 12 LTS, podemos saltar este paso.
- Continuamos con la instalación de dependencias del proyecto. Dentro de la terminal, escribir y ejecutar el comando:
npm install
- Esperar a que se carguen todas las dependencias hasta que se pueda escribir de nuevo en la terminal.
- A continuación, escribir y ejecutar el comando:
npm run dev
- Esperar a que trabaje la terminal. Al finalizar encontraremos una liga con el servidor local de nuestro proyecto. Normalmente es https://localhost:3000 (opens new window)
- Abrir liga en Mac:
cmd + click en la liga. - Abrir liga en Windows:
alt + click en la liga. - O en cualquiera de los casos, copiar la liga de la terminal y pegarla en el browser que mejor nos funcione.
- Al abrir la liga del servidor local, encontraremos una página en blanco. Sin embargo, conforme modifiquemos el proyecto, podremos ir observando nuestro avance en esta misma página.