عربي. شبكات إجتماعية "تويتر"


ملاحظة مهمة: الأداة بشكل عام قادرة على إرجاع اكثر من ٧٠٪ من المحتوى العربي المباشر على تويتر فور التغريد به.

تحتوي هذه الحُزمة على عدة أدوات برمجية و فيما يلي وصف كل أداة و طريقة إستعمالها:

أولاً: أداة عامة لإسترجاع النصوص العربية من تويتر

هنالك ٣ طرق لإستخدام هذه الأداة والامثلة ستوضح كلٍ منها:

مثال ١: طباعة التغريدات العربية مباشرةً فور التغريد بها
// عدل هنا حسب تطبيق تويتر الخاص بك
String consumer_key = "ADD HERE YOUR KEY";
String consumer_secret = "ADD HERE YOUR SECRET";
String access_token = "ADD HERE YOUT TOKEN";
String access_token_secret = "ADD HERE YOUR TOKEN SECRET";

//  بناء كائن من نوع مسترجع النصوص العربية من تويتر
ArabiTwitterFeeder T = new ArabiTwitterFeeder(consumer_key, consumer_secret,
				               access_token, access_token_secret);

// طباعة التغريدات العربية على الشاشة بشكل مباشر فور حدوثها على تويتر
T.printArabicTweetsTextToScreen();


مثال ٢: طباعة جميع معلومات التغريدات العربية فور التغريد بها (ليس مجرد النص فقط وإنما يشمل هذا المُغرد ووقت التغريدة ورابطها وغيرها من المعلومات)
تعاد كل تغريدة على شكل JSON
// عدل هنا حسب تطبيق تويتر الخاص بك
String consumer_key = "ADD HERE YOUR KEY";
String consumer_secret = "ADD HERE YOUR SECRET";
String access_token = "ADD HERE YOUT TOKEN";
String access_token_secret = "ADD HERE YOUR TOKEN SECRET";

//  بناء كائن من نوع مسترجع النصوص العربية من تويتر
ArabiTwitterFeeder T = new ArabiTwitterFeeder(consumer_key, consumer_secret,
				               access_token, access_token_secret);

// طباعة جميع معلومات التغريدات العربية فور حدوثها
T.printArabicTweetsJSONToScreen();


مثال ٣: نفس المثالين السابقين ولكن المحتوى العربي يخزن في ملفات
فقط المطلوب تعديل السطر البرمجي الأخير الى :
// تخزين نصوص التغريدات العربية فور حدوثها في موقع معين على حاسوب المستخدم
// يحدد أيضا كمية التغريدات المخزنه في كل ملف
// أسماء الملفات لا تتكر وتعتمد على ساعة الحاسوب
T.printArabicTweetsTextToFiles("FOLDER LOCATION", 250); // 250 : عدد التغريدات في كل ملف
أو
// تخزين جميع معلومات التغريدات العربية فور حدوثها في موقع معين على حاسوب المستخدم
// يحدد أيضا كمية التغريدات المخزنه في كل ملف
// أسماء الملفات لا تتكر وتعتمد على ساعة الحاسوب
T.printArabicTweetsJSONToFiles("FOLDER LOCATION", 250); // 250 : عدد التغريدات في كل ملف

ثانياً: أداة إسترجاع النصوص العربية من تويتر حسب كلمات مفتاحية معينة

تعمل هذه الأداة على إسترجاع النصوص العربية حسب الكلمات المفتاحية التي يحدد المبرمج مسبقاً

مثال ٤: يظهر المثال برنامج يعمل على إرجاع التغريدات العربية ذات علاقة بريال مدريد وبرشلونة بناءً على كلمات مفتاحية مدخلة في قائمة.
يقوم البرنامج بطباعة التغريدات على الشاشة
// عدل هنا حسب تطبيق تويتر الخاص بك
String consumer_key = "ADD HERE YOUR KEY";
String consumer_secret = "ADD HERE YOUR SECRET";
String access_token = "ADD HERE YOUT TOKEN";
String access_token_secret = "ADD HERE YOUR TOKEN SECRET";

//  بناء كائن من نوع مسترجع النصوص العربية من تويتر
ArabiTwitterFeeder T = new ArabiTwitterFeeder(consumer_key, consumer_secret,
				               access_token, access_token_secret);

// تحديد قائمة كلمات مفتاحية
ArrayList<String>filter_words = new ArrayList<String>(Arrays.asList("برشلونة", "كلاسيكو", "ريال مدريد"));

// إستخرج التغريدات العربية التي تحتوي على الكلمات المفتاحية واطبعها على الشاشة
T.printArabicTweetsTextToScreenWithFilter(filter_words);
أو يمكن طباعة جميع محتويات التغريدات على شكل JSON
يجب تعديل السطر البرمجي الاخير فقط
// إستخرج جميع معلومات التغريدات العربية التي تحتوي على الكلمات المفتاحية واطبعها على الشاشة
T.printArabicTweetsJSONToScreenWithFilter(filter_words);
أو يمكن تخزين التغريدات على شكل نصوص في مجلد وضمن كلمات مفتاحية معينة
يجب تعديل السطر البرمجي الاخير فقط
// إستخرج نصوص التغريدات وخزنها في مجلد حسب كلمات مفتاحية معينة
T.printArabicTweetsTextToFilesWithFilter("FOLDER LOCATION", number_of_tweetsـper_file, filter_words);
أو يمكن تخزين جميع معلومات التغريدات في مجلد بناءً على كلمات مفتاحية معينة وعلى شكل JSON
يجب تعديل السطر البرمجي الاخير فقط
// إستخرج جميع معلومات التغريدات وخزنها في مجلد حسب كلمات مفتاحية معينة
T.printArabicTweetsJSONToFilesWithFilter("FOLDER LOCATION",number_of_tweetsـper_file ,filter_words);

ثالثاً: أداة إسترجاع التغريدات العربية حسب اللهجة

تعمل هذه الأداة على إسترجاع النصوص العربية حسب اللهجة، حاليا النظام يدعم اللهجة المصرية والخليجية.

مثال ٥: يُظهر المثال برنامج يعمل على إرجاع نصوص التغريدات المصرية ويطبعها على الشاشة:
// عدل هنا حسب تطبيق تويتر الخاص بك
String consumer_key = "ADD HERE YOUR KEY";
String consumer_secret = "ADD HERE YOUR SECRET";
String access_token = "ADD HERE YOUT TOKEN";
String access_token_secret = "ADD HERE YOUR TOKEN SECRET";

//  بناء كائن من نوع مسترجع النصوص العربية من تويتر
ArabiTwitterFeeder T = new ArabiTwitterFeeder(consumer_key, consumer_secret,
				               access_token, access_token_secret);

// إستخرج نصوص التغريدات المصرية وطباعتها على الشاشة
T.printArabicTweetsTextToScreenEgyDialects();
أو يمكن طباعة جميع محتويات التغريدات المصرية على شكل JSON
يجب تعديل السطر البرمجي الاخير فقط
// إستخرج جميع معلومات التغريدات المصرية واطبعها على الشاشة
T.printArabicTweetsJSONToScreenEgyDialects();
أو يمكن تخزين التغريدات المصرية على شكل نصوص في مجلد
يجب تعديل السطر البرمجي الاخير فقط
// إستخرج نصوص التغريدات المصرية وخزنها في مجلد
T.printArabicTweetsTextToFilesEgyDialects("FILE LOCATION", number_of_tweetsـper_file);
أو يمكن تخزين جميع معلومات التغريدات المصرية في مجلد JSON
يجب تعديل السطر البرمجي الاخير فقط
// إستخرج جميع معلومات التغريدات المصرية وخزنها في مجلد
T.printArabicTweetsJSONToFilesEgyDialects("FILE LOCATION", number_of_tweetsـper_file);


مثال ٦: يُظهر المثال برنامج يعمل على إرجاع نصوص التغريدات الخليجية ويطبعها على الشاشة:
// عدل هنا حسب تطبيق تويتر الخاص بك
String consumer_key = "ADD HERE YOUR KEY";
String consumer_secret = "ADD HERE YOUR SECRET";
String access_token = "ADD HERE YOUT TOKEN";
String access_token_secret = "ADD HERE YOUR TOKEN SECRET";

//  بناء كائن من نوع مسترجع النصوص العربية من تويتر
ArabiTwitterFeeder T = new ArabiTwitterFeeder(consumer_key, consumer_secret,
				               access_token, access_token_secret);

// إستخرج نصوص التغريدات الخليجية وطباعتها على الشاشة
T.printArabicTweetsTextToScreenGulfDialects();
أو يمكن طباعة جميع محتويات التغريدات الخليجية على شكل JSON
يجب تعديل السطر البرمجي الاخير فقط
// إستخرج جميع معلومات التغريدات الخليجية واطبعها على الشاشة
T.printArabicTweetsJSONToScreenGulfDialects();
أو يمكن تخزين التغريدات الخليجية على شكل نصوص في مجلد
يجب تعديل السطر البرمجي الاخير فقط
// إستخرج نصوص التغريدات الخليجية وخزنها في مجلد
T.printArabicTweetsTextToFilesGulfDialects("FILE LOCATION", number_of_tweetsـper_file);
أو يمكن تخزين جميع معلومات التغريدات الخليجية في مجلد JSON
يجب تعديل السطر البرمجي الاخير فقط
// إستخرج جميع معلومات التغريدات الخليجية وخزنها في مجلد
T.printArabicTweetsJSONToFilesGulfDialects("FILE LOCATION", number_of_tweetsـper_file);