DMI TCAT

L'ensemble d'outils de capture et d'analyse de tweets de la Digital Methods Initiative (DMI-TCAT) permet de récupérer et collecter des tweets depuis Twitter et de les analyser de différentes manières.

Installation

Vous trouverez des instructions d'installation détaillées dans le wiki

Prérequis

• Identifiants API Twitter (ils peuvent être obtenus depuis https://apps.twitter.com)
• Une des distributions Linux suivantes :
  • Ubuntu 18.04
  • Debian 9.*
• ... ou Docker (expérimental)

Debian et Ubuntu

Exécutez :

curl https://raw.githubusercontent.com/digitalmethodsinitiative/dmi-tcat/master/helpers/tcat-install-linux.sh | sudo bash

Docker

Nos dernières images Docker sont disponibles sur Docker Hub.

1. Installez Docker Desktop et démarrez-le. Notez que sous Windows, vous devrez peut-être vous assurer que l'intégration WSL (Windows Subsystem for Linux) est activée dans Docker. Vous pouvez trouver cela dans les paramètres Docker dans Paramètres -> Ressources -> Intégration WSL -> Activer l'intégration avec les distributions requises.

Installation de base

2. Exécutez la commande docker run --publish 80:80 --volume tcat_data:/var/lib/mysql/ --detach --name tcat digitalmethodsinitiative/tcat:1.0 et Docker téléchargera la version 1.0 (ou tout autre tag par lequel vous remplacez le « 1.0 »)

• --publish HOST_PORT:80 vous permet de définir le port utilisé sur le réseau hôte. Si vous utilisez un port différent, vous devrez peut-être aussi ajouter -e SERVERNAME=localhost:HOST_PORT où HOST_PORT est le port souhaité, car celui-ci est utilisé pour les liens internes dans l'interface TCAT.
• --volume volume_name:/var/lib/mysql/ vous garantit de pouvoir réutiliser facilement votre base de données MySQL TCAT et de récupérer les données après avoir arrêté d'utiliser TCAT.

3. Ouvrez les logs pour récupérer vos informations de connexion via l'interface de Docker ou la ligne de commande docker logs tcat (l'installation peut prendre du temps, vous pouvez donc attendre ou exécuter docker logs -f tcat pour suivre la progression).
4. Ouvrez http://localhost:80 dans votre navigateur et terminez la configuration en fournissant vos informations API Twitter et le type de capture de tweets que vous souhaitez effectuer.
5. Félicitations ! Vous pouvez utiliser le menu admin pour créer vos premiers bacs de capture de tweets.
6. À l'avenir, vous pouvez arrêter et démarrer votre conteneur TCAT avec : docker stop tcat et docker start tcat

Personnalisation pour votre propre serveur

L'installation Docker vous permet aussi d'héberger facilement TCAT sur un serveur. En plus de la variable d'environnement SERVERNAME, vous pouvez aussi utiliser Let's Encrypt en ajoutant -e LETSENCRYPT=y et -e [email protected]. Vous devez aussi ouvrir le port 443 pour que Let's Encrypt fonctionne. Votre commande complète pourrait ressembler à ceci : docker run --publish 80:80 --publish 443:443 --volume tcat_data:/var/lib/mysql/ --detach --name tcat -e SERVERNAME=my.website.com -e LETSENCRYPT=y -e [email protected] digitalmethodsinitiative/tcat:1.0

Personnalisation supplémentaire de TCAT

Enfin, si vous souhaitez développer TCAT vous-même, vous pouvez cloner ce dépôt et créer votre propre image.

1. Clonez ce dépôt : git clone https://github.com/digitalmethodsinitiative/dmi-tcat.git
2. Construisez l'image (depuis le répertoire où vous avez cloné TCAT) : docker image build --progress=plain -t tcat:1.0 .
3. Remplacez digitalmethodsinitiative/tcat:1.0 par tcat:1.0 ci-dessus dans votre commande docker run

Problèmes

Veuillez utiliser les modèles de signalement de problèmes lorsque vous signalez des problèmes et des bugs.

Statut

Belle façon de décrire le fait que nous n'avons pas grand-chose

Contribution

Nous sommes ravis de recevoir des suggestions et des améliorations.

Licence

Apache License Version 2.0