دليل استعمال مستودع الأصول المفتوح المصدر ديال حوتة: تصفّح الموارد، المعاينة محلياً والمساهمة فالتطوير

نبذة على المشروع

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

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

إلى كنتي باغي غير تتصفّح الموارد، تقدر تدخل مباشرة لـالموقع الإلكتروني ديال مستودع الأصول المفتوح المصدر ديال حوتة. وإلى بغيتي تعرف خلفية المشروع، تقدر تشوفالأسئلة الشائعة ديال المشروع.

المحتوى والخصائص الرئيسية

• مراجع لإبداع الشخصية: كيجمع تصاور إعداد الشخصية وكلمات توجيه للتوليد تقدر تنسخها وتستعملها مباشرة.
• دليل الموارد المرتبطة: كينظم مشاريع مجتمع حوتة، وأدوات الإبداع، والمراجع.
• معرض أعمال المجتمع: كيعرض أعمال الإبداع المشتقة والصور الساخرة ديال المجتمع.
• المساهمة بسهولة: حتى اللي ما مبرمجش يقدر يرسل أعمال، أو يقترح موارد، أو يبلغ على مشاكل باستعمال نماذج GitHub.
• بنية موقع ثابت: ملفات مصدر الموقع مجموعين فـ site/، وتقدر تعاين الموقع محلياً باستعمال خدمة Python HTTP بسيطة.
• النشر التلقائي: منين كيتدفع التغيير لفرع main، كيقوم GitHub Actions بنشر site/ تلقائياً على GitHub Pages.

طريقة الاستعمال أونلاين

الخطوة الأولى: دخل لموقع الموارد

حلّالموقع أونلاين وتصفّح الموارد والمعرض ديال المجتمع اللي كيبانو فالصفحة الرئيسية. إلا كنتي غير غادي تشوف أو تنسخ المحتوى الموجود، ما كاين حتى برنامج خاصك تثبتو.

الخطوة الثانية: قلب على مراجع الإبداع

شوف تصاور إعداد الشخصية وكلمات التوجيه للتوليد حسب الحاجة ديال الإبداع. تصاور الإعداد كتنفع فملاحظة عناصر الشخصية، وكلمات التوجيه تقدر تنسخها مباشرة وتعدّلها حسب الهدف ديالك. وبما أن المشروع ما كيفرضش شخصية وحيدة، خاصك تعتبر هاد المواد مراجع ديال المجتمع وماشي قواعد إلزامية.

الخطوة الثالثة: تأكد من ترخيص الموارد

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

التثبيت والمعاينة محلياً

هاد المشروع موقع ثابت، وما كيحتاجش تثبيت معقد للتبعيات ولا أدوات بناء. ملف README كينص بوضوح على ضرورة تثبيت Python 3 فالبيئة المحلية.

1. جيب ملفات المستودع

تقدر تحمّل أرشيف المستودع المضغوط من GitHub، أو تستعمل Git باش تستنسخ المشروع:

git clone https://github.com/TreapGoGo/deepseek-whale-girl.git
cd deepseek-whale-girl

2. شغّل الخادم المحلي

نفّذ الأمر التالي فالمجلد الرئيسي ديال المستودع:

python -m http.server 4173 --directory site

كيستعمل هاد الأمر خادم HTTP المدمج فـ Python، وكيعيّن site/ كمجلد الموقع، وكيصغي للمنفذ 4173 فالجهاز المحلي.

3. حلّ صفحة المعاينة

من بعد ما يبدا الخادم، دخل فالمتصفح لـ:

http://localhost:4173

من بعد ما تعدّل ملفات HTML أو CSS أو JavaScript، غير حدّث المتصفح باش تشوف النتيجة. ومنين تسالي المعاينة، ضغط على Ctrl+C فالطرفية اللي خدام فيها الخادم باش توقف الخدمة.

شرح بنية المستودع

.
├── .github/
│   ├── ISSUE_TEMPLATE/
│   └── workflows/pages.yml
├── characters/
└── site/
    ├── assets/
    ├── index.html
    ├── project.html
    ├── contribute.html
    ├── styles.css
    └── script.js

• .github/ISSUE_TEMPLATE/: كيتحفظو فيه نماذج أعمال المجتمع، واقتراحات الموارد، والتبليغات.
• .github/workflows/pages.yml: كيعرف مسار النشر التلقائي على GitHub Pages.
• characters/: كيتحفظ فيه الأرشيف الأصلي لتصاور إعداد الشخصية ومواد العلامة.
• site/assets/: كيتحفظو فيه تصاور الموقع ومواد معرض المجتمع.
• site/index.html: الصفحة الرئيسية ديال الموقع ومعرض الموارد.
• site/project.html: صفحة الأسئلة الشائعة ديال المشروع.
• site/contribute.html: صفحة شرح طرق المساهمة.
• site/styles.css: تنسيقات الصفحات.
• site/script.js: منطق التفاعل فالصفحات.

مثال على تعديلات أساسية

تعديل محتوى الصفحة

إلى بغيتي تبدّل النصوص فالصفحة الرئيسية أو عرض الموارد، بدا من site/index.html. الأسئلة الشائعة وشرح المساهمة كاينين على التوالي فـ site/project.html وsite/contribute.html.

1. عدّل ملف HTML المطلوب.
2. إلى بغيتي تبدّل المظهر، عدّل site/styles.css.
3. إلى بغيتي تبدّل التفاعل الموجود فالصفحة، راجع وعدّل site/script.js.
4. شغّل الخادم المحلي باستعمال أمر Python.
5. حدّث المتصفح وتأكد من أن التنسيق والمحتوى والروابط خدامين مزيان.

التعامل مع موارد الصور

الصور ومواد معرض المجتمع المستعملة فالصفحات كاينة فـ site/assets/. أما الأرشيف الأصلي لتصاور إعداد الشخصية ومواد العلامة فكائن فـ characters/. منين كتبدّل مرجع صورة، خاصك تتأكد فالنفس الوقت من مسار الملف، ومعلومات المصدر، وتوضيحات الترخيص.

المساهمة بلا برمجة

المشروع واجد نماذج GitHub Issue لأنواع مختلفة ديال المساهمات. اختار المدخل المناسب حسب المحتوى باش تعاون المسؤولين يعالجو الطلب بسرعة أكبر:

• شارك أعمال المجتمع: صيفط أعمال إبداع مشتقة مرتبطة بحوتة.
• اقترح موارد مرتبطة: اقترح مشاريع أو أدوات أو مراجع.
• بلّغ، صحّح أو زِد معلومات: بلّغ على الأخطاء، أو قدّم اقتراحات، أو تاصل بالمسؤولين بخصوص محتوى ممكن ينتهك الحقوق.

من الأحسن ملي كتقدّم الطلب توضّح مزيان اسم العمل أو المورد، والمصدر، والمؤلف، ومعلومات الترخيص. هاد الشي كيسهّل على المسؤولين التحقق، وكيقلّل من خطر سوء فهم نطاق الترخيص من طرف المستخدمين من بعد.

حسّن الموقع باستعمال Pull Request

المساهمون اللي متمكنين من تطوير الويب يقدرو يعدّلو الموقع مباشرة ويقدمو Pull Request. هادي طريقة عملية للمساهمة:

1. عدّل صفحات الويب أو التنسيقات أو السكريبتات داخل site/ ففرع مستقل.
2. شغّل خادم HTTP المحلي وعاين التغييرات.
3. راجع عرض الصفحات فالحاسوب والمتصفحات الشائعة.
4. تحقق من كل رابط تزاد أو تبدّل.
5. وضح فـ Pull Request الهدف من التغيير، والنطاق المتأثر، ونتائج المراجعة.

النشر وتقنيات متقدمة

فهم نطاق النشر التلقائي

مجلد النشر ديال المشروع هو site/. منين كيتدفع تحديث لفرع main، كينفذ GitHub Actions تلقائياً عملية النشر على GitHub Pages. وتقدر حتى تدخل لصفحة Actions فالمستودع وتشغّل النشر يدوياً.

إلى كانت ملفات الأرشيف الأصلي كاينة فـ characters/، ولكن ما تنسخاتش ولا تترابطاتش داخل site/، ما خاصكش تفترض أنها غادي تبان تلقائياً فالموقع المنشور. قبل التعديل، خاصك تفرّق بين مجلد المواد الأصلية ومجلد الموقع الفعلي.

دير فحص بسيط قبل الإرسال

• تأكد أن الصفحة الرئيسية المحلية كتتحل عبر http://localhost:4173.
• راجع الروابط بين الصفحة الرئيسية، والأسئلة الشائعة، وصفحة المساهمة.
• تأكد أن مسارات الصور الجديدة وأسماء الملفات متطابقة.
• تأكد أن تفاعل الموقع ما تعطّلش بسبب تعديلات JavaScript.
• راجع مصدر الموارد، ونسبة الأعمال للمؤلفين، ومعلومات الترخيص.
• شرح بوضوح سبب التعديل فـ commit message.

فرّق بين التراخيص المختلفة

الكود المصدري ديال الموقع فهاد المستودع خاضع لـ MIT License. أما النصوص الأصلية التوضيحية ديال الموقع وكلمات التوجيه للتوليد فخاضعة لـ CC BY-SA 4.0.

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

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

الخلاصة

مستودع الأصول المفتوح المصدر ديال حوتة هو مدخل مركزي لمراجع الشخصية وكلمات التوجيه للتوليد، ومنصة لمشاركة أعمال المجتمع والأدوات والمراجع. المستخدم العادي يقدر يتصفّح أونلاين مباشرة ويساهم باستعمال النماذج؛ والمطور غير خاصو يجهز Python 3 باش يعاين ويعدّل الموقع الثابت محلياً. كيفما كانت طريقة المساهمة، خاص احترام طبيعة الإبداع الجماعي ديال المجتمع والتحقق بعناية من حقوق النشر والترخيص ديال كل مورد.