DMI TCAT

Das Digital Methods Initiative Twitter Capture and Analysis Toolset (DMI-TCAT) ermöglicht es, Tweets von Twitter abzurufen und zu sammeln und sie auf verschiedene Weise zu analysieren.

Installation

Detaillierte Installationsanweisungen finden Sie im Wiki

Anforderungen

• Twitter-API-Anmeldedaten (diese erhalten Sie von https://apps.twitter.com)
• Eine der folgenden Linux-Distributionen:
  • Ubuntu 18.04
  • Debian 9.*
• ... oder Docker (experimentell)

Debian und Ubuntu

Führen Sie aus:

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

Docker

Unsere neuesten Docker-Images sind auf Docker Hub verfügbar.

1. Installieren Sie Docker Desktop und starten Sie es. Beachten Sie, dass Sie unter Windows möglicherweise sicherstellen müssen, dass die WSL-Integration (Windows Subsystem for Linux) in Docker aktiviert ist. Sie finden dies in den Docker-Einstellungen unter Settings -> Resources-> WSL Integration -> Enable integration with required distros.

Grundlegende Installation

2. Führen Sie den Befehl docker run --publish 80:80 --volume tcat_data:/var/lib/mysql/ --detach --name tcat digitalmethodsinitiative/tcat:1.0 aus und Docker lädt Version 1.0 herunter (oder jeden anderen Tag, den Sie anstelle von "1.0" verwenden).

• --publish HOST_PORT:80 ermöglicht es Ihnen, den Port im Host-Netzwerk zu definieren. Wenn Sie einen anderen Port verwenden, müssen Sie möglicherweise auch -e SERVERNAME=localhost:HOST_PORT hinzufügen, wobei HOST_PORT der gewünschte Port ist, da dieser für interne Links in der TCAT-Oberfläche verwendet wird.
• --volume volume_name:/var/lib/mysql/ stellt sicher, dass Sie Ihre TCAT-MySQL-Datenbank problemlos wiederverwenden und Daten wiederherstellen können, nachdem Sie TCAT nicht mehr verwenden.

3. Öffnen Sie die Protokolle, um Ihre Anmeldeinformationen entweder über die Docker-Oberfläche oder die Befehlszeile docker logs tcat abzurufen (die Installation kann einige Zeit dauern, Sie können entweder warten oder docker logs -f tcat ausführen, um den Fortschritt zu verfolgen).
4. Öffnen Sie http://localhost:80 in Ihrem Browser und schließen Sie die Konfiguration ab, indem Sie Ihre Twitter-API-Informationen angeben und festlegen, welche Art von Tweet-Erfassung Sie durchführen möchten.
5. Herzlichen Glückwunsch! Sie können das admin-Menü verwenden, um Ihre ersten Tweet-Erfassungsbehälter zu erstellen.
6. In Zukunft können Sie Ihren TCAT-Container mit folgenden Befehlen stoppen und starten: docker stop tcat und docker start tcat

Anpassung für Ihren eigenen Server

Die Docker-Installation ermöglicht es Ihnen auch, TCAT einfach auf einem Server zu hosten. Zusätzlich zur Umgebungsvariablen SERVERNAME können Sie auch Let's Encrypt verwenden, indem Sie -e LETSENCRYPT=y und -e [email protected] hinzufügen. Sie sollten auch Port 443 öffnen, damit Let's Encrypt funktioniert. Ihr vollständiger Befehl könnte wie folgt aussehen: 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

Weitere TCAT-Anpassungen

Wenn Sie TCAT selbst weiterentwickeln möchten, können Sie dieses Repository klonen und Ihr eigenes Image erstellen.

1. Klonen Sie dieses Repository git clone https://github.com/digitalmethodsinitiative/dmi-tcat.git
2. Erstellen Sie das Image (aus dem Verzeichnis, in dem Sie TCAT geklont haben): docker image build --progress=plain -t tcat:1.0 .
3. Ersetzen Sie in Ihrem docker run Befehl digitalmethodsinitiative/tcat:1.0 durch tcat:1.0

Probleme

Bitte verwenden Sie die Issue-Vorlagen, wenn Sie Probleme und Fehler melden.

Status

Eine nette Art zu beschreiben, dass wir nicht viel haben

Mitwirken

Wir freuen uns über Vorschläge und Verbesserungen.

Lizenz

Apache License Version 2.0