node package manager
Love JavaScript? Your insights can make it even better. Take the 2017 JavaScript Ecosystem Survey »

nodebook

Node.js Build Status

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@latest

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

$ nodebook --help
nodebook
 
Commands:
  cli.js chapters [list]        Liste les chapitres de l'ouvrage.
  cli.js install <chapter|all>  Installe les dépendances d'un chapitre.
  cli.js open <chapter>         Ouvre les examples d'un chapitre.
  cli.js read                   Démarre la lecture du livre au format HTML
 
Options:
  --version  Show version number                                       [boolean]
  --help     Show help                                                 [boolean]
 
Examples:
  nodebook install chapter-04  Installe les dépendances du chapitre 4
  nodebook install all         Installe les dépendances de tous les chapitres
  nodebook open chapter-04     Ouvre le chapitre 4 dans un explorateur de
                               fichiers

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

Le code des exemples est vérifié à l'aide d'ESLint. La commande suivante vérifiera que la syntaxe ECMAScript n'entraine pas d'effet secondaires indésirables.

$ 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.