شارة خلّص: ضعها في موقعك أو في ملف README
إن كنت تستعمل خلّص في عملك أو في مشروعك وتريد قول ذلك، فهذه شارة صغيرة جاهزة بأربع صيغ. انسخ سطر HTML أو سطر Markdown كما هو والصقه حيث تشاء. لا يحتاج الأمر إذنًا ولا تسجيلًا ولا حسابًا، ولا نتتبع من يضعها.
الصيغ الأربع
لكل لغة صيغتان، واحدة لأرضية فاتحة وأخرى لأرضية داكنة. اختر ما يناسب موقعك: الشارة لا تعرف لون الصفحة التي توضع فيها ولا تتكيف معها، فالاختيار اختيارك. المقاس مئتا بكسل في أربعين، والملف بصيغة SVG فيبقى حادًا على أي شاشة ووزنه أقل من كيلوبايت واحد.
عربية، على أرضية فاتحة
عربية، على أرضية داكنة
إنجليزية، على أرضية فاتحة
إنجليزية، على أرضية داكنة
أين تضعها
أكثر المواضع فائدة ثلاثة. الأول ملف README في مستودع يعالج ملفات PDF عربية، وهو الموضع الذي يراه أكثر من يبحث عن حل للمشكلة نفسها. والثاني تذييل موقع أو صفحة أدوات تسرد ما تستعمله. والثالث نهاية مقال أو شرح كتبته وذكرت فيه خطوة أنجزتها بخلّص.
الشارة صورة داخل رابط، فهي تعمل في أي مكان يقبل HTML أو Markdown: GitHub وGitLab، ومولدات المواقع الساكنة، ومنصات التدوين، وصفحات التوثيق. أحد أسباب اختيار SVG بلا خط خارجي أن GitHub يمرر كل صورة في README عبر وسيط يحذف المراجع الخارجية، والشارة التي تحتاج ملف خط تظهر عنده فارغة.
لا تضع الشارة في موضع يوحي بأن خلّص راعٍ لك أو شريك أو مؤيد لما تقول. هي إشارة إلى أداة استعملتها، وهذا كل ما تعنيه.
قواعد الاستعمال
- استعمل الملف كما هو من رابطه. لا تعِد رسمه ولا تلوّنه ولا تقص منه ولا تضف إليه.
- أبقِ الرابط إلى khallas.app. شارة بلا رابط تفقد نصف معناها.
- أبقِ النص البديل كما هو في المقتطف. هو ما يقرؤه من يستعمل قارئ شاشة، وهو ما يظهر إن لم تُحمّل الصورة.
- لا تضع الشارة على صفحة تبيع خدمة على أنها خلّص، ولا في سياق يوحي بأننا نؤيد محتواك.
- لا تستضف نسخة من الملف على خادمك إن كان بالإمكان الوصول إلى الأصل، كي تصلك أي إصلاحات نجريها عليه.
- لا تستعمل الشارة بديلًا عن الشعار. الشعار وقواعده في صفحة الهوية.
نسخة PNG، ولماذا قد تحتاجها
إلى جانب كل شارة SVG يوجد ملف PNG بضعف الدقة على المسار نفسه مع اللاحقة png. استعمله في أي مكان لا يعرض SVG أو يعرضه بطريقته الخاصة: بعض معاينات Markdown في محررات النصوص، وبعض منصات التواصل، وملفات العروض والمستندات.
السبب الحقيقي وراء وجود النسخة الثانية عربي: العربية خط متصل، والحروف تتشكل حسب موضعها في الكلمة. المتصفحات تفعل ذلك بشكل صحيح، لكن بعض البرامج التي تحوّل SVG إلى صورة لا تفعل، فتخرج الحروف منفصلة ومقلوبة. ملف PNG مرسوم في متصفح حقيقي بخط الموقع نفسه، فما تراه فيه هو ما سيراه الجميع.
إن كانت الشارة ستظهر في متصفح فاختر SVG: أحدّ وأخف. وإن كنت لا تدري أين ستنتهي فاختر PNG.
- /badge/khallas-ar.pngعربية، على أرضية فاتحة
- /badge/khallas-ar-dark.pngعربية، على أرضية داكنة
- /badge/khallas-en.pngإنجليزية، على أرضية فاتحة
- /badge/khallas-en-dark.pngإنجليزية، على أرضية داكنة
تفاصيل تقنية
- المقاس: مئتا بكسل عرضًا وأربعون ارتفاعًا. النسخة PNG بضعف ذلك، أي أربعمئة في ثمانين.
- التخزين المؤقت: أربع وعشرون ساعة. الملف قابل للإصلاح في مكانه، ولذلك لم نجعله دائم التخزين.
- الترويسة Access-Control-Allow-Origin مفتوحة، فيمكن رسم الشارة داخل canvas إن احتجت.
- لا يحمل الملف خطًا خارجيًا ولا صورة مضمنة ولا شيفرة. هو أشكال ونص فقط، ووزنه أقل من كيلوبايت.
- الشارة لا تحمل أي معرّف ولا معامل تتبع في الرابط، ولا تعرف من فتح الصفحة التي وُضعت فيها.
أسئلة شائعة
- هل يمكنني استعمال شارة خلّص في موقعي مجانًا؟
- نعم، ودون إذن مسبق. انسخ المقتطف والصقه. الشرط الوحيد أن تبقي الرابط إلى khallas.app وألا يوحي موضع الشارة بأننا شركاء لك أو رعاة أو مؤيدون لما تقول.
- هل تعمل الشارة في ملف README على GitHub؟
- نعم. استعمل مقتطف Markdown. الشارة ملف SVG بلا خط خارجي ولا صورة مضمنة، وهو ما يجعلها تظهر بعد أن يمررها GitHub عبر وسيط الصور الذي يحذف المراجع الخارجية.
- لماذا تظهر الحروف العربية منفصلة في بعض البرامج؟
- لأن ذلك البرنامج يرسم SVG دون تشكيل الخط العربي. المتصفحات تفعله بشكل صحيح، وبعض المحررات ومعاينات Markdown لا تفعله. استعمل ملف PNG في تلك المواضع، فهو مرسوم في متصفح حقيقي.
- هل تتتبع الشارة زوار موقعي؟
- لا. الشارة صورة ساكنة بلا شيفرة وبلا معرّف وبلا معامل في الرابط. خادمنا يرى طلب الصورة كما يرى أي طلب لملف، ولا يربطه بزائر ولا بموقع ولا يخزّن منه شيئًا يميز أحدًا.
- هل أستطيع تغيير ألوان الشارة أو مقاسها؟
- غيّر المقاس على المحورين معًا إن احتجت، فالملف متجه ولن يفقد حدّته. لكن لا تغيّر ألوانه ولا نصه ولا شكله: أربع صيغ جاهزة تغطي الأرضيات الفاتحة والداكنة باللغتين.
- ما الفرق بين الشارة والشعار؟
- الشارة تقول إنك استعملت خلّص، والشعار هو هوية المنتج نفسه. إن كنت تكتب عن خلّص أو تدرجه في دليل فاستعمل الشعار من صفحة الهوية، وإن كنت تشير إلى أداة استعملتها فاستعمل الشارة.
- هل يمكنني استضافة نسخة من الشارة على خادمي؟
- يمكنك، لكن الأفضل أن تربط الأصل. الملف مخزّن مؤقتًا أربعًا وعشرين ساعة فقط تحديدًا كي يصلك أي إصلاح نجريه عليه، والنسخة المستضافة عندك تتجمد على حالها.