وصفة إعادة بناء الأصول
إعادة توليد جميع أصول العلامة النقطية من مصادر SVG الرئيسية باستخدام resvg وPillow.
تُعيد وصفة إعادة بناء الأصول توليد كل أصل نقطي من ملفات SVG الرئيسية. وهي مسار التحديث المرجعي لتكرارات العلامة.
متى تُشغَّل
شغِّل وصفة إعادة البناء عندما:
- يتغيّر ملف SVG الرئيسي (
assets/src/logo.svgأوassets/src/logo-dark.svg). - يتغيّر ملف favicon المضغوط الرئيسي (
assets/favicon.svg). - يتغيّر ملف بطاقة اجتماعية رئيسي (
assets/src/og-banner.svgأوassets/src/twitter-card.svg). - يلزم حجم نقطي جديد.
- تريد التحقُّق من أن الأصول المُلتزَم بها لا تزال مطابقة لمصدر SVG.
السكربت
| السكربت | المنصّة | المسار |
|---|---|---|
rebuild-assets-resvg.py | أي مضيف به Python + resvg | scripts/dev/rebuild-assets-resvg.py |
المتطلبات
يُنقِّط المولِّد كل ملف SVG باستخدام resvg ويؤلِّف المجموعات النقطية باستخدام Pillow:
- Pillow:
pip install pillow. - resvg: نزِّل ثنائي الإصدار الخاص بمنصّتك من
إصدارات resvg —
resvg-win64.zipعلى Windows، أوresvg-linux-x86_64.tar.gzعلى Linux، أوresvg-macos.zipعلى macOS — واستخرجه إلىPATH، أو وجِّه السكربت إليه عبر--resvg <path>.
الاستخدام
أعِد توليد كل أصل نقطي:
python scripts/dev/rebuild-assets-resvg.pyمرِّر --check-only للتحقُّق من توفُّر سلسلة الأدوات دون إعادة توليد
أي أصول:
python scripts/dev/rebuild-assets-resvg.py --check-onlyإن لم يكن resvg موجودًا على PATH، فوجِّه السكربت إلى الثنائي:
python scripts/dev/rebuild-assets-resvg.py --resvg /path/to/resvgالتحقُّق
يُعيد التشغيل الناجح توليد العلامات النقطية الفاتحة والداكنة، ومجموعة
favicon بصيغتي PNG/ICO، وأيقونات Apple touch،
وصور OG/Twitter، ويعكس المجموعة الفرعية المُقدَّمة على الويب — بما في
ذلك مصادر شعار البطل (hero) التي يُحيل إليها الموقع — إلى site/public/.
بعد التوليد، شغِّل بناء الموقع وافحص الصفحة الرئيسية، وfavicon تبويب
المتصفّح، وملفات PNG للبطاقات الاجتماعية قبل النشر.