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.
- Installer racket : https://download.racket-lang.org/.
- Ajouter au PATH le chemin menant vers l’exécutable de racket qui vient d’être installé. Ces chemins sont habituellement les suivantes :
- "/path/to/racket/bin" sur Mac et Linux,
- "C:\Program Files\Racket" sur Windows.
- Dans le terminal de ligne de commande, taper
racket
pour vérifier que cela fonctionne. Exemple de ce que vous devriez avoir :
- Taper la commande
(exit)
pour quitter la session Racket. - Taper la commande
raco pkg install pollen
pour installer Pollen. - Taper la commande
raco pollen test
pour vérifier que tout est bien installé. Exemple de ce que vous devriez avoir :
- 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.