Commit ff0b1bc7 authored by Stephane Bouvry's avatar Stephane Bouvry
Browse files

MAJ doc developpeur (suppression des informations caduques)

parent 6e1a688e
Loading
Loading
Loading
Loading
+14 −47
Original line number Diff line number Diff line
@@ -8,38 +8,30 @@ Ce document regroupe des informations informelles lièes au développement des f

### Présentation

La compilation du code *front* est centralisée dans les tâches *Gulp* (fichier `gulpfile.js`). Il gère : 
La compilation du SASS > CSS est géré par un Gulp, vous pouvez l'executer pendant le développement : 

 - La compilation des Fichiers `.Vue` (source `./public/js/oscar/src`)
 - Compilation des fichiers SCSS (Sass)

> Certaines parties historiques sont encore développées avec **BackboneJS**, elles seront progressivement remplacées.

Les composants d'interface sont développées avec le *framework* **VueJS**.
 
Le moteur de compilation **POI** (basé sur **Webpack**) est utilisé pour compilé les fichiers `**.vue` Depuis la version 2.5.x, une version 10 de POI est disponible mais n'est pas compatible avec Oscar, les scripts fonctionnent bien avec la version 9.
Les fichiers SASS seront automatiquement surveillés et compilés.

```bash
npm i -g poi
nodejs node_modules/.bin/gulp
```

## Commandes de développement
et la comilation : 

Dans la mesure du possible, la plus part des opérations liés au traitement et à la compilation des modules d'interface ont été regroupé dans l'automatisateur de tache **Gulp** (`gulpfile.js`).
```bash
nodejs node_modules/.bin/gulp sass
```

Les fichiers VUE utilisent l'utilitaire POI (v9)

### Compilations des modules JS basés sur VueJS
> Certaines parties historiques sont encore développées avec **BackboneJS**, elles seront progressivement remplacées.

Construction des fichiers JS : 
Les composants d'interface sont développées avec le *framework* **VueJS**.
 
```bash
# Compilation des JS (VueJS)
gulp modules-oscar
Le moteur de compilation **POI** (basé sur **Webpack**) est utilisé pour compilé les fichiers `**.vue` Depuis la version 2.5.x, une version 10 de POI est disponible mais n'est pas compatible avec Oscar, les scripts fonctionnent bien avec la version 9.

# Compilation des CSS
gulp sass 
```

## Commandes de développement

### Commandes spécifiques

@@ -64,29 +56,4 @@ poi watch --format umd --moduleName ActivitiesExport --filename.css ActivitiesE
poi watch --format umd --moduleName  TimesheetMonth --filename.css TimesheetMonth.css --filename.js TimesheetMonth.js --dist public/js/oscar/dist public/js/oscar/src/TimesheetMonth.vue
```


## BUG Connus

Erreur du watcher GULP : 

```
$ gulp watch
[15:47:44] Using gulpfile ~/Projects/Unicaen/oscar/gulpfile.js
[15:47:44] Starting 'watch'...
[15:47:44] 'watch' errored after 8.94 ms
[15:47:44] Error: watch /home/bouvry/Projects/Unicaen/oscar/public/css/ ENOSPC
    at _errnoException (util.js:1022:11)
    at FSWatcher.start (fs.js:1382:19)
    at Object.fs.watch (fs.js:1408:11)
    at Gaze._watchDir (/home/bouvry/Projects/Unicaen/oscar/node_modules/gaze/lib/gaze.js:289:30)
    at /home/bouvry/Projects/Unicaen/oscar/node_modules/gaze/lib/gaze.js:358:10
    at iterate (/home/bouvry/Projects/Unicaen/oscar/node_modules/gaze/lib/helper.js:52:5)
    at Object.forEachSeries (/home/bouvry/Projects/Unicaen/oscar/node_modules/gaze/lib/helper.js:66:3)
    at Gaze._initWatched (/home/bouvry/Projects/Unicaen/oscar/node_modules/gaze/lib/gaze.js:354:10)
    at Gaze.add (/home/bouvry/Projects/Unicaen/oscar/node_modules/gaze/lib/gaze.js:177:8)
    at new Gaze (/home/bouvry/Projects/Unicaen/oscar/node_modules/gaze/lib/gaze.js:74:10)
```

```bash
echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
```
 No newline at end of file
Les commandes de chaque module sont disponibles en commentaire
 No newline at end of file