الصفحة الرئيسية>المتعلقة بالبرمجة>شفرة المصدر الأخرى
تنزيل

publiclab.org

بناء الحالة

نظام إدارة المحتوى لمجتمع أبحاث المختبر العام ، تطبيق الويب plots2 هو مزيج من مدونة أبحاث جماعية -ما نسميه "ملاحظات بحثية" -ويكي. اقرأ المزيد عن نموذج البيانات هنا.

ابدأ تشغيل (والمساهمة في) قاعدة قاعدة الشفرة هذه فورًا باستخدام gitpod:

يعرض مجموعة متنوعة من الميزات التي تساعد مجتمع المختبر العام على التعاون في تكنولوجيا البيئة والتصميم والوثائق وتنظيم المجتمع. في الأصل موقع Drupal ، تم إعادة كتابته في عام 2012 مع Ruby on Rails ، ومنذ ذلك الحين تم تمديده ولكن لم يتم استبداله تمامًا بنموذج بيانات Drupal Legacy وتصميم قاعدة البيانات. نحن مفتوح المصدر ونشارك بنشاط في برامج OSS المختلفة مثل Google Summer of Code (GSOC) و Rails Girls Summer of Code (RGSOC) و Outreachy و Google Code-In (GCI). تشمل بعض الميزات الرئيسية:

  • بوابة سؤال وجواب لحل المشكلات القائمة على الأقران
  • نص غني ومحرر تخفيض
  • تحرير ويكي وتتبع المراجعة
  • وضع العلامات والمجموعات الموضعية ومؤسسة المحتوى
  • اشتراكات إشعار البريد الإلكتروني للموضوعات والتعليقات
  • واجهة بحث مبنية من واجهة برمجة التطبيقات المتنامية لدينا
  • لوحة معلومات المستخدم التي تقدم النشاط الأخير
  • نظام وضع علامات على الموقع حساس للخصوصية وخريطة المجتمع

خريطة الطريق

نحن نقوم بتطوير مشروع خريطة طريق لل plots2 ومشاريعنا الأوسع في قانون المختبرات العامة ؛ اقرأ المزيد وتعليق هنا.

يمكن العثور على وصف كامل للميزات والجمهور والعلاقات المتبادلة وأهداف مشاريع برامج المختبر العام هنا: https://publiclab.org/software-overview

جدول المحتويات

  1. ما الذي يجعل هذا المشروع مختلفًا
  2. نموذج البيانات
  3. المساهمة
  4. المتطلبات الأساسية
  5. تثبيت
    • التثبيت القياسي
    • تثبيت Windows
    • نظام Windows الفرعي لتثبيت Linux 2
    • تثبيت redis
  6. SSL في التنمية
  7. تسجيل الدخول
  8. الاختبار
  9. المشرفون
  10. كيف تبدأ وتعديل وظائف cron
  11. حزمة exec
  12. رد على بعد
  13. الأخطاء والدعم
  14. recaptcha
  15. تدويل
  16. حماية
  17. المطورين
  18. أول مرة؟
  19. Hacktoberfest

ما الذي يجعل هذا المشروع مختلفًا

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

من التصميم إلى بنية النظام إلى أنماط المفردات والاتصالات الأساسية ، نمت أنظمتنا بشكل عضوي منذ عام 2010 لدعم شبكة قوية ومتنوعة وتعاونية من الأشخاص القادرين على مواجهة المشكلات البيئية التي تؤثر على المجتمعات على مستوى العالم. تتحدث المنصة التي بنيناها معًا إلى هذا التاريخ المشترك بعدة طرق ، كبيرة وصغيرة. ويعكس مدخلات من الأشخاص الذين يواجهون قضايا صحية خطيرة ، والمنظمين على أرض الواقع ، ومتخصصين في السياسة ، ومتسلولي الأجهزة ، والمعلمين ، وموظفي الخدمة المدنية.

قام هذا المجتمع العريض وفريق المختبر العام بتيسير مساحة حيث يمكننا مناقشة المشاريع الواقعية وإنشائها وبناءها ونموذجها ونقدها. لقد قمنا معًا بتشكيل منصة تتضمن قطعًا مألوفة ولكنها تبدو في النهاية مختلفة عن أي شيء آخر على الإنترنت. على الرغم من نمو منصتنا ، إلا أنه لا يزال ملتزماً بسماع أصوات الآخرين ، والاحترام والدعم المتبادلين ، والوعي بالحواجز والتحديات التي تقدمها الفجوات في الخبرة والمعرفة ، وحساسية عدم المساواة واختلال القوة التي تديمها العديد من أوضاع إنتاج المعرفة والتطور التكنولوجي والعلم.

لقد سمح لنا هدفنا المتبادل بضعف تقنيات القيام به غير مكلفة ويمكن الوصول إليها بنفسك بإنشاء شبكة تعاونية من الممارسين الذين يعيدون تصور العلاقة الإنسانية بنشاط. يتم دعم أهدافنا وتسهيلها من قبل نظام يسأل وحتى يتحدى كيف يمكن أن يحدث العمل التعاوني.

نموذج البيانات

رسم بياني

(أعلاه: مسودة نموذج البيانات لدينا)

المساهمة

نرحب بالمساهمات ، ونهتم بشكل خاص بالترحيب بالمساهمين لأول مرة. اقرأ المزيد عن كيفية المساهمة أدناه! نرحب بشكل خاص بالمساهمات من الأشخاص الذين ينتمون إلى مجموعات ممثلة تمثيلا ناقصا في برامج مجانية ومفتوحة المصدر!

مدونة لقواعد السلوك

يرجى قراءة والالتزام بمدونة قواعد سلوكنا ؛ يطمح مجتمعنا إلى أن يكون مكانًا محترمًا أثناء التفاعلات عبر الإنترنت والشخصية.

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

للتثبيت ، تشمل المتطلبات الأساسية SQLITE3 و RVM. انقر هنا للحصول على قائمة كاملة والتعليمات.

تثبيت

التثبيت القياسي

  1. شوكة ريبو لدينا من https://github.com/publiclab/plots2.
  2. في وحدة التحكم ، قم بتنزيل نسخة من ريبو متشعب مع git clone https://github.com/your_username/plots2.git حيث يكون your_username هو اسم المستخدم الخاص بك.
  3. أدخل دليل Plots2 الجديد مع cd plots2 .
  4. قم بتعيين جهاز التحكم عن بُعد المنبع على عنوان URL الأصلي للمستودع بحيث يعرف GIT من أين يجلب التحديثات في المستقبل: git remote add upstream https://github.com/publiclab/plots2.git
  5. خطوات لتثبيت الأحجار الكريمة:
    • قد تحتاج إلى bundle install أولاً إذا كان لديك جواهر أقدم في بيئتك من أعمال القضبان السابقة. إذا حصلت على رسالة خطأ مثل Your Ruby version is 2.xx, but your Gemfile specified 2.7.3 فأنت بحاجة إلى تثبيت Ruby الإصدار 2.7.3 باستخدام rvm أو rbenv .
      • باستخدام RVM : rvm install 2.7.3 متبوعًا بـ rvm use 2.7.3
      • باستخدام RBENV : rbenv install 2.7.3 يليه rbenv local 2.7.3
    • قم بتشغيل bundle config set without 'production mysql' من مجلد Rails Root لتعيين مشروعك لاستبعاد المكتبات المطلوبة فقط في الإنتاج.
    • قم بتثبيت الأحجار الكريمة مع bundle install من مجلد Rails Root.
  6. قم بتشغيل cp db/schema.rb.example db/schema.rb لعمل نسخة من db/schema.rb.example في db/schema.rb .
  7. يمكنك اختيار استخدام MySQL2 أو SQLite3 كقاعدة بياناتك. نوصي باستخدام sqlite3 كقاعدة بيانات PLOTS2 الخاصة بك لأن بعض المساهمين لدينا قد أبلغوا عن مشكلات أثناء استخدام mysql2 .
    • إذا كان mysql2 ، قم بتشغيل cp config/database.yml.mysql.example config/database.yml لعمل نسخة من config/database.yml.mysql.example في config/database.yml
    • إذا كان SQLITE3 ، قم بتشغيل cp config/database.yml.sqlite.example config/database.yml لإجراء نسخة من config/database.yml.sqlite.example في config/database.yml . يرجى ملاحظة ما إذا كنت اخترت استخدام SQLite قد تفشل بعض الاختبارات. تم إعداد المشروع مبدئيًا لاستخدام MySQL وبعض الاختبارات مصممة خصيصًا لـ MySQL DB. لا حاجة لإنذار ، نحن نعمل على إصلاحها وهذا لن يتداخل مع عملية التطوير الخاصة بك
  8. Run rake db:setup لإعداد قاعدة البيانات
  9. تثبيت الأصول الثابتة (مثل مكتبات JavaScript الخارجية ، الخطوط) مع yarn install
  10. Setup React & WebPacker عن طريق تشغيل rails webpacker:install && rails webpacker:install:react && rails generate react:install (للاطلاع على عمل SSL المحلي ، انظر SSL أدناه)
  • إذا حصلت على أي مطالبة للكتابة فوق ملفات في هذه الخطوة ، فيرجى اختيار لا. سيكون الموجه مثل "الكتابة فوق/home/plots2/config/webpacker.yml؟ (أدخل" H "للمساعدة) [ynaqdhm]" :- اكتب "n" وأدخل.
  1. ابدأ الخادم مع passenger start وانتقل إلى http://localhost:3000/ على متصفحك.
  2. wheeeeee! أنت مستيقظ وتشغيل! قم بتسجيل الدخول باستخدام أسماء المستخدمين "مستخدم" أو "مشرف" أو "مسؤول" وكلمة مرور "كلمة المرور".
  3. قم بتشغيل rails test لتأكيد أن التثبيت يعمل بشكل صحيح. يمكنك أيضًا تشغيل rails test:system لاختبارات النظام. ( ملاحظة: إذا اخترت SQLite كقاعدة بياناتك ، فقد تفشل بعض الاختبارات ؛ يرجى تجاهلها ، فنحن نعمل على إصلاح هذا. إذا بدأ الخادم الخاص بك بشكل صحيح ، فأنت جميعًا قد تم تعيينك )

تثبيت Windows

نوصيك إما بالعمل في بيئة افتراضية ، أو في نظام تمهيد مزدوج لتجنب مشكلات التبعيات لأن أنظمة UNIX تميل إلى العمل أكثر سلاسة مع Ruby و Rails. لن يفيدك هذا الآن فقط من أجل Plots2 ، ولكن أيضًا في المستقبل أثناء العمل على مشاريع Ruby الأخرى ، سيجعل نظام التشغيل Linux أو Mac الخاص بك أسهل بكثير.

  1. نظام Windows الفرعي لـ Linux (موصى به)
  2. التمهيد المزدوج ، خيار 2 ، دليل الفيديو
  3. إعداد Linux Virtual Env

نظام Windows الفرعي لتثبيت Linux 2

قبل المتابعة مع خطوات التثبيت في هذه القراءة ، يجب على مستخدمي Windows Subsystem for Linux 2 (WSL 2) فتح محطة WSL 2 واكتب الأوامر أدناه.

  1. تثبيت التبعيات المطلوبة من مصدر Ruby مع الأوامر التالية:
  • sudo apt update
  • sudo apt install curl g++ gcc autoconf automake bison libc6-dev
  • sudo apt install libffi-dev libgdbm-dev libncurses5-dev libsqlite3-dev libtool
  • sudo apt install libyaml-dev make pkg-config sqlite3 zlib1g-dev libgmp-dev
  • sudo apt install libreadline-dev libssl-dev
  1. أضف مفتاح GPG وتثبيت RVM:
  • تثبيت GNUPG2 إذا لم تكن قد لم تكن بالفعل: sudo apt install gnupg2
  • gpg2 --recv-keys 409B6B1796C275462A1703113804BB82D39DC0E3 7D2BAF1CF37B13E2069D6956105BD0E739499BDB
  • curl -sSL https://get.rvm.io | bash -s stable
  1. قم بتحميل متغيرات بيئة البرنامج النصي باستخدام أمر المصدر:
  • source ~/.rvm/scripts/rvm
  1. تثبيت واستخدام نسخة روبي محددة:
  • rvm install ruby-xxx (this projects Ruby version)
  • rvm --default use ruby-xxx (replace xxx with this project's Ruby version)
  1. لمزيد من المرجع ، اقرأ هنا

تثبيت redis

يستخدم المختبر العام redis وقد يكون مطلوبًا لبعض الوظائف عند تشغيل التطبيق محليًا.

  1. قم بتثبيت redis إذا لم تقم بالفعل:
  • باستخدام MacOS : brew install redis
  • باستخدام Linux : sudo yum -y install redis
  • باستخدام Ubuntu WSL2 :
    • تحديث وترقية Ubuntu: sudo apt update && apt upgrade
    • تثبيت REDIS: sudo apt install Redis-server
    • افتح ملف redis.config: sudo nano /etc/redis/redis.conf
    • قم بتحديث الملف عن طريق تغيير خط لا يشرف على النظام الخاضع للإشراف (يستخدم Ubuntu SystemD)
    • ابدأ Redis: sudo service redis-server start
    • فتح redis cli: redis-cli
    • اختبار redis: النوع ping والاستجابة يجب أن يكون pong
    • خروج CLI: نوع quit
    • مذهل ؟ كل ذلك ✅
  1. تشغيل Redis Server:
  • باستخدام MacOS : brew services start redis
  • باستخدام Linux : redis-server
  1. Run Sidekiq: bundle exec sidekiq
  2. إذا بدأت Sidekiq بشكل صحيح تم تكوين Redis والعمل!

SSL في التنمية

في Public Lab ، نستخدم GEM OpenSSL لتوفير طبقة SSL (طبقة مآخذ آمنة) لاتصال آمن (HTTPS) في وضع التطوير. يمكنك تشغيل اتصال HTTPS على المضيف المحلي من خلال الخطوات التالية:

  1. استخدم passenger start --ssl --ssl-certificate config/localhost.crt --ssl-certificate-key config/localhost.key --ssl-port 3001 .
  2. افتح https: // localhost: 3001.
  3. أضف استثناءات الأمان من الإعدادات المسبقة للمتصفح. يمكنك أيضًا استخدام HTTP (اتصال غير آمن) على رقم المنفذ 3000 من خلال الانتقال إلى "http: // localhost: 3000 '. نستخدم رقم المنفذ 3001 لصالح "HTTPS" والمنفذ رقم 3000 لاتصال "HTTP". هناك حاجة إلى اتصال آمن لمصادقة OAuth وما إلى ذلك.

تسجيل الدخول

بمجرد إكمال التثبيت ، استخدم أيًا من بيانات الاعتماد هذه لتسجيل الدخول إلى موقع الويب PL في بيئة التطوير/الاختبار المحلي لاكتساب أذونات إضافية للمستخدمين الذين تم تسجيلهم فقط. كل واحد يأتي مع مجموعة الأذونات الخاصة به. ومع ذلك ، فإن التجربة عبرهم هي نفسها إلى حد كبير.

اسم المستخدم : admin أو moderator أو user

كلمة المرور : password

لمعرفة المزيد عن أنظمة تسجيل الدخول ، راجع هذه الصفحة

الاختبار

انقر هنا للحصول على وصف شامل للاختبار وهنا للتعرف على اختبارات النظام.

المشرفون

  • انظر /doc/maintainers.md لسياسة المختبر العام بشأن مشرفيات الميزات!

كيف تبدأ وتعديل وظائف cron

  1. نحن نستخدم كلما جوهرة لجدولة وظائف cron.
  2. تتم كتابة جميع وظائف CRON في بناء جملة Ruby Easy باستخدام هذه الأحجار الكريمة ويمكن العثور عليها في config/tavor.rb.
  3. انتقل إلى ملف التكوين/الجدول الزمني لإنشاء وتعديل وظائف CRON.
  4. انقر هنا لمعرفة المزيد حول كيفية كتابة وظائف cron.
  5. بعد تحديث ملف config/mathere.rb ، قم بتشغيل الأمر whenever --update-crontab لتحديث وظائف CRON.
  6. لمشاهدة القائمة المثبتة لوظائف cron استخدام الأمر crontab -l
  7. لمزيد من التفاصيل حول هذه الأحجار الكريمة ، تفضل بزيارة المستودع الرسمي للأجهزة الجوهرية.

حزمة exec

بالنسبة للبعض ، سيكون من الضروري إعداد أوامرك المتعلقة بالأحجار الكريمة مع bundle exec . على سبيل المثال ، bundle exec passenger start . تضمن إضافة bundle exec أنك تستخدم إصدار الركاب الذي قمت بتثبيته للتو باستخدام Bundler. bundle exec rake db:setup ، bundle exec rake db:seed هي أمثلة أخرى للمكان الذي قد يكون هذا ضروريًا.

رد على بعد

يدعم المختبر العام الآن ميزة "الرد عبر البريد الإلكتروني للتعليق". لمزيد من التفاصيل ، انتقل إلى وثائق البريد الإلكتروني

الأخطاء والدعم

للإبلاغ عن الأخطاء وطلب الميزات ، يرجى استخدام تعقب قضية Github

للحصول على دعم إضافي ، انضم إلى موقع الويب الخاص بالمختبر العام وقائمة البريد على http://publiclab.org/lists. للحصول على طلبات عاجلة ، أرسل بريدًا إلكترونيًا إلى [email protected]

recaptcha

يستخدم هذا التطبيق recaptcha عبر GEM Recaptcha في الإنتاج فقط. لمزيد من المعلومات ، انقر هنا.

تدويل

PublicLab.org يدعم الآن التدويل والتوطين ، على الرغم من أننا في المراحل الأولية. وقد تم ذلك مع Rails-I8n.

لرؤيته في العمل ، انقر فوق "اللغة" المنسدلة الموجودة في قسم التذييل في الصفحة. يمكن العثور على جميع الإرشادات وأفضل الممارسات لـ I18N هنا.

يتم ترتيب الترجمات في ملفات YAML هنا ، والتي يتم تعيينها بطريقة مماثلة لملفات طرق العرض. مثال على إضافة ترجمات يمكن العثور عليها هنا.

منذ تنفيذ نظام الترجمة الجديد لدينا ، نستخدم الآن Helper translation() ، الموجود هنا. يوفر هذا بعض ميزات الترجمة الإضافية مثل إدخال موجه مرئي لزوار الموقع في حالة عدم وجود ترجمة حتى الآن. يمكنك معرفة المزيد عن نظام الترجمة الخاص بنا من خلال قراءة مستندات نظام الترجمة لدينا.

لإضافة لغات جديدة أو للحصول على دعم إضافي ، يرجى الكتابة إلى [email protected]

حماية

للإبلاغ عن نقاط الضعف الأمنية أو عن أسئلة حول الأمان ، يرجى الاتصال بـ [email protected]. سوف تقوم مجموعة عمل الويب لدينا بتقييم وتستجيب على الفور.

المطورين

تساعد في تحسين برنامج المختبر العام!

  • انضم إلى قائمة مناقشة قطع الغيار [email protected] للمشاركة
  • ابحث عن مشكلات مفتوحة على https://github.com/publiclab/plots2/labels/help-wanted
  • نحن نطلب المساعدة على وجه التحديد في المشكلات المسمى بعلامة مساعدة
  • ابحث عن الكثير من المعلومات حول المساهمة في http://publiclab.org/wiki/developers
  • مراجعة إرشادات مساهمة محددة على http://publiclab.org/wiki/Contributing-to-public-lab-warware
  • بعض devs تتسكع في IRC Webchat
  • انضم إلى دردشة Gitter
  • جرب بعض المهام الداعمة
  • الانخراط مع شيكات المجتمع الأسبوعية لدينا. للإرشادات: https://github.com/publiclab/plots2/tree/main/doc/checkins.md
  • يمكنك مساعدتنا عن طريق فتح قضايا الموقتات الأولى أو FTO. يمكن العثور على قالب فتح مشكلة على https://github.com/publiclab/plots2/blob/main/.github/issue_template/-first-timers-only.md

أول مرة؟

جديد لفتح المصدر/البرامج المجانية؟ فيما يلي مجموعة مختارة من المشكلات التي قمنا بها خاصة بالنسبة للممتدين الأولين . نحن هنا للمساعدة ، لذا فقط اسأل عما إذا كان المرء يبدو مثيرًا للاهتمام: https://code.publiclab.org

فيما يلي رابط لسير العمل GIT الخاص بنا.

Hacktoberfest

هل ترغب في المساهمة في PublicLab كجزء من Hacktoberfest؟ تحقق من مستندات Hacktoberfest الخاصة بنا

دع الرمز معك.

Happy OpenSouring. ؟

المنصات التي ❤ OSS

يوسع
معلومات إضافية
تطبيقات ذات صلة
نوصي لك
أخبار ذات صلة الكل