Créer des documents simplement avec Pillar

Tag(s)

Markdown

PDF

HTML

Pharo

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 des listes de lecture et des contenus Premium
Consultez les nouveaux articles en avant-première

Je m'abonne

Déjà abonné ? Connectez-vous

Article rédigé par

5 articles

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

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

GNU/Linux Magazine

n°

212

février 2018

Par

Web

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

GNU/Linux Magazine

n°

207

septembre 2017

Par

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

GNU/Linux Magazine

n°

203

avril 2017

Par

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.

Plus d'article de cet auteur

Les derniers articles Premiums

Les derniers articles Premium

Le combo gagnant de la virtualisation : QEMU et KVM

Contenu Premium

Par

Samhi Jordan

C’est un fait : la virtualisation est partout ! Que ce soit pour la flexibilité des systèmes ou bien leur sécurité, l’adoption de la virtualisation augmente dans toutes les organisations depuis des années. Dans cet article, nous allons nous focaliser sur deux technologies : QEMU et KVM. En combinant les deux, il est possible de créer des environnements de virtualisation très robustes.

Brève introduction pratique à ZFS

Contenu Premium

Par

Samhi Jordan

Il est grand temps de passer à un système de fichiers plus robuste et performant : ZFS. Avec ses fonctionnalités avancées, il assure une intégrité des données inégalée et simplifie la gestion des volumes de stockage. Il permet aussi de faire des snapshots, des clones, et de la déduplication, il est donc la solution idéale pour les environnements de stockage critiques. Découvrons ensemble pourquoi ZFS est LE choix incontournable pour l'avenir du stockage de données.

Générez votre serveur JEE sur-mesure avec Wildfly Glow

Contenu Premium

Par

Pelisse Romain

Et, si, en une ligne de commandes, on pouvait reconstruire son serveur JEE pour qu’il soit configuré, sur mesure, pour les besoins des applications qu’il embarque ? Et si on pouvait aller encore plus loin, en distribuant l’ensemble, assemblé sous la forme d’un jar exécutable ? Et si on pouvait même déployer le tout, automatiquement, sur OpenShift ? Grâce à Wildfly Glow [1], c’est possible ! Tout du moins, pour le serveur JEE open source Wildfly [2]. Démonstration dans cet article.

Utilisation avancée de SQLPage

Contenu Premium

Par

Auverlot Olivier

Web

Poursuivons notre découverte de SQLPage en explorant certaines de ses fonctionnalités avancées qui sont généralement indispensables à tous sites ou applications. Dans cet article, nous allons parler de PostgreSQL, d’authentification et de gestion des droits.