DMI TCAT

مجموعة أدوات التقاط وتحليل تويتر من مبادرة الأساليب الرقمية (DMI-TCAT) تسمح بجلب وجمع التغريدات من تويتر وتحليلها بطرق متنوعة.

التثبيت

يمكنك العثور على تعليمات التثبيت التفصيلية في الويكي

المتطلبات

• بيانات اعتماد API تويتر (يمكن الحصول عليها من https://apps.twitter.com)
• إحدى توزيعات لينكس التالية:
  • Ubuntu 18.04
  • Debian 9.*
• ... أو Docker (تجريبي)

Debian و Ubuntu

شغّل:

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

Docker

صور Docker الأحدث لدينا متاحة على Docker Hub.

1. قم بتثبيت Docker Desktop وابدأ تشغيله. لاحظ أنه على Windows، قد تحتاج إلى التأكد من تمكين تكامل WSL (نظام ويندوز الفرعي للينكس) في Docker. يمكنك العثور على ذلك في إعدادات Docker ضمن Settings -> Resources -> WSL Integration -> Enable integration with required distros.

التثبيت الأساسي

2. شغّل الأمر docker run --publish 80:80 --volume tcat_data:/var/lib/mysql/ --detach --name tcat digitalmethodsinitiative/tcat:1.0 وسيقوم Docker بتحميل الإصدار 1.0 (أو أي وسم تستبدل به "1.0").

• --publish HOST_PORT:80 يسمح لك بتحديد المنفذ المستخدم على شبكة المضيف. إذا كنت تستخدم منفذًا مختلفًا، فقد تحتاج أيضًا إلى إضافة -e SERVERNAME=localhost:HOST_PORT حيث HOST_PORT هو المنفذ المطلوب، حيث يُستخدم ذلك للروابط الداخلية في واجهة TCAT.
• --volume volume_name:/var/lib/mysql/ يضمن لك سهولة إعادة استخدام قاعدة بيانات TCAT mysql واسترداد البيانات بعد التوقف عن استخدام TCAT.

3. افتح السجلات لاسترداد معلومات تسجيل الدخول إما عبر واجهة Docker أو سطر الأوامر docker logs tcat (قد يستغرق التثبيت بعض الوقت، لذا يمكنك الانتظار أو تشغيل docker logs -f tcat للمتابعة).
4. افتح http://localhost:80 في متصفحك وأكمل التهيئة بتوفير معلومات API تويتر الخاصة بك ونوع التقاط التغريدات الذي ترغب في القيام به.
5. تهانينا! يمكنك استخدام قائمة admin لإنشاء أول صناديق التقاط التغريدات الخاصة بك.
6. في المستقبل، يمكنك إيقاف وتشغيل حاوية TCAT الخاصة بك باستخدام: docker stop tcat و docker start tcat

تخصيص لخادمك الخاص

يتيح لك تثبيت Docker أيضًا استضافة TCAT بسهولة على خادم. بالإضافة إلى متغير البيئة SERVERNAME، يمكنك أيضًا استخدام Let's Encrypt بإضافة -e LETSENCRYPT=y و -e [email protected]. يجب عليك أيضًا فتح المنفذ 443 لكي يعمل Let's Encrypt. قد يبدو أمرك الكامل كالتالي: 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

تخصيص إضافي لـ TCAT

أخيرًا، إذا كنت ترغب في تطوير TCAT بنفسك، يمكنك استنساخ هذا المستودع وإنشاء صورتك الخاصة.

1. استنساخ هذا المستودع git clone https://github.com/digitalmethodsinitiative/dmi-tcat.git
2. بناء الصورة (من الدليل الذي استنسخت فيه TCAT): docker image build --progress=plain -t tcat:1.0 .
3. استبدل digitalmethodsinitiative/tcat:1.0 بـ tcat:1.0 من الأمر أعلاه في أمر docker run الخاص بك

المشكلات

يرجى استخدام قوالب المشكلات عند الإبلاغ عن المشكلات والأخطاء.

الحالة

طريقة لطيفة لوصف حقيقة أننا لا نملك الكثير

المساهمة

يسعدنا تلقي الاقتراحات والتحسينات.

الترخيص

Apache License Version 2.0