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.

Voici une sélection parmi ma veille du moment, ayant pour objectif de partager des liens mais aussi des sources : il s’agit bien évidemment de liens en rapport avec les thématiques du site (en l’occurrence dans cette fournée on trouvera logiciel libre, opendata, développement et vie privée par exemple), et ils sont plutôt variés ; les sources sont des sites web, des lettres d’actus et des réseaux sociaux (dans le cas présent, tous arrivés jusqu’à moi via des flux RSS/Atom), et c’est aussi une manière de les partager et de vous inviter à les suivre aussi. Dans la suite de la dépêche, on parlera donc en vrac GitHub, sécurité, Ruby, blocage de TikTok, Digital Services Act, biais, test, supervision, IA Act, Ada & Zangemann, pourrissement du web et bien d’autres choses encore.

Sommaire

• En vrac
• Des logiciels libres

En vrac

• forges logicielles et utilisation malveillante : Send()-ing Myself Belated Christmas Gifts - GitHub.com's Environment Variables & GHES Shell (avec une partie sur les attaques par réflexion en Ruby) et GitCaught: Threat Actor Leverages GitHub Repository for Malicious Infrastructure (via badcyber.com)
• une nouvelle liste de diffusion Siren annoncée par l'Open Source Security Foundation (OpenSSF) pour partager le renseignement sur les menaces sur les projets libres (via badcyber.com)
• un sujet qui touche aussi LinuxFr.org, le pourrissement des liens et la décomposition des contenus sur le web : Link Rot and Digital Decay on Government, News and Other Webpages: When Online Content Disappears annonce qu'un quart des pages web qui ont existé à un moment entre 2013 et 2023 ne sont plus disponibles, et ça monte à 38% pour la seule année de 2013. Cela concerne aussi plus de la moitié de liens donnés en référence sur Wikipedia par exemple (via badcyber.com).
• La Quadrature du Net attaque en justice le blocage de TikTok en Nouvelle-Calédonie (via le lien LinuxFr.org et via Olivier Tesquet ou via le flux LQDN ou…), et le Conseil d'État a refusé de lever l’interdiction d’opérer
• IA (et la fIAtigue qui monte)
  • l'Artificial Intelligence Act adopté en Europe (voir EU Approves Historic AI Act: Pioneering Comprehensive AI Regulation, toujours via Bearstech)
  • la réaction de La Quadrature du Net Le règlement IA adopté, la fuite en avant techno-solutionniste peut se poursuivre. Et udm14 pour éviter l'IA sur Google Search (source)
• la dernière édition « Santé mentale, toile d'araignée et larmes d'émeraude » de La cyber-revue hebdo mentionne des sujets peu funky, dont le rôle de la faille JumpServer (solution libre de bastion et audit système) CVE-2024-29201 utilisée en « test » sur les pays du Sud par les cybermalfrats
• Ada & Zangemann - Un conte sur les logiciels, le skateboard et la glace à la framboise (voir la dépêche) sera-t-il adapté en film d'animation ? C'est la volonté de la FSFE, aidez-les (via bearstech et le flux de la FSFE)
• la dernière édition de la revue de presse Khrys’presso datée du 20 mai 2024 mentionne un article scientifique de 2016 Gender bias in open source: Pull request acceptance of women versus men, la censure par le Conseil constitutionnel français (article FranceTV info) d'une partie de la loi pour sécuriser internet (SREN) concernant la création d'un « délit d'outrage en ligne », pour ce qui « porte atteinte à la dignité d'une personne ou présente à son égard un caractère injurieux, dégradant ou humiliant » ou « crée à son encontre une situation intimidante, hostile ou offensante », et un papier intitulé EU Platform Regulation in the Age of Neo-Illiberalism sur les plateformes et la directive Digital Services Act (DSA) européenne.
• le délégué général de l'April Frédéric Couchet rappelle sur son blog que les candidatures pour le prix science ouverte du logiciel libre de la recherche 2024 sont ouvertes, jusqu'au 24 juin, la création de « la lettre d'information Dans les algorithmes » qui « a pour ambition de pointer les problèmes de la société numérique, d’en discuter, de les mettre en débat » (voir l'annonce sur Mastodon et le lien sur la veille faite sur Flus par l'un des auteurs) ; ainsi qu'un entretien avec Delphine Montagne, fonctionnaire et wikimédienne en résidence chez code.gouv.fr (source)
• réparabilité des appareils Samsung : iFixit is ending collaboration with Samsung
• MessageFormat 2.0: a new standard for translatable messages et MessageFormat 2.0: A domain-specific language? (source via Adrien Dorsaz)

Des logiciels libres

• toujours Bearstech et sa liste apparemment infinie de logiciels libres à nous faire découvrir :
  • SolidStart framework Open Source pour applications Solid (source)
  • Bulletproof React pour des applications React prêtes pour la production (source)
  • WezTerm terminal rapide et multiplateforme, en Rust (source)
  • NamViek gestion de projet Open Source pour les petites équipes (source)
  • Activepieces pour automatiser vos workflows (source)
  • Ventoy pour créer des clés USB amorçables (source)
  • CADmium CAD (ou CAO) directement dans le navigateur (source)
  • OpenCart plateforme e-commerce en PHP (source)
  • Apisix passerelle API dynamique et haute performance (source)
  • Parse Server un backend pour Node.js/Express (source)
  • jobq pour une gestion simple des files d'attente de tâches (source)
  • GitUI interface terminal pour Git, en Rust (source)
  • Bend langage de programmation « haut niveau, massivement parallèle, supportant les "higher-order functions" et la récursivité sans annotations parallèles explicites » (source)
  • Firecrawl pour transformer des sites Web en markdown ou en données structurées (source)
  • Isleward un roguelike multijoueur (source),
  • StackStorm une solution automatisée Open Source pour la gestion d'événements, le dépannage, et le déploiement (source)
  • Antora un générateur de sites de documentation open source utilisant AsciiDoc (source)
  • BTW pour créer facilement votre blog personnel (source)
  • Piko pour gérer le trafic de production, notamment sur Kubernetes (source)
  • Jellyfin un système média (source)
  • Botan une bibliothèque de cryptographie complète pour C++ (source)
  • Glance un tableau de bord pour flux (source)
  • docker Selenium pour simplifier l'automatisation des navigateurs (source)
  • Zoraxy pour le routage réseau de votre homelab (source)
  • 100 exercices pour progresser en Rust (source)
  • HVM2 une VM massivement parallèle optimisée pour l'exécution de langages de haut niveau sur du matériel parallèle comme les GPU (source)
• le Framablog a publié deux articles Argos Panoptès : la supervision de sites web simple et efficace et Argos Panoptès, l’interview (à ne pas confondre avec Argo CD ou le langage Argos ou un certain nombre de projets ayant le même nom)
• il y a tellement de logiciels libres mentionnés dans la lettre d'info anglophone « SRE/Devops/Sysadmin » de Xavier Pestel. Sachez qu'on y a parle Kubernetes/Docker, Linux, observabilité, base de données, sécurité, Python, etc.