المساهمة

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

طلب أيقونة

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

الإبلاغ عن خطأ في أيقونة

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

إرسال أيقونة

إذا رسمت أيقونة بواسطة Skill أو يدويا ولا تريد فتح pull request، فاستخدم صفحة الإرسال. تفحص الصفحة ملفاتك في المتصفح وتجهّز Issue على GitHub. تبقى الملفات في المتصفح إلى أن تنشر Issue.

صدّر الرسم بصيغة SVG. مع Skill، شغّل node scripts/export.mjs. يكفي ملف SVG ثابت: إذا قُبلت الأيقونة، تُضاف الحركة أثناء المراجعة. لاقتراح حركة من تصميمك، أضف ملف المصدر الخاص بالأيقونة.

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

لكي يرسل وكيل البرمجة الأيقونة، الصق هذا الموجّه فيه. يطلب منك Agent تأكيد الشروط، ثم ينشر Issue بواسطة GitHub CLI:

Submit my icon to the Kubai Icons library:
1. Export it as an SVG by running node scripts/export.mjs --only <name> in the skill folder.
2. Ask me to confirm that I made it, that it contains no logos or copied artwork, and that I agree to publish it under the MIT License. Stop if I do not confirm.
3. Run gh issue create --repo kubai087/kubai-icons --title "[Icon submission] <name>" with a body using these headings: "### Name" (kebab-case), "### What it does on hover" and "### Files" (the SVG in a code block, plus the icon's .js source if there is one).
4. Tell me the issue link.

رسم أيقونة

تُخزَّن الأيقونات في icons/، بوحدة ES واحدة لكل أيقونة. ارسمها بواسطة Kubai Icons Skill أو يدويا، مع اتباع PROMPT.md وdocs/authoring.md. للتحقق من عملك، استبدل my-icon أدناه باسم أيقونتك:

bash
git clone https://github.com/kubai087/kubai-icons
cd kubai-icons && npm install
node tools/check.mjs --only my-icon --with folder,mail   # contact sheets in check-out/lib
npm run validate                                          # names, metadata, markup
npm run build:packages
npm test

tools/check.mjs ينشئ لوحات معاينة، وهي صور تعرض أيقونتك بجانب الأيقونات الموجودة المذكورة في --with. أرفقها بطلب الدمج (pull request). يعيد CI رسم الأيقونات المتغيرة ويشغّل الاختبارات، ويراجع أحد المشرفين مدى انسجام الأيقونة مع المجموعة.

الترخيص

الأيقونات المساهَم بها وشيفرة الحزم منشورة بموجب ترخيص MIT. تخضع تغييرات الموقع وSkill لشروطها الخاصة المدرجة في صفحة الترخيص.

Kubai Icons مجانية الاستخدام دعم المشروع