Skip to content

Latest commit

 

History

History
176 lines (130 loc) · 6.91 KB

README.md

File metadata and controls

176 lines (130 loc) · 6.91 KB
Raw

Node.js Build Linux Build Windows

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

Le contenu est actuellement en cours d'écriture 🚧. Les sections marquées par ✅ sont terminées.

Journal de bord d'écriture 📖 2018 • 2017.

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
🚧 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 - issues

Lire

Avec un navigateur web

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 et npm

Le livre est disponible en tant que module npm : nodebook. C'est le moyen recommandé pour exécuter les exemples sur son ordinateur.

$ npm install --global nodebook

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

Une fois installé, 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

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 clone --single-branch https:/github.com/oncletom/nodebok
$ cd nodebook
$ npm install

Optionellement, git-lfs est nécessaire à la récupération des fichiers volumineux.

$ git lfs pull

Prévisualiser

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

$ 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 des épreuves

HTML

$ npm run build:html
$ open ./dist

DocBook

$ npm run build:docbook
$ soffice ./dist/book.xml

OpenDocument

$ npm run build:odt
$ soffice ./dist/book.fodt

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.