pacoispaco / nodebook

Ouvrage web et papier sur Node.js publié aux éditions Eyrolles • en cours de rédaction

Node.js

Bonnes pratiques pour la programmation JavaScript applicative, universelle et modulaire

Table des matières

Écriture	Relecture	Chapitre
		Préface de David Bruant
🆗	🆗	Avant-propos
🆗	🆗	Introduction à Node.js
🚧		Premiers pas avec Node.js
		Développer une application web
🆗		Développer pour les navigateurs web
		Développer un automate de traitement de données
📝		Héberger, déployer et monitorer
🚧		Annexe A : Sélection de modules npm

Installation

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

$ npm install --global nodebook@latest
$ nodebook --help
Commands:
  chapter <number> [install|examples]  Installe, ouvre les examples ou
                                       positionne dans un chapitre.
  read                                 Démarre la lecture du livre au format
                                       HTML

Options:
  --help  Show help                                                    [boolean]

Examples:
  nodebook chapter 4          Positionne le terminal dans le chapitre 4
  nodebook chapter 4 install  Installe les dépendances du chapitre 4
  nodebook chapter 4 open     Ouvre le chapitre 4 dans un explorateur de
                                fichiers

Participation

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

Des extensions Chrome et Firefox se chargeront du rendu en temps réel dans le navigateur. Dans les options de l'extension, prenez soin d'autoriser le chargement des fichiers et utilisez le mode safe pour autoriser le rendu des exemples de code :

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

Lire le livre

L’épreuve est consultable dans un navigateur Web via oncletom.io/node.js.

La version Web est générée automatiquement et directement à partir des sources Asciidoc utilisées pour l'épreuve papier.

Le livre sera disponible en rayons lorsque le Bon à Tirer (BAT) aura été signé.

Mentions légales

Node.js — bonnes pratiques pour la programmation JavaScript applicative, universelle et modulaire est un ouvrage rédigé par Thomas Parisot et publié aux éditions Eyrolles.

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

Les exemples de code sont soumis à une licence MIT et le cas échéant, à une license spécifiée par l’auteur du programme.