Installation

Fabrilivre nécessite l’installation du langage de programmation Racket et de son dialecte Pollen.

Si vous souhaitez l’export PDF via LuaLaTeX, il vous faudra également installer un éditeur supplémentaire compatible. Fabrilivre a été testé avec Texmaker avec MiKTeX, mais d’autres éditeurs devraient théoriquement fonctionner. https://www.xm1math.net/texmaker/

Installer Racket et Pollen

Les étapes qui suivent reprennent celles de la documentation d’installation de Pollen : https://docs.racket-lang.org/pollen/Installation.html#%28part._.How_to_install%29 (anglais). Vous pouvez consulter celle-ci pour plus de détail sur le processus d’installation.

1. Installer racket : https://download.racket-lang.org/.
2. Ajouter au PATH le chemin menant vers l’exécutable de racket qui vient d’être installé. Ces chemins sont habituellement les suivantes :
3. "/path/to/racket/bin" sur Mac et Linux,
4. "C:\Program Files\Racket" sur Windows.
5. Dans le terminal de ligne de commande, taper racket pour vérifier que cela fonctionne. Exemple de ce que vous devriez avoir :

$ racket
Welcome to Racket v8.6 [cs].
>

1. Taper la commande (exit) pour quitter la session Racket.
2. Taper la commande raco pkg install pollen pour installer Pollen.
3. Taper la commande raco pollen test pour vérifier que tout est bien installé. Exemple de ce que vous devriez avoir :

$ raco pollen test
raco pollen is installed correctly

1. L’installation de Racket est terminée !

À partir de là, vous n’aurez plus à installer ces logiciels, car ils fonctionneront pour tous les projets que vous ferez.

Obtenir une copie de base

Vous avez deux façons d’obtenir une copie de Fabrilivre.

Par archive

La première méthode est la plus simple. Allez à l’adresse https://framagit.org/NemuLumeN/fabrilivre/-/releases, puis téléchargez un des fichiers d’archive de code source. Décompressez l’archive dans un de vos dossiers. L’emplacement n’a pas d’importance, et vous pourrez de toute manière déplacer le projet plus tard.

Via git

La deuxième méthode est un peu plus complexe, mais elle vous offrira plus de sérénité car elle se base sur git. Vous pourrez versionner vos fichiers, et les envoyer sur un dépôt distant pour sécuriser leur stockage à un autre endroit que votre appareil.

Cette documentation n’a pas pour mission de vous enseigner git. Dans le cas où cette méthode vous intéresse, il vous faudra cloner le projet, et le pousser sur un nouveau dépôt qui vous appartient. Attention à le garder en accès privé, sous peine d’avoir votre contenu disponible librement sur le réseau !

Passer à la suite

Vous pouvez maintenant passer à l’utilisation.