/ada-cucumber

I like cucumbers

Primary LanguageJavaScriptMIT LicenseMIT

AdaCucumber

Autora: Blanca Ubis Martínez

Basado en el Adalab Starter Kit.

En este proyecto hay 3 tipos de ficheros y carpetas:

  • Los ficheros que están sueltos en la raíz del repositorio, como gulpfile.js, package.json... Son la configuración del proyecto y no necesitamos modificarlos.
  • La carpeta src/: son los ficheros de nuestra página web, como HTML, CSS, JS...
  • La carpeta docs/, que son generadas automáticamente cuando arrancamos el proyecto. El Kit lee los ficheros que hay dentro de src/, los procesa y los genera dentro de docs/.

Guía de inicio rápido

NOTA: Necesitas tener instalado Node JS para trabajar con este proyecto:

Pasos a seguir si queremos arrancar un proyecto basado en este desde cero:

  1. Crea tu propio repositorio.
  2. Descarga este proyecto desde GitHub.
    • No recomendamos que clones este repo ya que no podrás añadir commits.
  3. Copia todos los ficheros de este proyecto en la carpeta raíz de tu repositorio.
    • Recuerda que debes copiar también los ficheros ocultos.
    • Si has decidido clonar este repo, no debes copiar la carpeta .git. Si lo haces estarás machacando tu propio repositorio.
  4. Abre una terminal en la carpeta raíz de tu repositorio.
  5. Instala las dependencias locales ejecutando en la terminal el comando:
npm install

Pasos para arrancar el proyecto:

Una vez hemos instalado las dependencias, vamos a arrancar el proyecto. El proyecto hay que arrancarlo cada vez que te pongas a programar. Para ello ejecuta el comando:

npm start

Este comando:

  • Abre una ventana de Chrome y muestra tu página web, al igual que hace el plugin de VS Code Live Server (Go live).
  • También observa todos los ficheros que hay dentro de la carpeta src/, para que cada vez que modifiques un fichero refresca tu página en Chrome.
  • También procesa los ficheros HTML, SASS / CSS y JS y los genera y guarda en la carpeta public/. Por ejemplo:
    • Convierte los ficheros SASS en CSS.
    • Combina los diferentes ficheros de HTML y los agrupa en uno o varios ficheros HTML.

Después de ejecutar npm start ya puedes empezar a editar todos los ficheros que están dentro de la carpeta src/ y programar cómodamente.

Pasos para generar la carpeta docs:

Ejecutar el siguiente comando:

npm run docs
  • Ello nos generará una carpeta docs/ que subiremos al repositorio.
  • Posteriormente, con GitHub pages le indicaremos que la utilice para generar la web de nuestro proyecto.
  • Habrá que ejecutar este comando al final del proyecto cuando ya esté terminado y queramos publicarlo.
  • Si hacemos algún cambio habrá que ejecutarlo de nuevo y subir la carpeta docs/ nuevamente al repositorio.