Node.js

Bonnes pratiques pour la programmation JavaScript applicative, universelle et modulaire

Le contenu est actuellement en cours d'écriture 🚧. Certaines sections sont terminées ✅. Tu peux suivre la progression en lisant le journal de bord.

Table des matières

Statut	Chapitre	Objectif d'apprentissage
🚧	Préface de David Bruant	-	-
✅	Avant-propos	-	-
✅	Histoire, écosystème et gouvernance	ça marche comment la vie de Node et des gens qui le font ?	issues
✅	Installer, mettre à jour et développer	ça marche comment Node sur une machine ?	issues
✅	Jouer avec JavaScript	ça marche comment JavaScript ?	issues
🚧	Jouer avec Node.js	ça marche comment les modules ?	issues
🚧	Jouer avec npm	ça marche comment l'outil npm ?	issues
🚧	Déployer notre code	ça marche comment côté hosting ?	issues
🚧	Faire une application web	ça marche comment HTTP ?	issues
🚧	Faire un outil en ligne de commande	ça marche comment du code métier dans le terminal ?	issues
✅	Faire une application frontend	ça marche comment les modules Node dans les navigateurs web ?	issues
🚧	Annexe : Sélection de modules npm	-	issues
🚧	Annexe : Design Patterns	-	issues

Lire

En ligne

L’épreuve est consultable gratuitement dans un navigateur Web à cette adresse : https://oncletom.io/node.js/ 🌎.

De nombreux exemples sont interactifs sans avoir à installer le moindre logiciel sur son ordinateur.

Fonctionnalités : exemples interactifs, vidéos, renvois.

Au format papier / e-book

À venir.

Avec Node.js

Cette commande télécharge une copie du livre, les exemples associés ainsi que leurs dépendances pour une utilisation hors-ligne.

Le livre s'installe de cette manière, via un terminal :

$ npm install --global nodebook

Une fois installé, le manuel d'utilisation s'invoque de cette manière :

$ nodebook --help

Commandes:
  nodebook chapters               Liste les chapitres de l'ouvrage.
  nodebook dir <chapter>          Affiche le chemin vers un chapitre.
  nodebook install <chapter|all>  Installe les dépendances d'un chapitre.
  nodebook read                   Démarre la lecture du livre au format HTML

Options:
  --version  Affiche le numéro de version                              [booléen]
  --help     Affiche de l'aide                                         [booléen]

Exemples:
  nodebook install chapter-04               Installe les dépendances du chapitre
                                            4
  nodebook install all                      Installe les dépendances de tous les
                                            chapitres
  cd $(nodebook dir chapter-04)             Place le terminal dans le répertoire
                                            du chapitre 4
  cd $(nodebook dir chapter-04 --examples)  Place le terminal dans le répertoire
                                            d'exemples du chapitre 4

Contribuer

Le moyen le plus simple de contribuer est de proposer une pull request. L'interface en ligne de GitHub est de loin la plus simple à prendre en main.

Installation

Il est possible de travailler sur une copie locale de l'épreuve en la dupliquant avec Git. git-lfs est nécessaire à la récupération des fichiers volumineux.

$ git clone --single-branch https:/github.com/oncletom/nodebok
$ cd nodebook
$ npm install
$ git lfs pull # si vous avez installé git-lfs après avoir cloné le dépôt

Prévisualiser

Un serveur local est également disponible pour prévisualiser vos modifications sans être connecté à Internet.

$ PORT=3000 npm start

Tests

La bonne santé des exemples est vérifiée à l'aide d'ESLint et de tape-spawn.

$ npm test

Génération de l'épreuve HTML

$ npm run build:html
$ open ./dist

Mentions légales

Node.js — bonnes pratiques pour la programmation JavaScript applicative, universelle et modulaire est un ouvrage rédigé par Thomas Parisot. Il est édité et publié en format papier et e-book par Eyrolles.

L’épreuve est soumise à la licence Creative Commons NC-BY-SA (Attribution, Non-Commercial, Share Alike).

Les exemples de code sont placés sous la licence MIT.

michelc / nodebook