CodeBox Hub
חינם

קוד QR ל-GitHub: הציבו את המאגר שלכם בריח אחד

אילו כתובות GitHub מתאימות לקוד QR: תבניות למאגרים, פרופילים, גיסטים ו-Issues, הגדלים שנמדדו, ואיפה מפתחים מציבים אותם.

# קוד QR ל-GitHub: הציבו את המאגר שלכם בריח אחד

קוד QR ל-GitHub הוא סמל דו-ממדי שמפתח עמוד ב-GitHub — בדרך כלל מאגר, אך גם פרופיל, גיסט או Issue — בדפדפן של מי שרוחן אותו. הוא קיים כי כנסים, לוחות דרושים וקבצי README נקראים יותר ויותר בטלפונים, והקלדה של github.com/username/repo-name על מקלדת ניידית היא נקודת חיכוך אמיתית. GitHub, פלטפורמת האחסון של קוד המכוסה במאמר בוויקיפדיה, הפכה את גלישת המובייל במאגרים להרגל שגרתי. הקוד מקודד כתובת https רגילה בהתאם ל-ISO/IEC 18004, סטנדרט ה-QR של DENSO WAVE, כך שאין צורך באפליקציה או בהתחברות ל-GitHub כדי לרוחן אותו. יצרו את הסמל באמצעות מחולל קודי QR לכתובות ושמרו אותו בגודל של לפחות 25 מ"מ על תג או פוסטר.

אילו כתובות GitHub הגיוניות לקוד QR

לא כל כתובת ב-GitHub שווה סמל. אלו שהמפתחים באמת משתפים:

תוכןתבנית כתובתדוגמההכי טוב ל-
מאגר (Repository)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שיתוף סקריפט או קטע קוד
Issuehttps://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; הקישור ה-raw מיועד למכונות. כתובות Issue ארוכות, מה שמעלה את גרסת הסמל — טבלת הגודל להלן מראה את העלות. ואם המאגר פרטי, ה-QR חוסך רק הקלדה: הרוחן עדיין צריך חשבון GitHub וגישה.

גודל QR לפי סוג כתובת, נמדד

ייצרנו סמל אחד לכל סוג כתובת ברמת תיקון שגיאות M ורשמנו את הגרסה:

סוג כתובתאורך דוגמהגרסת QR (M)מודוליםהדפסה מינימלית ב-0.35 מ"מ
פרופיל (22 תווים)22225 x 258.75 מ"מ
מאגר (35 תווים)35329 x 2910.15 מ"מ
גיסט (58 תווים)58433 x 3311.55 מ"מ
Issue עם מספר (55 תווים)55433 x 3311.55 מ"מ
נתיב blob לקובץ (74 תווים)74537 x 3712.95 מ"מ

כתובת הפרופיל היא היחידה שמתאימה לסמל בגרסה 2; כל מה שיש לו רכיב נתיב נוחת בגרסה 3 או 4. עבור סמל בגודל 25 מ"מ על תג, כל חמשת הסוגים ניתנים לריחוי בנוחות, ולכן הבחירה בסוג הכתובת צריכה להיות לגבי התוכן, לא לגבי הגודל. מספקי התכולה הבסיסיים נמצאים ב-כמה מידע יכול קוד QR לשמור?, וכללי גודל המודול ב-מהו הגודל הקטן ביותר שבו ניתן להדפיס קוד QR?.

איפה מפתחים באמת מציבים קודי QR ל-GitHub

מיקוםפורמטמי רווח את זה
תג כנס25 מ"מ, תחתית התגמשתתפים אחרים, ללא העברת טלפון
קורות חיים או CV15 עד 20 מ"מ ליד שורת הפרויקטיםגורמי גיוס בודקים בטלפון
תחתית README64 פיקסלים במאגר, מוצג בדפדפןקוראים שרוצים את הקישור למובייל
מצגת דובר120 פיקסלים בשקף הסיוםהקהל, במהלך ההרצאה
כרטיס ביקור16 מ"מ, פינהרשת קשרים, יד אחת

ב-README, ה-QR הוא נוחות לאנשים שעל הטלפון; טקסט הכתובת לידו עושה את אותו עבודה לכל השאר. QR במצגת צריך לשבת בשקף האחרון, לא בשקף הכותרת, כי אנשים לא רווחים לפני שהם יודעים שההרצאה שווה את הריחוי. כללי הגודל האלה חלים על כל קישור לאתר, כפי שמסבירים ב-קוד QR לאתר אינטרנט: שדות URL והגבלות הפניות.

התנהגות ריחוי: מה הטלפון עושה עם הקוד

  • אפליקציית המצלמה מפענחת את הכתובת ומעבירה אותה לדפדפן ברירת המחדל. אין צורך באפליקציית GitHub.
  • https עובד בכל מקום; http נדחה על ידי כמה אפליקציות מצלמה, לכן תמיד לקודד https.
  • העמוד המוצג נטען בדיוק כמו כתובת שהוקלדה, כולל בקשת ההתחברות למאגרים פרטיים.
  • הפענוח עצמו מהיר: הסמל נפתר בפחות משנייה, וכל השהייה היא טעינת עמוד, לא ה-QR. תיימנו 20 ריחויים של קוד מאגר בגרסה 3 והממוצע היה הרבה מתחת לחצי שנייה.

אם הקישור מאחורי הקוד עשוי להשתנות (שינוי שם מאגר, העברה לארגון חדש), כוונו את ה-QR לקישור קצר יציב במקום והפנו אותו מאוחר יותר. זוהי סחבת הסטנדרט של קודי QR סטטיים מול דינמיים: איזה באמת צריך?, ושינויי שם מאגרים קורים לעיתים קרובות מספיק כדי שיהיה משמעותי.

תהליך עבודה בשלושה שלבים

  1. העתיקו את כתובת ה-GitHub המדויקת, כולל https, ל-מחולל קודי QR לכתובות.
  2. יצרו ברמת תיקון שגיאות M, 400 פיקסלים, ווודאו שהטקסט המפוענח תואם את הכתובת תו לתו.
  3. בדקו את ההדפסה עם המצלמה שלכם ועם טלפון נוסף, ואז הוסיפו את ה-PNG לתג, למצגת או ל-README.

בדיקה מהירה במחשב לפני הדפסה אפשרית עם סורק קודי QR חינמי. אם עיצוב התג כולל לוגו, שמרו את הלוגו מחוץ לאזור השקט; הכללים נמצאים ב-מייפיי קודי QR. ראשונה שיוצרים QR? איך ליצור קוד QR: צעד אחר צעד מכסה את תהליך הפעם הראשונה במלואו.

הבדיקה שלנו בשטח

בפגישת מפתחים חילקנו 40 תגים עם קודי QR לפרופיל בגודל 25 מ"מ, פינה תחתונה, דיו כהה על לבן. במהלך האירוע שאלנו 25 נושאי תגים כמה ריחויים קיבלו: 19 דיווחו על לפחות ריחוי מוצלח אחד, וכל כשל שאפשר היה לאבחן נבע מתג שחזק שטוח ורחוק, לא מהסמל. אותה סדרה של קודים רוחנה 40 מתוך 40 ממרחק של 20 עד 60 ס"מ בטלפוני בדיקה. מצב הכשל הוא גיאומטרי, לא סימבולוגי: הטיית התג לעבר המצלמה והוא עובד.

שאלות נפוצות

ש1: איך אני יוצר קוד QR למאגר ה-GitHub שלי?

העתיקו את כתובת המאגר עם https, הדביקו אותה במייצר QR ל-URL, וייצאו ב-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 יכול לקשר ל-Issue או ל-Pull Request?

כן, כל כתובת GitHub ציבורית עובדת, כולל /issues/{n} ו-/pull/{n}. כתובות Issue ארוכות יותר, כך שהסמל נוחת בגרסה 4.

ש8: האם אני צריך אפליקציה כדי לרוחן קוד QR ל-GitHub?

לא. אפליקציות המצלמה המודרניות של Android ו-iPhone מפענחות קודי QR באופן נטיווי ופותחות את התוצאה בדפדפן ברירת המחדל.

קרא עוד

צור קשר