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

Vous devez tout d'abord installer Python 3 et Calibre, le logiciel libre de gestion de livres numériques. Taguette uses utilise une partie de Calibre pour convertir des documents en HTML, ce qui vous permet de les marquer et tagger dans Taguette.

Sur Debian ou Ubuntu, vous pouvez faire sudo apt install python3 calibre

Une fois que vous avez installé Python, vous pouvez créer un environment virtuel Python et installer Taguette avec ses dépendances logicielles depuis la ligne de commandes comme suit :

python3 -m venv taguette.virtualenv
. taguette.virtualenv/bin/activate
pip install taguette

Après quoi vous pouvez simplement entrer taguette.virtualenv/bin/taguette dans le terminal pour lancer l'application. Vous verrez que l'activité continue dans le terminal. C'est normal ! Ne vous inquiétez pas du terminal, mais laissez-le ouvert. Une fenêtre de navigateur devrait apparaître, dirigée vers localhost:7465, et vous pouvez commencer à travailler sur vos projets !

Configuration pour le développement

You can also install from a local clone of this repository, which will allow you to easily change the sources to suit your needs:

  1. Clone this git repository from the terminal: git clone https://gitlab.com/remram44/taguette.git
  2. Navigate on the command line to the repository you've just cloned locally, using the cd command. To get help using cd, use this tutorial.
  3. Taguette uses Poetry for its packaging and dependency management. You will need to install Poetry.
  4. Install Taguette and its dependencies by running poetry install. Poetry will create a virtual environment for you by default, activate it by running poetry shell.
  5. Build translation files using scripts/update_translations.sh.
  6. You can start taguette in development mode using taguette --debug (or taguette --debug server <config_file>). This will start Tornado in debug mode, which means in particular that it will auto-restart every time you make changes.
  7. Navigate to localhost:7465 to use Taguette!

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