Installation

Vous aurez besoin de deux choses au minimum pour faire fonctionner Fabrilivre :

• récupérer les sources du projet,
• installer Racket et les dépendances du projet.

Obtenir une copie du code de FabriLivre

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 !

Installer Racket et les dépendances du projet

Vous devez installer le langage Racket et Pollen pour faire fonctionner Fabrilivre.

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 suivants :
   • "/usr/racket/bin" sur Mac et Linux (ou tout autre chemin spécifié à l'installation),
   • "C:\Program Files\Racket" sur Windows.
3. 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].
   >
   

4. Taper la commande (exit) pour quitter la session Racket.
5. Aller dans le répertoire où se trouve la copie de FabriLivre.
6. Taper la commande raco pkg install, et acceptez l'installation des dépendances en répondant "a" lorsqu'il vous est demandé votre approbation.

   Cela va installer Pollen ainsi que toutes les dépendances nécessaires.

7. 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
   

8. 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.

Passer à la suite

Vous pouvez maintenant passer à l’utilisation.