مشروع المشاع الإبداعي

تحتوي هذه الصفحة على تفاصيل مشروع كتابة تقنيّة تم قبوله في موسم المستندات من Google.

ملخص المشروع

المؤسسة المفتوحة المصدر:
مؤسسة المشاع الإبداعي
الكاتب التقني:
JackieBinya
اسم المشروع:
دليل استخدام المظهر الأساسي على WordPress
مدة المشروع:
المدة العادية (3 أشهر)

وصف المشروع

خلال مرحلة تقديم طلب الكاتب الفني ضمن GSOD-2020، أجريتُ عدة تفاعلات مع "هوغو سولار"، وهو المرشد لمشروع وثائق المواضيع الأساسية في WordPress.

عند اتصالي الأول معه، طلبتُ المساعدة في فهم أهداف إنشاء دليل استخدام المظهر الأساسي في WordPress، وساعدني كثيرًا وساعدني في تنفيذ المشروع بسرعة. كانت جميع التفاعلات المتتالية التي أجريناها بعد ذلك تتعلق بتحسين أهداف مستندات الموضوع الأساسي لـ CC WordPress.

عندما وصلت إلى مرحلة، شعرتُ أنني فهمت متطلبات المشروع وأهدافه، ثم تابعت إنشاء مسودة اقتراح لدليل استخدام المظهر الأساسي لـ CC WordPress.

تم إنشاء الاقتراح باستخدام النموذج الرسمي لـ "مؤسسة المشاع الإبداعي" لطلبات المتدربين. توفّر هذه الصفحة معلومات حول ملخّص المشروع والهيكل المقترح للمشروع وتخطيط مستندات المظهر الأساسي في WordPress، بالإضافة إلى معلومات عن المخططات الزمنية والمُخرَجات النهائية لمرحلة إنشاء المستند.

بعد ذلك، راجع "هيوغو سولار" مسودّة الاقتراح وقدّم لي ملاحظاتي لإدخال التحسينات. طوال هذه العملية، كان دائمًا متاحًا للإجابة عن الأسئلة المتعلقة بالمشروع.

لقد نفّذت الملاحظات المقدَّمة، ويتوفّر اقتراحي النهائي بشأن إنشاء شارة "الإنشاء والتوجيه" في الرابط أدناه كمستند Google.

https://docs.google.com/document/d/1XmIsMTLstbhRRSaNFP538YOXJiS0G5QrN6EzuqJfRy4/edit?usp=sharing

أو بدلاً من ذلك، يوجد ملخص موجز لاقتراحي، وهو موجود أدناه:

دليل استخدام المظهر الأساسي لبرنامج WordPress - Creative Commons - WordPress اقتراح من إعداد "جاكلين بينيا"، 28 يونيو 2020

ملخص المشروع الهدف النهائي من هذا المشروع هو إنشاء وثائق غنية وبديهية وجذّابة ومُقدَّمة بشكل رائع للتعامل مع المظهر الأساسي في WordPress.

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

الحل إنشاء مستندات مستقبلية باستخدام أطر عمل حديثة مثل "غاتسبي". لدى "غاتسبي" بادئات يمكننا استخدامها لتشغيل مستندات المظهر الأساسي في WordPress. ومن الأمثلة على ذلك دليل البدء gatsby-gitbook-starter الذي يأتي بدعمٍ لتحسين محركات البحث (SEO) وMarkdown وAlgolia ( أداة تُستخدم للتكامل مع البحث في المواقع الثابتة). بالإضافة إلى ذلك يمكن بسهولة تحسين أي موقع من إنشاءه "غاتسبي" لدمج تدويل وتسهيل الاستخدام. خلال عملية إنشاء المستندات، يكون هدفي هو تسهيل عملية إنشاء المستندات قدر الإمكان من خلال: - كتابة المستندات بطريقة سهلة الفهم مع الحرص على تفادي الغموض واستخدام المصطلحات التقنية المعقّدة بشكل مفرط. - من خلال دمج الرسوم التوضيحية والوسائط في المستندات لاستخدامها كوسائل مساعدة بصرية للتعلم. - استخدام أمثلة توضح كيفية تنفيذ المهام الشائعة مثل عمليات التخصيص.

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

البنية المقترَحة لدليل استخدام المظهر الأساسي لـ CC WordPress - سيتم تقسيم الوثائق المقترَحة إلى أقسام مختلفة مُدرجة أدناه. تعطي عناصر القائمة الفرعية تحت كل قسم مقترح المزيد من التفاصيل حول المحتوى الفعلي الذي سيتم العثور عليه في الأقسام المعنية.

قسم النظرة العامة - تحديد تعريف وأغراض وميزات المظهر الأساسي في WordPress(CC) Creative Commons. * التعريف: صِف بإيجاز المظهر الأساسي لـ CC WP. * الأهداف: تحديد غايات وغايات المظهر الأساسي لـ CC WP * الميزات: تحديد ميزات المظهر الأساسي لـ CC WP

قسم البدء - المتطلبات * توضيح متطلبات تثبيت المظهر الأساسي لخدمة CC WordPress، أي - إصدار WordPress - إصدار PHP - Composer وما إلى ذلك - دليل التثبيت * وضِّح كيف يمكن للمستخدمين استخدام ملفات zip لتثبيت مظهر CC WordPress * وضِّح كيف يمكن للمستخدمين البدء من خلال استنساخ مظهر WP الأساسي من GitHub. * تحديد كيف يمكن للمستخدمين تثبيت التبعيات في المشروع. * اشرح كيف يمكن للمستخدمين ضبط تبعية Queulat. * اشرح كيف يمكن للمستخدمين تفعيل المظهر في بيئة تطوير WordPress المحلية.

دليل الاستخدام - نظرة عامة * شرح مصطلح المظهر الفرعي * ذِكر مزايا استخدام المظهر الفرعي. * أخبِر المستخدمين بأنّ الطريقة الموصى بها لتعديل المظهر الأساسي في WP هي من خلال استخدام مظهر فرعي. * أبرِز حقيقة أنّه يجب تثبيت مظهر WP الأساسي وتفعيله قبل أن يتمكّن المستخدمون من إنشاء مظهر فرعي.

استخدام مظهر فرعي - اشرح كيف يمكن للمستخدمين إنشاء مظهر فرعي من مظهر WP الأساسي باستخدام إجراء تفعيل. استخدِم فيديو لشرح كيف يمكن للمستخدمين إنشاء موضوع ثانوي من إجراء التفعيل.

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

قسم التخصيصات المتقدمة - تخصيص قسم CSS * وصف المكونات التي تشكّل تصميم الموضوع: - CC Vocabulary - Bulma - Sass * توضيح كيفية إعداد Sass في المشروع يجب أن يشتمل الشرح على معلومات عن: (1) موقع ملفات sass في بنية المشروع (2) النصوص البرمجية npm التي يمكن استخدامها لإنشاء محتوى sass ومشاهدته * شرح كيف يمكن للمستخدمين بعد ذلك تخصيص أنماط sass ضمن المظهر الفرعي - أي من خلال تثبيت تبعيات npm محددة * شرح كيفية استخدام فئة المكونات (class-component.php) لتخصيص المكونات المحددة

  • قسم الخطاطيف
  • نظرة عامة

    • شرح مصطلح "النقاط المدمَجة"
    • اشرح لماذا يحتاج المستخدمون إلى الاستفادة من عناصر الجذب.
    • حدِّد أنواع الخطّاف المتاحة.
  • استخدام الإجراءات

    • سرد الإجراءات المتاحة في مظهر WP الأساسي وموضعه
    • اشرح كيف يمكن تنفيذ هذه الإجراءات.

*استخدام الفلاتر - إدراج الفلاتر المتاحة في المظهر وشرح كيفية تطبيقها

تعديل قسم المظهر: اشرح كيف يمكن للمستخدمين تعديل المظهر.

قسم الترخيص * اشرح ترخيص المشروع وما يعنيه للأشخاص الذين قد يرغبون في استخدام المظهر الأساسي لـ CC WP في مشاريعهم الشخصية.

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