|
|
@@ -0,0 +1,76 @@
|
|
|
+# JS Sandbox
|
|
|
+
|
|
|
+Un "bac à sable" pour jouer avec HTML, CSS et surtout JavaScript.
|
|
|
+
|
|
|
+## Installation
|
|
|
+
|
|
|
+Pré-requis :
|
|
|
+
|
|
|
+* (optionnel mais recommandé) Git pour récupérer le dépôt
|
|
|
+* [Nodejs](https://nodejs.org) pour pouvoir exécuter le serveur de l'application
|
|
|
+
|
|
|
+Deux options possibles pour utiliser cet outil :
|
|
|
+
|
|
|
+* **Avec Git**. Il faut alors installer [Git](https://git-scm.org) pour pouvoir cloner le dépot.
|
|
|
+* Alternativement, vous pouvez télécharger l'archive courante du dépôt en suivant [ce lien](https://github.com/bhubr/javascript-sandbox).
|
|
|
+
|
|
|
+## Installation et paramétrage de Git
|
|
|
+
|
|
|
+Avec l'installeur de Git, il suffit, **presque** à chaque étape, de faire "Next".
|
|
|
+
|
|
|
+Sous Windows, une des étapes demande s'il faut ajouter Git au PATH, et il faut cocher cette option.
|
|
|
+
|
|
|
+Git sera installé sous `C:\Program Files\Git`. Sous Git Bash, il devrait être directent accessible par la commande :
|
|
|
+```
|
|
|
+$ git
|
|
|
+```
|
|
|
+
|
|
|
+Si ce n'est pas le cas, il faudra saisir la commande :
|
|
|
+```
|
|
|
+$ export PATH=$PATH:"/c/Program Files/Git/bin"
|
|
|
+```
|
|
|
+
|
|
|
+Ensuite vous devrez, si vous comptez faire des *commits*, paramétrer Git, pour lui dire qui vous êtes (remplacer par vos vrais nom et email) :
|
|
|
+
|
|
|
+```
|
|
|
+$ git config --global user.name "John Doe"
|
|
|
+$ git config --global user.email johndoe@example.com
|
|
|
+```
|
|
|
+
|
|
|
+## Installation de Node.js
|
|
|
+
|
|
|
+Là aussi, l'installeur fait tout, les options par défaut doivent convenir. Node doit être installé sous `C:\Program Files\nodejs`.
|
|
|
+
|
|
|
+Si, après l'avoir installé, vous obtenez une erreur en essayant de lancer `node` depuis Git Bash, c'est qu'il n'est pas accessible. Il faut l'ajouter au PATH comme pour Git :
|
|
|
+```
|
|
|
+$ export PATH=$PATH:"/c/Program Files/nodejs"
|
|
|
+```
|
|
|
+
|
|
|
+**Quand vous lancez `node` sans argument**, il est *normal* que cela semble tourner dans la vide et que vous ne récupériez pas le `$` qui vous invite à saisir des commandes dans le shell.
|
|
|
+
|
|
|
+## Récupération de du dépôt ou de l'archive
|
|
|
+
|
|
|
+Si vous utilisez Git, placez-vous dans le dossier où vous comptez placer la copie du dépôt.
|
|
|
+Puis saisissez :
|
|
|
+```
|
|
|
+$ git clone https://github.com/bhubr/javascript-sandbox.git
|
|
|
+$ cd javascript-sandbox
|
|
|
+```
|
|
|
+
|
|
|
+Si vous utilisez l'archive, il vous faudra aussi vous rendre dans le répertoire qui a été créé par la décompression de celle-ci.
|
|
|
+
|
|
|
+## Installation des dépendances (modules)
|
|
|
+
|
|
|
+Les applications Node utilisent souvent un certain nombre de modules existants. Celle-ci ne fait pas exception à la règle, et les dépendances doivent être installées en entrant :
|
|
|
+
|
|
|
+```
|
|
|
+$ npm install
|
|
|
+```
|
|
|
+
|
|
|
+## Lancement
|
|
|
+
|
|
|
+```
|
|
|
+$ npm install
|
|
|
+```
|
|
|
+
|
|
|
+Puis ouvrez votre navigateur et allez à : http://localhost:3000
|