Créer des documents simplement avec Pillar

Magazine
Marque
GNU/Linux Magazine
Numéro
192
Mois de parution
avril 2016
Spécialité(s)


Résumé
Pillar est un format textuel simple et concis. Un de plus ? Oui. Les développeurs de Pillar (dont moi) ont réutilisé le parser d'un vieux CMS appelé Pier et l'ont modifié jusqu'à en faire une plateforme idéale pour tous leurs besoins de documentation : des livres (dont 3 terminés ou quasiment terminés), des manuels techniques, des slides de cours (dont un MOOC sur Pharo) et des sites web. Le résultat de ce travail est un outil incluant des fonctions puissantes comme les éléments référençables (les titres, les figures, les scripts), la génération automatique de texte, la numérotation finement paramétrable des titres, et la génération de slides et de colonnes de texte. Cet article présente un tutoriel d'utilisation et les bases de la syntaxe Pillar.

Pillar [1] est un format textuel simple et concis, c'est aussi un logiciel libre (licence MIT) et multiplateforme, écrit en Pharo [2], permettant de convertir un texte Pillar vers un fichier PDF avec LaTeX (voir figure 1), HTML (voir figure 2) ou Markdown. D'autres formats de sortie sont en développement ou prévus comme Asciidoc et un format XML propre à une plateforme de cours en ligne.

Pillar a déjà été utilisé à de nombreuses occasions dans la communauté Pharo afin de produire des articles, des livres [3][4], le contenu des CMS Pier et Marina, le contenu du générateur de sites web statiques Ecstatic [5] et même le MOOC (cours en ligne) Pharo [6] pour la plateforme France Université Numérique (60 cours avec enseignant filmé, des dizaines de screencasts, des exercices de conception, des quiz, etc.). Pillar peut générer non seulement des documents textuels (livres, sites), mais aussi des slides (avec DeckJS ou Beamer, voir figure 3) pour illustrer des...

Cet article est réservé aux abonnés. Il vous reste 94% à découvrir.
S'abonner à Connect
  • Accédez à tous les contenus de Connect en illimité
  • Découvrez chaque semaine un nouvel article premium
  • Consultez les nouveaux articles en avant-première
Je m'abonne


Article rédigé par

Par le(s) même(s) auteur(s)

Développer une extension compatible Firefox, Chromium et autres navigateurs

Magazine
Marque
GNU/Linux Magazine
Numéro
212
Mois de parution
février 2018
Spécialité(s)
Résumé
Avec quelques notions de JavaScript, HTML et CSS, vous pouvez facilement développer une extension à votre navigateur web préféré. Dans cet article, vous explorerez l'API WebExtension permettant de créer des extensions compatibles Firefox, Chromium, Opera et quelques autres navigateurs. Étape par étape vous implémenterez une barre latérale donnant un sommaire interactif de la page web.

Réalisation d’un paquet Emacs : un navigateur de tickets GitHub

Magazine
Marque
GNU/Linux Magazine
Numéro
207
Mois de parution
septembre 2017
Spécialité(s)
Résumé
Emacs montre toute sa puissance à ceux qui le placent au centre de leur quotidien : lecture de courriers électroniques et de flux RSS, gestion des tâches et calendriers, navigation dans des systèmes de fichiers locaux et distants, manipulation de dépôts git, etc. Dans cet article, nous verrons comment quelques lignes d’Emacs Lisp, que nous introduirons, permettent d’interroger facilement un serveur distant (GitHub) et d’en formater la réponse en vue d’une utilisation efficace depuis Emacs. Ce qui suit s'adresse aux débutants en Emacs et en Lisp.

Nix et NixOS

Magazine
Marque
GNU/Linux Magazine
Numéro
203
Mois de parution
avril 2017
Spécialité(s)
Résumé
Nix est un gestionnaire de paquets purement fonctionnel pour GNU/Linux et OS X. NixOS est une distribution GNU/Linux basée sur Nix et entièrement configurable dans un fichier texte. Nous verrons comment les fonctionnalités de mise à jour atomique, d'annulation, ou encore d'installation en parallèle d'un même paquet font de l'écosystème Nix un superbe environnement de travail.

Les derniers articles Premiums

Les derniers articles Premium

Du graphisme dans un terminal ? Oui, avec sixel

Magazine
Marque
Contenu Premium
Spécialité(s)
Résumé

On le voit de plus en plus, les outils en ligne de commandes s'étoffent peu à peu d'éléments graphiques sous la forme d'émojis UTF8. Plus qu'une simple décoration, cette pointe de « graphisme » dans un monde de texte apporte réellement un plus en termes d'expérience utilisateur et véhicule, de façon condensée, des informations utiles. Pour autant, cette façon de sortir du cadre purement textuel d'un terminal n'est en rien une nouveauté. Pour preuve, fin des années 80 DEC introduisait le VT340 supportant des graphismes en couleurs, et cette compatibilité existe toujours...

Game & Watch : utilisons judicieusement la mémoire

Magazine
Marque
Contenu Premium
Spécialité(s)
Résumé

Au terme de l'article précédent [1] concernant la transformation de la console Nintendo Game & Watch en plateforme de développement, nous nous sommes heurtés à un problème : les 128 Ko de flash intégrés au microcontrôleur STM32 sont une ressource précieuse, car en quantité réduite. Mais heureusement pour nous, le STM32H7B0 dispose d'une mémoire vive de taille conséquente (~ 1,2 Mo) et se trouve être connecté à une flash externe QSPI offrant autant d'espace. Pour pouvoir développer des codes plus étoffés, nous devons apprendre à utiliser ces deux ressources.

Les listes de lecture

9 article(s) - ajoutée le 01/07/2020
Vous désirez apprendre le langage Python, mais ne savez pas trop par où commencer ? Cette liste de lecture vous permettra de faire vos premiers pas en découvrant l'écosystème de Python et en écrivant de petits scripts.
11 article(s) - ajoutée le 01/07/2020
La base de tout programme effectuant une tâche un tant soit peu complexe est un algorithme, une méthode permettant de manipuler des données pour obtenir un résultat attendu. Dans cette liste, vous pourrez découvrir quelques spécimens d'algorithmes.
10 article(s) - ajoutée le 01/07/2020
À quoi bon se targuer de posséder des pétaoctets de données si l'on est incapable d'analyser ces dernières ? Cette liste vous aidera à "faire parler" vos données.
Voir les 53 listes de lecture

Abonnez-vous maintenant

et profitez de tous les contenus en illimité

Je découvre les offres

Déjà abonné ? Connectez-vous