JavaScript CSS Other
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.github/ISSUE_TEMPLATE Outillage : ajout du template Example May 14, 2018
appendix-a s/ElasticSearch/Elasticsearch/ Jul 17, 2018
bin Outillage : mise à jour pour asciidoctor.js@1.5.7-rc.2 Jul 8, 2018
chapter-01 Gras/italique Jul 23, 2018
chapter-02 Gras/italique Jul 23, 2018
chapter-03 Gras/italique Jul 23, 2018
chapter-04 Gras/italique Jul 23, 2018
chapter-05 Tous les chapitres : Utilisation d'une autre syntaxe de surlignage de… Jul 8, 2018
chapter-06 Mise en forme des liens orphelins Jul 10, 2018
chapter-07 Chapitre 7 : correction des tests Jul 22, 2018
chapter-08 Chapitre 7 : Modulariser le code des routes Jul 19, 2018
chapter-09 Gras/italique Jul 23, 2018
docs Chapitre 7 : Introduction/conclusion Jul 22, 2018
foreword Avant-propos : Actualisation des contenus Jul 12, 2018
src Outillage : vérifie le XML généré avant de passer à la suite Jul 22, 2018
tests Fix tests Windows Jul 22, 2018
.eslintignore Chapitre 4 : Réduction de la longueur des exemples à 64 caractères pa… Jul 1, 2018
.gitattributes Configuration de git-lfs pour les fichiers vidéos (#126) May 11, 2017
.gitignore Chapitre 7 : Sessions utilisateurs Jul 17, 2018
.npmignore Chapitre 7 : Sessions utilisateurs Jul 17, 2018
.travis.yml Outillage : vérifie le XML généré avant de passer à la suite Jul 22, 2018
LICENSE README : clarification du contenu Jan 1, 2018
Makefile Deploy artefacts on build success May 6, 2018
README.md Tweak du README Jul 23, 2018
appveyor.yml Chapitre 9 : exemple affiché en plusieurs morceaux Jul 22, 2018
book.adoc Suppression de la préface Jul 11, 2018
cover.png Réorganisation des chapitres Feb 8, 2015
index.adoc Suppression de la préface Jul 11, 2018
package-lock.json 1.0.0-beta.1 Jul 23, 2018
package.json 1.0.0-beta.1 Jul 23, 2018
sandbox.md Conversion du code vers ES2015 Jan 17, 2017
server.js Outillage : exemples sur une longueur de 63 caractères (#272) Jun 27, 2018

README.md

Node.js • Apprendre par l'exemple Build Linux Build Windows Backers on Open Collective Sponsors on Open Collective

Devenez autonome avec JavaScript, l'écosystème npm, le développement frontend, les applications web et en ligne de commande.

📖 Journal de bord d'écriture • 2018 • 2017.
👀 Lire l'ouvrage • sur papier • sur le web • avec Node.js.
🎧 Ce que j'écoute en boucle quand j'écris.

Table des matières

Légende • ✍️ = écriture/corrections • ✅ = terminé.

Statut Chapitre Objectif d'apprentissage
✅ Avant-propos pourquoi tu écris cet ouvrage ? -
✅ 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
✅ Créer une application web ça marche comment HTTP ? issues
✅ Créer un outil en ligne de commande ça marche comment du code métier dans le terminal ? issues
✅ Créer une application frontend ça marche comment les modules Node dans les navigateurs web ? issues
✅ Annexe : Sélection de modules npm quel(s) module(s) npm choisir ou découvrir ? issues

Lire l'ouvrage

Sur le web

🌐 L’épreuve est consultable gratuitement à cette adresse : https://oncletom.io/node.js/.

Fonctionnalités : exemples interactifs, vidéos, mise à jour en continu.

Sur papier

⏳ Sortie fin octobre 2018.

Fonctionnalités : confort de lecture, annotations libres, rémunère mon travail.

Sur liseuse numérique

⏳ Sortie fin octobre 2018 (à confirmer).

Fonctionnalités : ne prend pas de place sur l'étagère, rémunère mon travail.

Avec Node.js

📦 Le livre est disponible en tant que module npm : nodebook.

Fonctionnalités : apprendre Node.js avec Node.js, tous les exemples sont fonctionnels, lecture hors-ligne.

$ npm install --global nodebook
$ nodebook install all

Cette commande télécharge une copie du livre et les dépendances des exemples pour une utilisation hors-ligne.

Le manuel d'utilisation s'invoque avec l'argument --help :

$ 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
                                            d'exemples du chapitre 4
  cd $(nodebook dir chapter-04 --root)      Place le terminal dans le répertoire
                                            racine du chapitre 4

Contribuer

Je vous invite à contribuer de la manière de votre choix — par e-mail, en ouvrant une issue ou en contribuant du texte ou du code.

Si vous n'êtes pas sûr·e de votre coup mais que l'envie est là, c'est suffisant pour démarrer 🙂. Nous éclaircirons les choses ensemble.

Installation

Il est possible de travailler sur une copie locale de l'épreuve en la dupliquant avec Git.

$ git clone --single-branch https:/github.com/oncletom/nodebok
$ cd nodebook
# Installe les dépendances de développement
$ npm ci
# Installe les dépendances des chapitres
$ npm run install:all

Cette commande facultative récupère les vidéos localement :

$ git lfs pull

Elle utilise l'extension git-lfs.

Prévisualiser

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

$ npm start

L'épreuve est accessible sur http://localhost:3000.

Tests

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

$ npm test

Génération des épreuves

HTML

$ make build-html
$ open ./dist

DocBook

$ make build-docbook
$ soffice ./dist/book.xml

OpenDocument

$ make build-odt
$ soffice ./dist/book.fodt

Contributrices et Contributeurs

Merci à vous pour avoir contribué à l'ouvrage grâce à vos relectures, corrections et demandes de clarification.

Mentions légales

Node.js • Apprendre par la pratique est un ouvrage rédigé par Thomas Parisot. Il est édité, publié et distribué en papier et e-book par les éditions Eyrolles.

L’épreuve est soumise à la licence Creative Commons NC-BY-SA 4.0 (Attribution, Non-Commercial, Share Alike).
Les exemples de code sont placés sous la licence MIT.