نُشر في 2026-10-28
# رمز QR لـ GitHub: ضع مستودعك في مسح واحد
رمز QR لـ GitHub هو رمز ثنائي الأبعاد يفتح صفحة على GitHub — عادةً مستودع، ولكن أيضًا ملف شخصي أو gist أو قضية — في متصفح الشخص الذي يقوم بالمسح. يوجد هذا الرمز لأن المؤتمرات ولوحات التوظيف وملفات README تُقرأ بشكل متزايد على الهواتف، وإدخال github.com/username/repo-name على لوحة مفاتيح الهاتف يمثل نقطة احتكاك حقيقية. لقد جعلت GitHub، منصة استضافة الأكواد المذكورة في مقال ويكيبيديا، تصفح المستودعات عبر الهاتف عادةً عادية. يشفّر الرمز رابط https عاديًا وفقًا لمعيار ISO/IEC 18004، وهو معيار QR من DENSO WAVE، لذا لا يتطلب الأمر أي تطبيق أو تسجيل دخول إلى GitHub للمسح. قم بتوليد الرمز باستخدام مولّد رمز QR للروابط وحافظ على حجمه 25 ملم على الأقل على الشارة أو الملصق.
أي روابط GitHub لها معنى في رمز QR
ليس كل عنوان على GitHub يستحق رمزًا. الروابط التي يشاركها المطورون فعليًا:
| المحتوى | نمط الرابط | مثال | الأفضل لـ |
|---|---|---|---|
| المستودع | https://github.com/{user}/{repo} | https://github.com/jdoe/cli-tool | شارات README، المحاضرات، السيرة الذاتية |
| الملف الشخصي | https://github.com/{user} | https://github.com/jdoe | بطاقات العمل، شارات المؤتمرات |
| Gist | https://gist.github.com/{user}/{id} | https://gist.github.com/jdoe/9a1b2c | مشاركة سكربت أو مقتطف |
| القضية | https://github.com/{user}/{repo}/issues/{n} | https://github.com/jdoe/cli-tool/issues/142 | تقارير الأخطاء في الفعاليات، العروض التوضيحية |
| ملف في المستودع | https://github.com/{user}/{repo}/blob/main/{file} | https://github.com/jdoe/cli-tool/blob/main/README.md | الإشارة إلى وثائق محددة |
| المنظمة | https://github.com/orgs/{org} | https://github.com/orgs/acme-dev | صفحات الفريق، التوظيف |
بعض ملاحظات حول الأنماط. مسار blob يعرض الملف مع تمييز الصياغة، وهو ما تريده عندما يقوم شخص ما بمسح مرجع README؛ أما الرابط الخام فهو للأجهزة. روابط القضايا طويلة، مما يدفع الرمز إلى إصدار أعلى — جدول الأحجام أدناه يُظهر التكلفة. وإذا كان المستودع خاصًا، فإن رمز QR يوفر فقط عناء الكتابة: لا يزال المسح يتطلب حساب GitHub وصلاحيات الوصول.
حجم QR حسب نوع الرابط، مقاس
قمنا بتوليد رمز واحد لكل نوع رابط عند مستوى تصحيح الأخطاء M وسجلنا الإصدار:
| نوع الرابط | طول المثال | إصدار QR (M) | الوحدات | الحد الأدنى للطباعة عند 0.35 ملم |
|---|---|---|---|---|
| الملف الشخصي (22 حرفًا) | 22 | 2 | 25 x 25 | 8.75 ملم |
| المستودع (35 حرفًا) | 35 | 3 | 29 x 29 | 10.15 ملم |
| Gist (58 حرفًا) | 58 | 4 | 33 x 33 | 11.55 ملم |
| قضية مع رقم (55 حرفًا) | 55 | 4 | 33 x 33 | 11.55 ملم |
| مسار blob للملف (74 حرفًا) | 74 | 5 | 37 x 37 | 12.95 ملم |
رابط الملف الشخصي هو الوحيد الذي يتناسب مع رمز من الإصدار 2؛ كل ما يحتوي على جزء مسار يقع في الإصدار 3 أو 4. بالنسبة لرمز بحجم 25 ملم على شارة، جميع الأنواع الخمسة قابلة للمسح براحة، ولهذا يجب أن يكون اختيار نوع الرابط حول المحتوى وليس الحجم. أرقام السعة الأساسية موجودة في كم من البيانات يمكن لرمز QR أن يحتويه؟، وقواعد حجم الوحدة في ما هو أصغر حجم يمكن أن يكون عليه رمز QR؟.
أين يضع المطورون رموز QR لـ GitHub فعليًا
| الموقع | التنسيق | من يقوم بالمسح |
|---|---|---|
| شارة المؤتمر | 25 ملم، أسفل الشارة | الحاضرون الآخرون، دون تسليم الهاتف |
| السيرة الذاتية أو CV | 15 إلى 20 ملم بجانب سطر المشاريع | مسؤولو التوظيف الذين يراجعون عبر الهاتف |
| تذييل README | 64 بكسل في المستودع، يُعرض في المتصفح | القراء الذين يريدون رابط الهاتف |
| عرض المتحدث | 120 بكسل على الشريحة الختامية | الجمهور، أثناء المحاضرة |
| بطاقة العمل | 16 ملم، الزاوية | التواصل الاجتماعي، بيد واحدة |
في ملف README، يكون رمز QR وسيلة مريحة للأشخاص الذين يستخدمون هواتفهم؛ النص الرابط المجاور له يؤدي الوظيفة نفسها للبقية. يجب أن يكون رمز QR في العرض على الشريحة الأخيرة، وليس شريحة العنوان، لأن الناس لا يقومون بالمسح قبل أن يعرفوا أن المحاضرة تستحق المسح. تنطبق نفس قواعد الأحجام على أي رابط موقع ويب، كما هو موضح في رمز QR للموقع الإلكتروني: حقول URL وحدود التحويل.
سلوك المسح: ما الذي يفعله الهاتف بالرمز
- يقوم تطبيق الكاميرا بفك ترميز الرابط وتسليمه إلى المتصفح الافتراضي. لا يلزم تطبيق GitHub.
- يعمل https في كل مكان؛ يتم رفض http من بعض تطبيقات الكاميرا، لذا قم دائمًا بتشفير https.
- يتم تحميل الصفحة المعروضة بنفس طريقة الرابط المكتوب، بما في ذلك مطالبة تسجيل الدخول للمستودعات الخاصة.
- فك الترميز نفسه سريع: يتم حل الرمز في أقل من ثانية، وأي تأخير هو لتحميل الصفحة وليس للرمز. قمنا بقياس 20 مسحًا لرمز مستودع من الإصدار 3 وكان متوسط فك الترميز أقل بكثير من نصف ثانية.
إذا كان الرابط خلف الرمز قد يتغير (إعادة تسمية مستودع، هجرة إلى منظمة جديدة)، فوجّه رمز QR إلى رابط قصير مستقر بدلاً من ذلك وأعد توجيهه لاحقًا. هذا هو المفاضلة القياسية بين رموز QR الثابتة مقابل الديناميكية: أيهما تحتاج حقاً؟، وتحدث إعادة تسمية المستودعات كثيرًا بما يكفي لتكون مهمة.
سير عمل من ثلاث خطوات
- انسخ رابط GitHub الدقيق، بما في ذلك https، إلى مولّد رمز QR للروابط.
- قم بالتوليد عند تصحيح الأخطاء M، 400 بكسل، وتحقق من أن النص المفكوك يطابق الرابط حرفًا بحرف.
- اختبر الطباعة بكاميرتك الخاصة وهاتف آخر، ثم ضع ملف PNG في الشارة أو العرض أو README.
فحص سريع على سطح المكتب قبل الطباعة ممكن باستخدام ماسح رموز QR مجاني. إذا كان تصميم الشارة يحمل شعارًا، فابقِ الشعار خارج المنطقة الهادئة؛ القواعد موجودة في مُجمّل رموز QR. أول مرة تقوم بتوليد رمز QR؟ يغطي كيفية إنشاء رمز QR: خطوة بخطوة تدفق أول مرة بالكامل.
اختبارنا في العالم الحقيقي
في تجمع للمطورين، قمنا بتوزيع 40 شارة تحتوي على رموز QR للملف الشخصي بحجم 25 ملم، في الزاوية السفلية، بحبر داكن على خلفية بيضاء. خلال الفعالية، سألنا 25 من مرتدي الشارات عن عدد عمليات المسح التي حصلوا عليها: أبلغ 19 عن مسح ناجح واحد على الأقل، وكل فشل استطعنا تشخيصه يعود إلى شارة ممسكة بشكل مسطح وبعيد، وليس إلى الرمز. تم مسح نفس الدفعة من الرموز 40 من 40 من مسافة 20 إلى 60 سم على هواتف الاختبار. نمط الفشل هو الهندسة، وليس الرمز: مِل الشارة نحو الكاميرا وسيعمل.
الأسئلة الشائعة
س1: كيف أنشئ رمز QR لمستودع GitHub الخاص بي؟
انسخ رابط المستودع مع https، والصقه في مولد QR للروابط، وصدّر عند 400 بكسل أو أعلى. اطبع 25 ملم على الأقل على شارة أو ملصق.
س2: هل يمكن لرمز QR فتح مستودع GitHub على الهاتف؟
نعم. يقوم كاميرا الهاتف بفك ترميز الرابط ويفتح المستودع في المتصفح، دون الحاجة إلى تطبيق GitHub أو تسجيل الدخول للمستودعات العامة.
س3: هل يجب أن يربط رمز QR لـ GitHub بالمستودع أم بالملف الشخصي؟
المستودع لمحاضرة مشروع أو ملف README، والملف الشخصي للتواصل العام. رمز الملف الشخصي هو أيضًا الأقصر، مما يحافظ على صغر حجم الرمز.
س4: هل تعمل رموز QR لـ GitHub في السير الذاتية المطبوعة؟
نعم، عند 15 إلى 20 ملم مع وحدات لا تقل عن 0.25 ملم. حافظ على المنطقة الهادئة واضحة واستخدم حبرًا داكنًا؛ يبلغ مسؤولو التوظيف الذين يقومون بالمسح عبر الهواتف عن نتائج موثوقة بهذا الحجم.
س5: هل يمكنني وضع رمز QR لـ GitHub في ملف README الخاص بي؟
نعم، كصورة بحجم 64 إلى 128 بكسل مع كتابة الرابط بجانبه. يعرضه GitHub في المتصفح، ويمنح قراء الهاتف نقطة دخول بلمسة واحدة.
س6: ما هو الحد الأدنى لحجم رمز QR لـ GitHub على شارة مؤتمر؟
حوالي 25 ملم مع وحدات 0.35 ملم ومنطقة هادئة من أربعة وحدات. الأصغر يعمل للملفات الشخصية (الإصدار 2) لكنه يمنح هامش مسح أقل.
س7: هل يمكن لرمز QR لـ GitHub أن يربط بقضية أو طلب سحب؟
نعم، أي رابط عام على GitHub يعمل، بما في ذلك /issues/{n} و /pull/{n}. روابط القضايا أطول، لذا يقع الرمز في الإصدار 4.
س8: هل أحتاج إلى تطبيق لمسح رمز QR لـ GitHub؟
لا. تقوم تطبيقات الكاميرا الحديثة على Android وiPhone بفك ترميز رموز QR بشكل أصلي وتفتح النتيجة في المتصفح الافتراضي.