Skip to content

Commit 04206bb

Browse files
AlexinfosSituphen
authored andcommitted
Mise à jour de la documentation
1 parent 9f53562 commit 04206bb

File tree

3 files changed

+12
-23
lines changed

3 files changed

+12
-23
lines changed

doc/source/delay-issue.rst

Lines changed: 0 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -2,19 +2,6 @@
22
Problème de lenteur lors du dev ?
33
=================================
44

5-
J'ai des lenteurs avec gulp (build|watch)
6-
-----------------------------------------
7-
8-
Pour le développement et uniquement ce but, notre script `gulp` prend en entrée un paramètre ``--speed`` qui désactive les optimisations du code pour la prod. Ainsi ``watch`` a besoin de calculer moins de choses donc utilise moins de CPU.
9-
10-
Avec gulp il faudra faire :
11-
12-
.. sourcecode:: bash
13-
14-
$ yarn run watch --speed
15-
16-
Si vous utilisez ``make run`` pour lancer le site, cette configuration est utilisée par défaut.
17-
185
Le changement de page est très lent !
196
--------------------------------------
207

doc/source/front-end.rst

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ Il s'agit donc de la partie du code définissant le design et l'affichage, mais
1010
+ `SASS (en) <http://sass-lang.com/>`__ pour les feuilles de style ;
1111
+ JavaScript pour les interactions.
1212

13-
`Node.js (en) <https://nodejs.org/>`__, `yarn (en) <https://yarnpkg.com/en/>`__ (gestionnaire de paquet pour Node.js) et `Gulp (en) <http://gulpjs.com/>`__ sont utilisés pour générer le code final minifié et cohérent. Le développement du *front-end* requiert donc des outils spécifiques dont l'installation `est expliquée ici <install/extra-install-frontend.html>`__.
13+
`Node.js (en) <https://nodejs.org/>`__, `yarn (en) <https://yarnpkg.com/en/>`__ (gestionnaire de paquet pour Node.js) et `Vite (en) <https://vite.dev/>`__ sont utilisés pour générer le code final minifié et cohérent. Le développement du *front-end* requiert donc des outils spécifiques dont l'installation `est expliquée ici <install/extra-install-frontend.html>`__.
1414

1515
**Navigateurs supportés** : Les dernières versions de Mozilla Firefox, Google Chrome, Safari et Microsoft Edge.
1616

doc/source/install/extra-install-frontend.rst

Lines changed: 11 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ Pour ce qui est de Node.js, utilisez soit votre gestionnaire de paquet, soit nvm
4545
Installation des dépendances Yarn
4646
---------------------------------
4747

48-
L'installation de Gulp, ainsi que des différentes dépendances et bibliothèques, se fait via Yarn dans le répertoire du projet :
48+
L'installation de Vite, ainsi que des différentes dépendances et bibliothèques, se fait via Yarn dans le répertoire du projet :
4949

5050
.. sourcecode:: bash
5151

@@ -63,15 +63,19 @@ Utilisation des outils
6363
Vous avez installé les outils ? Voilà comment on s'en sert dans notre projet !
6464

6565

66-
Présentation de Gulp
66+
Présentation de Vite
6767
--------------------
6868

69-
Gulp est un outil permettant d'automatiser les tâches liées au *front-end*. C’est une sorte de Makefile.
69+
Vite est un outil de construction (*build tool*) permettant d'automatiser certaines tâches liées au *front-end*. Il permet dans notre cas de :
7070

71-
Utilisation de Gulp
71+
- assembler et minifier le JavaScript ;
72+
- compiler le SCSS en CSS ;
73+
- copier et optimiser différentes ressources utilisées par le frontend (images, polices, etc.).
74+
75+
Utilisation de Vite
7276
-------------------
7377

74-
Gulp se lance avec ``yarn run gulp -- [tâche]`` où ``[tâche]`` est la tâche à lancer.
78+
Vite se lance avec ``yarn run vite-dev``.
7579

7680
Générer les fichiers avec ``build``
7781
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -100,7 +104,7 @@ Les fichiers générés sont disponibles dans le dossier ``dist/`` (un aperçu e
100104
C'est la tâche que vous utiliserez sûrement le plus souvent car vous devez la lancer à chaque modification
101105
de ``assets/`` !
102106

103-
Si vos modifications n'apparaissent pas dans votre navigateur et que ce n'est pas dû à Gulp, pensez à vider le cache de votre navigateur !
107+
Si vos modifications n'apparaissent pas dans votre navigateur et que ce n'est pas dû à Vite, pensez à vider le cache de votre navigateur !
104108

105109
Supprimer les fichiers générés avec ``clean``
106110
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -127,11 +131,9 @@ Coder plus simplement avec ``watch``
127131

128132
``watch`` surveille les fichiers SCSS et Javascript lance la tâche ``build`` dès qu'ils sont modifiés. C'est très utile pour le développement car ça permet de ne pas avoir à relancer ``build`` manuellement. Pour lancer cette commande, faites ``make watch-front`` ou ``yarn run watch``. Pour arrêter cette commande, il suffit de presser ``Ctrl+C``.
129133

130-
Si votre ordinateur n'est pas très puissant ou la commande ``watch`` est lente. Vous aurez besoin de l'option ``--speed``. Cette option permet de désactiver les fonctions de parsing pour la prod. Ainsi ``watch`` a besoin de moins de CPU.
131-
132134
.. sourcecode:: bash
133135

134-
$ npm run watch -- --speed
136+
$ npm run watch
135137

136138

137139
-----

0 commit comments

Comments
 (0)