La documentation du langage Rust (le langage qui veut remplacer le C et le C++ en sécurisant l’accès mémoire et en supprimant le ramasse-miette) est écrite en Markdown.

Comme cette documentation doit pouvoir suivre l’évolution du langage (et donc évoluer avec chaque version de Rust) l’équipe Rust a créé mdBook pour pouvoir générer un livre en PDF à partir de chapitres HTML écrits en Markdown.

Licence de mdBook

mdBook est un logiciel libre sous licence Mozilla Public Licence v2.0.

Vous pouvez en trouver les sources pour y contribuer sur GitHub (https://github.com/rust-lang/mdBook).

Pour savoir comment contribuer à améliorer mdBook suivez le guide en anglais (https://github.com/rust-lang/mdBook/blob/master/CONTRIBUTING.md).

Installation de mdBook 0.52

Les fichiers sources d’installation sont disponibles sur GitHub pour MacOS, Windows, et Linux.

Vous pouvez aussi installer mdBook, si vous avez installé au préalable le langage Rust sur votre ordinateur en écrivant dans une fenêtre de Terminal la commande :
cargo install mdbook

Comme cela vous pourrez voir en direct comment cargo compile un programme Rust.

Création de votre mdBook

Mettez mdBook dans la variable PATH de votre poste, pour lancer les commandes mdbook depuis n’importe quel endroit.

Pour créer un mdBook, utilisez votre terminal pour lancer la commande mdbook init livre-exemple.
Cette commande créera le répertoire vide « livre-exemple ».
mdBook vous posera alors plusieurs questions pour créer votre premier livre vide.

Allez dans ce nouveau répertoire avec la commande cd livre-exemple (\home\nom_utilisateur\livre-exemple sur un ordinateur GNU/Linux).

Puis lancez le serveur Web local de votre livre avec la commande mdbook serve --open.

Cette commande va lancer le serveur Web local et ouvrir votre navigateur par défaut sur votre mdBook vide.

Fichiers de configuration

book.toml

Ce fichier contient le titre de votre futur livre dans le champ "title".
Il contient aussi un champ « author » à renseigner avec votre nom (ou votre pseudo-littéraire) et un champ « langage » qui par défaut à la valeur « en », mais que vous pouvez évidemment modifier en « fr » avec votre éditeur de texte favori (gedit par exemple sous GNU/Linux).

src/SUMMARY.md

Ce fichier contient la structure de votre futur livre (la liste des chapitres).
Pour créer facilement un chapitre, une préface, une introduction, une annexe… ajoutez des lignes dans ce fichier Markdown.

Par exemple :

    # Summary

    - [00-Introduction](./Introduction.md)
    - [01-Mon premier chapitre](./01-mon-premier-chapitre.md)

Les chapitres seront créés vides dans le répertoire src au fur et à mesure de votre saisie dans le fichier src/SUMMAY.md par le programme mdBook.

Publication de votre mdBook

Une fois vos chapitres créés en Markdown avec votre éditeur de texte, publiez votre mdBook avec la commande :
mdbook build.
Cette commande créera un répertoire \livre-exemple\book. Vous pourrez diffuser ce sous-répertoire « book » sur votre serveur Web en le transférant par FTP.

Astuce : rien ne vous empêche de renommer ce répertoire « book » en fr-livre-exemple-2026 avant de le transférer en FTP sur votre serveur Web.

Les 4 fonctionnalités de votre mdBook

1) La table des matières s’affiche en cliquant sur le menu hamburger en haut à gauche de votre page Web.

2) Vous pouvez changer le thème de votre page Web en cliquant sur le pinceau (par défaut le thème affiché est « Auto »).

3) Vous pouvez chercher un mot dans votre mdBook en cliquant sur la loupe.

4) Vous pouvez imprimer ce livre (au format PDF, ou sur votre imprimante) en cliquant sur l’icône de l’imprimante en haut à droite de votre page Web.

Utilisations possibles de mdBook

Vous pouvez utiliser mdBook pour créer la documentation multilingue de votre logiciel libre (par exemple un mdBook en français et un mdBook en anglais), voire de votre distribution GNU/Linux préférée.

Vous pouvez préciser la licence de votre livre en créant un chapitre licence, et par exemple choisir de publier votre livre en licence Creative Commons, Cecill ou Art Libre.

Vous avez envie de contribuer à des projets libres mais vous ne savez pas trop par où commencer ? Un groupe de contributeurs et contributrices vient d'annoncer la mise en ligne d'Open Source Masterclass, un MOOC entièrement libre (CC-BY-SA) qui vise précisément à répondre à cette question. Il est écrit par des contributeurs expérimentés des projets Open edX, OpenStack, Wikipedia, etc.

Concrètement, le cours mêle théorie et pratique autour de l'écosystème FLOSS. Au programme :

• un peu d'histoire du logiciel libre (ça ne fait jamais de mal) ;
• les forges logicielles ;
• le fonctionnement des communautés et la communication dans les projets ;
• et surtout, un accompagnement pas à pas vers une première vraie contribution à un projet libre.

L'idée n'est donc pas seulement de regarder des vidéos dans son coin, mais bien d'arriver au bout avec un patch ou une merge request à son actif.

À signaler aussi à toute personne de votre entourage qui coderait mais n'aurait pas encore franchi le pas de la contribution. :-)

Retours, suggestions et commentaires sur le contenu sont les bienvenus !

Open ModelSphere est un outil de modélisation et de gestion de modèles, qui combine les fonctionnalités de modélisation de processus, de données et UML, tout en offrant un environnement de gestion de modèles des plus flexibles. Il est aussi possible de générer des diagrammes via du code ou base de données.

Parce qu’il a été conçu en Java, Open ModelSphere peut être installé sur la plupart des plateformes, soit Windows, Linux et Unix.

Open ModelSphere permet aux utilisateurs de construire leurs modèles plus facilement, à partir de zéro ou via rétro-ingénierie provenant d’une variété de sources (SGBDR ou autres sources non-relationnelles comme Java).

Les utilisateurs peuvent choisir entre plusieurs systèmes cibles SQL, comme Oracle, Informix, SQL Server de Microsoft, Sybase et DB2 UDB. Ensuite, ils peuvent facilement employer le processus de génération pour mettre leurs bases de données à jour.

Open ModelSphere propose également une fonction de génération de rapport en format HTML améliorée, permettant une personnalisation du contenu et du format.

Il offre une documentation API ouverte qui facilite l’intégration de la solution Open ModelSphere dans les environnements de développement existants.

Grace à la notion de plugin, des fonctionnalités peuvent être ajoutées à l’application.

Historique

Au début des années 1990, des professeurs et des étudiants de l’Université Laval ont lancé le développement d’un outil CASE (Génie Logiciel Assisté par Ordinateur) qui allait devenir le produit commercial Silverrun. Ce n’est qu’en 2008 que l’entreprise a pris le virage de l’innovation ouverte en libérant le code source du logiciel. Il est rare qu’un logiciel de cette trempe soit libéré. De la documentation utilisateur et technique existe.

Énormément de patrons de programmation et de concepts sont employés par l’application qui est une vraie mine d’or pour tout développeur.

Pour ces raisons, j’ai décidé de faciliter l’usage de l’application en lui permettant de fonctionner avec Java 11 et Gradle. Si vous avez du temps, il ne faut pas hésiter à y participer.