Installer TAGUETTE

Taguette est disponible sous les termes de la licence BSD. Vous pouvez en lire plus sur l'équipe derrière Taguette sur notre page À Propos.

Vous pouvez utiliser Taguette gratuitement sur notre serveur à https://app.taguette.org ou bien installer Taguette localement sur votre ordinateur personnel et/ou serveur (si vous voulez l'hébergez vous même !). Utiliser Taguette sur notre serveur (ou le vôtre) vous permet de collaborer avec d'autres utilisateurs, alors qu'installer Taguette sur votre ordinateur personnel ne vous permet que de l'utiliser hors-ligne seul.

Programmes d'installation

Taguette fonctionne sur macOS, Windows et Linux. Les programmes d'installation pour macOS et Windows incluent Python, Taguette et Calibre, donc vous n'avez besoin d'installer rien d'autre. Pour Linux, le moyen le plus simple d'installer Taguette est d'utiliser pip, les instructions sont plus bas.

Quand vous lancerez l'application, vous verrez une fenêtre de terminal s'ouvrir. C'est normal ! Vous pouvez l'ignorer complètement et utiliser Taguette depuis votre navigateur (localhost:7465 devrait s'ouvrir automatiquement). Laissez simplement la fenêtre de terminal ouverte jusqu'à ce que vous ayez fini d'utiliser Taguette, après quoi vous pouvez fermer cette fenêtre pour arrêter Taguette.

Installation avec pip

You first need to install Python 3 and Calibre, the open-source e-book management software. Taguette uses a part of Calibre to convert documents into HTML, allowing you to highlight and tag parts of them.

Once you've installed Python, you can install Taguette with its dependencies from the command line with the following:

pip3 install taguette

After which you can simply run taguette in the terminal to get it going. You'll see the command line will still be running. This is ok! Don't worry about the terminal, but do leave it running. A browser window should appear, pointing you to localhost:7465, and you can begin working on your projects!

Configuration pour le développement

Vous pouvez aussi installer depuis un clone de ce dépôt, ce qui vous permettra de modifier les sources facilement pour correspondre à vos besoins :

  1. Clonez ce dépôt git depuis le terminal : git clone https://gitlab.com/remram44/taguette.git
  2. Naviguez en utilisant la ligne de commande vers le dépôt que vous venez de cloner localement, en utilisant la commande cd. Pour plus d'information sur l'utilisation de cd, référez-vous à ce tutoriel.
  3. Taguette utilise Poetry pour son empaquetage et la gestion de ses dépendances logicielles. Vous devrez installer Poetry
  4. Installez Taguette et ses dépendances en entrant poetry install. Il est recommendé d'utiliser virtualenv si possible.
  5. Compilez les traductions en entrant scripts/update_translations.sh.
  6. Vous pouvez lancer Taguette en mode développement en entrant taguette --debug. Ceci initialisera Tornado en mode de débogage, ce qui signifie en particulier qu'il redémarrera à chaque fois que vous faites un changement.
  7. Naviguez vers localhost:7465 pour utiliser Taguette !

Pour en savoir plus sur son utilisation, voir notre page prise en main !