تخطي إلى المحتوى

ساهم

آخر تحديث في: 18 ديسمبر 2024

تقديم المساهمات والملاحظات

يُعدّ موقع Infuse مفتوح المصدر ونرحب بأي جهود تبذلها للإبلاغ عن المشكلات أو اقتراح فرص للتعاون في تطوير المحتوى أو المساهمة مباشرة في المحتوى أو إضافة موارد جديدة أو إجراء تصحيحات أو تقديم ترجمات إضافية. تقوم مجموعة منظمات (ConexoوDefendDefenders وInternews) بالعمل على إدارة الموقع وستراجع جميع المساهمات المقدمة، ويرجى الانتظار لمدة قد تصل إلى أسبوعين قبل تلقي الرد وفهم أنه قد تكون هناك قيود في الإجراءات التي يمكن اتخاذها لمعالجة التعليقات. يمكنك إرسال الملاحظات العامة وطلبات الدعم إلى [email protected] من أجل الوصول إلى القائمين على المشروع.

تقدم هذه الصفحة نظرة عامة عن طرق المساهمة المباشرة في Infuse وتحريره، وهناك طريقتان نقترحهما للقيام بذلك هما تحرير النص مباشرة على GitHub أو التحرير من خلال نظام إدارة المحتوى المقدم.

التحرير مباشرة على GitHub

يستضاف موقع Infuse على GitHub، لذلك يمكنك اقتراح التعديلات بالنقر على “تعديل هذه الصفحة علىGithub " (Edit this Page on Github) على أي من صفحات وحدة مسار التعلم (كما هو موضح أدناه). لكن لاحظ أن هذا سيتطلب منك أن يكون لديك حساب GitHub.

Top of a learning path module page with an arrow pointing to a link that says “Edit this Page on GitHub”

يجب أن ينقلك الرابط أعلاه إلى صفحة GitHub التي تحتوي على مسار التعلم الذي زرته للتو، علمًا أن جميع المسارات مصممة باستخدام Markdown (انظر ورقة المعلومات المرجعية حول Markdown هنا). بمجرد وصولك إلى الصفحة، انقر على زر “تحرير” الذي يضم شعار قلم رصاص صغير.

GitHub page for learning path 1 module 4 with a green arrow pointing at the edit button, represented by a pencil icon

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

التحرير من نظام إدارة المحتوى

تتمثل إحدى الطرق البديلة لتحرير Infuse في المتصفح بواجهة سهلة الاستخدام في إرسال تغييرات أو محتوى جديد من خلال نظام إدارة المحتوى على https://infuse.quest/admin. ستحتاج بعد ذلك إلى تسجيل الدخول إلى الواجهة الخلفية باستخدام حساب GitHub والسماح للتطبيق بالقراءة والكتابة من حساب GitHub الخاص بك. إذا كنت مهتمًا بمعرفة ما يحدث في الكواليس، يدير هذا التطبيق عملية إنشاء نسخة من الموقع على حساب GitHub الخاص بك ويحفظ جميع التغييرات على نسختك وعندما تصبح مستعدًا لتقديم هذه التغييرات للنظر فيها يقوم بإنشاء طلب سحب GitHub يمكننا مراجعته.

The Infuse log-in page. Two buttons are visible. One says log in with Github and has the GitHub logo, the other says go back to site

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

A page showing the list of learning paths, referred to by numbers rather than names, in the left column, and their individual modules in the right column

بمجرد تحديد الوحدة التي ترغب في تحريرها ستفتح نافذة المحرر الموضحة أدناه. وفيما يلي بعض النقاط البارزة للعمل مع المحرر:

The editor view, showing workflow buttons that allow a user to toggle between drafts and text ready to publish, a language switcher which toggles between different language versions, and a selector that allows the user to pick if they are editing in rich text or markdown

  1. حفظ سير العمل: بمجرد الانتهاء من إجراء التغييرات، اضغط على زر حفظ، مما سيضع الصفحة في وضع المسودة. في هذه المرحلة يمكنك الاستمرار في العمل على الصفحة في وقت لاحق ولكن لن يتم تنبيه فريق Infuse إلى تعديلاتك. وبمجرد أن تكون مستعدًا، يمكنك تغيير الحالة إلى “قيد المراجعة” والتي ستفتح طلب سحب إلى مستودع Infuse الرئيسي.
  2. مبدّل اللغة: يمكن إجراء الترجمات أو تحديثها عن طريق اختيار اللغة المناسبة من هذه القائمة المنسدلة. إذا كنت مهتمًا بالترجمة إلى لغة جديدة فيمكنك مراسلتنا عبر البريد الإلكتروني على [email protected].
  3. محدد المحرر: سيسمح لك محرر Rich Text باستخدام الأزرار الموجودة في اللوحة للتحكم في التصميم بينما يتطلب اختيار Markdown أن تقوم بالتحرير باستخدام Markdown الصحيح.

إضافة الصور

عند إضافة محتوى إلى الموقع سنرغب في بعض الأحيان أيضًا في تضمين الصور

ولإضافة صور إلى موقع Infuse ستحتاج أولًا إلى تحميلها إلى مجلد /static/media/uploads، وهو المكان الذي نحتفظ فيه بجميع الصور لمسارات التعلم والمواد الأخرى. يمكنك إما تحميلها يدويًا من خلال GitHub أو من خلال علامة التبويب “الوسائط” في نظام إدارة المحتوى.

لأجل تحميل صورة عبر GitHub، ما عليك سوى إضافتها إلى المجلد أعلاه.

GitHub, it has opened the Infuse repository and the static/media/uploads folder. The folder contains a series of png files, which are used by the webpage

في حال كنت تفضل استخدام نظام إدارة المحتوى لإضافة ملفات، فيمكنك بدلًا من ذلك استخدام علامة تبويب “الوسائط” (الثالثة من اليسار) في الزاوية العلوية اليسرى من نظام إدارة المحتوى.

The CMS used for Infuse. In the top left, there are three tabs, Contents, Workflow, and Media

يمكننا أيضًا إدراج الصور في محتوى الصفحة إما من خلال نظام إدارة المحتوى أو من خلال markdown.

لإضافة صورة في نظام إدارة المحتوى ما عليك سوى النقر على علامة “+” الصغيرة عند تحرير مستند.

The CMS used for Infuse in rich text editing mode. The editor menu has a small button shaped like a plus sign. Once pressed, it rolls out a submenu which allows the user to enter different types of content, including media and images. In the image, the cursor floats over a submenu item called image

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

The image selector in the CMS used for Infuse. It contains two options: to choose an image (so browse the media folder) or insert from URL

إذا كنت ترغب في إدراج الصورة من عنوان URL عليك أن تتذكر استخدام روابط نسبية. لذا بدلًا من كتابة https://infuse.quest/media/uploads/CFT2_sender_address.png أو https://github.com/OpenInternet/Infuse/blob/main/static/media/uploads/CFT2_sender_address.png، ما عليك سوى كتابة/media/uploads/CFT2_sender_address.png

A dialog box which asks the user to input the URL of an image

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

إذا كنت تفضل إدراج الصورة في markdown، يمكنك الاطلاع على التعليمات البرمجية للقيام بذلك هنا:

![النص البديل هنا](الرابط النسبي هنا)

لذلك قد يتضمن مثال على markdown الذي استخدمناه ما يلي:

![مربع نص فارغ على موقع ويب، حيث يمكن للمستخدم إدخال النص، مع زر إرسال](/media/uploads/web_fundamentals_empty_box.png)

تطوير مسارات ووحدات تعليمية جديدة

هل أنت مهتم بتطوير مسار تعليمي إضافي أو إضافة وحدة جديدة إلى مسار تعليمي موجود؟ إذا كنت ترغب بذلك يرجى التواصل عبر [email protected] للحصول على إرشادات حول كيفية القيام بذلك باستخدام إطار Infuse.

بعض الأمور التي يجب مراعاتها:

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