NewsBlur

NewsBlur

• NewsBlur هو قارئ أخبار شخصي يجمع الأشخاص معًا للحديث عن العالم. صوت جديد لآلة قديمة.
• www.newsblur.com.
• ابتكرها صامويل كلاي.
• إكس/ تويتر: @samuelclay و@newsblur.

سمات

1. يظهر الموقع الأصلي (يجب أن تراه لتصدقه).
2. يخفي القصص التي لا ترغب في قراءتها بناءً على العلامات والكلمات الرئيسية والمؤلفين وما إلى ذلك.
3. يسلط الضوء على القصص التي ترغب في قراءتها، بناءً على نفس المعايير.

التقنيات

جانب الخادم

• بايثون 3.7+: اللغة المفضلة.
• جانغو: إطار ويب مكتوب بلغة بايثون، يستخدم لخدمة جميع الصفحات.
• Celery & RabbitMQ: خادم انتظار غير متزامن، يستخدم لجلب وتحليل خلاصات RSS.
• MongoDB وPymongo وMongoengine: قاعدة بيانات غير علائقية، تُستخدم لتخزين القصص وقراءتها وسجلات جلب الخلاصات/الصفحات والمواقع الوكيلة.
• PostgreSQL: قاعدة بيانات علائقية تُستخدم لتخزين الخلاصات والاشتراكات وحسابات المستخدمين.
• Redis: قاعدة بيانات للمبرمجين، تُستخدم لتجميع القصص للنهر، وتخزين معرفات القصة، وإدارة جداول جلب الخلاصات، والجزء الصغير من التخزين المؤقت الذي يستخدمه NewsBlur.
• Elasticsearch: البحث في قاعدة البيانات، يُستخدم للبحث في القصص. خياري.

جانب العميل والتصميم

• jQuery: كود JavaScript متوافق مع جميع المتصفحات. IE يعمل دون جهد.
• Underscore.js: البرمجة الوظيفية لجافا سكريبت. لا غنى عنه.
• Backbone.js: إطار عمل تطبيق الويب. لا غنى عنه أيضا.
• ملحقات jQuery المتنوعة: كل شيء بدءًا من التخطيطات التي يمكن تغيير حجمها، وحتى أشرطة التقدم، والفرز، ومعالجة التاريخ، والألوان، والزوايا، وJSON، والرسوم المتحركة. انظر القائمة الكاملة.

المتطلبات الأساسية

 * Docker
* Docker-compose

تعليمات التثبيت

1. استنساخ هذا الريبو

2. قم بتشغيل make nb لإنشاء كافة حاويات NewsBlur. سيؤدي هذا إلى إعداد جميع قواعد البيانات الضرورية، وتطبيقات Django الأمامية، ومهام الكرفس، وتطبيقات العقدة، ومراقبة قاعدة بيانات القارورة ومقاييسها، وnginx، وموازن تحميل haproxy.

3. انتقل إلى:

    https://localhost
   

   ملاحظة: سيتم تحذيرك من أنك تستخدم شهادة موقعة ذاتيًا. للتغلب على هذا التحذير، يجب عليك كتابة "thisisunsafe" وفقًا لمنشور المدونة هذا.

باستخدام مجال مخصص

1. قم بتشغيل البرنامج النصي للمجال المخصص

    bash ./utils/custom_domain.sh <domain name>
   

   سيقوم هذا البرنامج النصي بما يلي:

   • قم بتغيير NEWSBLUR_URL و SESSION_COOKIE_DOMAIN في newsblur_web/docker_local_settings.py
   • قم بتغيير المجال في config/fixtures/bootstrap.json

يمكنك أيضًا تغيير المجالات: bash ./utils/custom_domain.sh <old domain> <new domain>

2. إذا كنت تستخدم نطاقًا فرعيًا مخصصًا، فستحتاج أيضًا إلى إضافته إلى ALLOWED_SUBDOMAINS في apps/reader/views.py

3. طريقة للتأكد من تحديث جميع الأماكن الصحيحة:

   • انتقل إلى عنوان موقع الويب في متصفحك
   • افتح أدوات المطور وانظر إلى علامة تبويب الشبكة
   • حاول تسجيل الدخول
   • انظر مرة أخرى إلى أدوات المطور، يجب أن يكون هناك استدعاء POST لـ /login
   • راقب رؤوس الاستجابة لتلك المكالمة
   • يجب أن تحتوي قيمة رأس "set-cookie" على سلسلة "Domain =".

   إذا كانت السلسلة بعد Domain= ليست هي النطاق الذي تستخدمه للوصول إلى موقع الويب، فإن التكوين الخاص بك لا يزال بحاجة إلى المجال المخصص الخاص بك.

   يمكنك أيضًا التأكد من وجود عدم تطابق في اسم المجال في قاعدة البيانات عن طريق تشغيل make shell وكتابة Site.objects.all()[0] لإظهار المجال الذي تتوقعه NewsBlur.

جعل عامل الإرساء يعمل مع قاعدة البيانات الموجودة لديك

لجعل عمل docker-compose مع قاعدة البيانات الخاصة بك، قم بترقية قاعدة البيانات المحلية الخاصة بك إلى إصدار docker-compose ثم قم بزيادة حجم مسار بيانات قاعدة البيانات عن طريق تغيير جزء ./docker/volumes/ من توجيه وحدة التخزين في الخدمة للإشارة إلى قاعدة البيانات المحلية الخاصة بك دليل البيانات.

لجعل إنشاء عامل الإرساء يعمل مع إصدار قاعدة بيانات أقدم، قم بتغيير إصدار الصورة لخدمة قاعدة البيانات في ملف إنشاء عامل الإرساء.

تعليمات المساهمة

• إجراء التغييرات:

  • لتطبيق التغييرات على كود Python أو JavaScript، استخدم الأمر make .
  • لتطبيق التغييرات على ملف docker-compose.yml، استخدم أمر make rebuild .
  • لتطبيق التغييرات على ملف docker/haproxy/haproxy.conf، أو حزم العقدة، أو أي عمليات ترحيل جديدة لقاعدة البيانات، ستحتاج إلى استخدام الأمر make nb .

• إضافة حزم Python: حاليًا، يستخدم ملف docker-compose.yml صورة newsblur/newsblur_python3. تم إنشاؤه باستخدام ملف Dockerfile الموجود في docker/newsblur_base_image.Dockerfile . نظرًا لكيفية إعداد صورة عامل الإرساء، ستحتاج إلى إنشاء صورتك الخاصة وتوجيه ملف docker-compose.yml الخاص بك لاستخدامها. يرجى اتباع الخطوات التالية للقيام بذلك.

  1. أضف حزم موقعك الجديدة إلى config/requirements.txt.
  2. أضف أسطر التعليمات البرمجية التالية إلى ملف docker-compose.yml الخاص بك لاستبدالها في أي مكان حيث تظهر image: newsblur/newsblur_python3
  build: context: . dockerfile: docker/newsblur_base_image.Dockerfile
  3. قم بتشغيل الأمر make nb لإعادة بناء حاويات إنشاء عامل الإرساء

• تصحيح أخطاء بايثون

  • لتصحيح التعليمات البرمجية الخاصة بك، قم بإسقاط import pdb; pdb.set_trace() في كود Python حيث تريد بدء تصحيح الأخطاء وتشغيل make ثم make debug .

• استخدام Django Shell داخل Docker

  • تأكد من تشغيل حاويات الإرساء وتشغيل make shell لفتح Django Shell داخل حاوية newsblur_web.

تشغيل اختبارات الوحدة والتكامل

يأتي NewsBlur كاملاً مع مجموعة اختبار تختبر وظائف rss_feeds والقارئ ومستورد الخلاصات. لتشغيل مجموعة الاختبار:

 `make test`

إجراء اختبار الأداء

تستخدم اختبارات الأداء أداة اختبار أداء الجراد. لتشغيل اختبارات الأداء عبر واجهة سطر الأوامر (CLI)، استخدم make perf-cli users=1 rate=1 host=https://localhost . لا تتردد في تغيير متغيرات المستخدمين والتقييم والمضيف في الأمر لتلبية احتياجاتك.

يمكنك أيضًا إجراء اختبارات أداء الجراد باستخدام واجهة المستخدم عن طريق تشغيل make perf-ui ثم الانتقال إلى http://127.0.0.1:8089. يتيح لك ذلك رسم بيانات الأداء وتصديرها.

لتشغيل Locust باستخدام docker، ما عليك سوى تشغيل make perf-docker والانتقال إلى http://127.0.0.1:8089

مؤلف

• ابتكرها صامويل كلاي.
• عنوان البريد الإلكتروني: [email protected]
• @samuelclay على X/تويتر.

رخصة

NewsBlur مرخص بموجب ترخيص MIT. (انظر الترخيص)