diff --git a/README.md b/README.md index 574001d..2025897 100755 --- a/README.md +++ b/README.md @@ -8,4 +8,145 @@ - Lucas Mascaro - Guillaume Fauvet - Adrien Marquès -``` \ No newline at end of file +``` + + +# Installation + +### 1. Clonage des sources + +Placez vous dans le dossier qui contiendra le projet + +```bash +> git clone https://git.xdrm.io/ndli1718/main.git ndli1718-web; +``` + +Si le clonage a fonctionné, il doit maintenant contenir un nouveau dossier `ndli1718-web` contenant les sources. + +### 2. Créer un lien pour Apache/nginx + +Toujours dans le dossier parent (celui qui contient `ndli1718-web`) + +##### 1. Sous apache + +```bash +> ln -s ndli1718-web /var/www/ndli1718-web; +``` + +##### 2. Sous Nginx + +```bash +> ln -s ndli1718-web /usr/local/nginx/html/ndli1718-web; +``` + + +### 3-1. Configuration Apache + +> Si vous n'avez pas apache +> ```bash +> sudo apt-get install apache2 libapache2-mod-php mysql-server php-mysql php; +> ``` + +##### 1. Créer l'hôte virtuel + +Créer le fichier `/etc/apache2/sites-available/ndli1718.conf` + +```xml + + ServerName ndli1718 + + ServerAdmin mail@example.com + DocumentRoot /var/www/ndli1718-web + + ErrorLog ${APACHE_LOG_DIR}/ndli1718-error.log + CustomLog ${APACHE_LOG_DIR}/ndli1718-access.log combined + + #Include conf-available/serve-cgi-bin.conf + +``` + + +##### 2. Enregistrer le nom de domaine local + +Ajouter la ligne suivante dans le fichier `/etc/hosts` + +```txt +127.0.0.1 ndli1718 +``` + +Cela permettra à apache au lieu de chercher le nom de domaine `ndli1718` (qui n'existe pas) de rediriger directement vers vous-même. (Localhost au lieu de passer par des serveurs DNS). + +##### 3. Corriger les permissions + +Dans le dossier des sources (ndli1718-web): + +```bash +> source /etc/apache2/envvars; +> sudo chown -R $USER:$APACHE_RUN_USER .; +> sudo chmod -R 775 .; +> sudo chmod -R g+s .; +``` + + +##### 4. Activer l'hôte virtuel + +```bash +> sudo a2ensite ndli1718.conf; +> sudo service apache2 reload; +``` + + +##### 5. Test de la configuration + +Ouvrer le navigateur de votre choix avec l'URL `http://ndli1718/`. + +Si la page ne fonctionne pas, vérifiez dans les logs d'apache de quoi il s'agit. + +```bash +> tail -f /var/log/apache2/ndli1718-error.log; +``` + + + +### 3-2. Configuration nginx + +**TODO** + + +### 4. Installation webpack / vuejs + +##### 1. Installation de nodejs+npm + +Installation de node js (ajout du repository officiel) +```bash +> curl -sL https://deb.nodesource.com/setup_8.x | sudo -E bash - +> sudo apt-get install -y nodejs +``` + +##### 2. Mise à jour de npm + +```bash +> npm install -g npm@latest; +``` + +*Attention:* Si vous n'avez pas les permissions et qu'il vous demande d'être **root**, suivez ce [tuto](https://docs.npmjs.com/getting-started/fixing-npm-permissions). + + +##### 3. Installation de vue-cli + +```bash +> npm install -g vue-cli; +``` + +##### 4. Construction du projet + +Dans le dossier du projet `ndli1718-web`, lancez les commandes suivantes: + +```bash +> npm install; +> touch ./public_html/js/bundle@a.{js,js.map}; +> npm run build; +``` + + +**.. voila ..** \ No newline at end of file