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

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. We recommend you run this inside of a virtualenv if possible.
  5. Build translation files using scripts/update_translations.sh.
  6. You can start taguette in development mode using taguette --debug. 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 commencer avec Taguette !