כיצד לפרסם דף Github

Github דפים לאפשר למפתחים לארח אתר סטטי של הפרויקט שלהם בחינם. זהו אחד מתקני המפתח של Github כי הפכה שמירה על פרויקטים קוד פתוח חינם חסכוני במיוחד עבור מפתחי אינדי.

Bootstrap ו Normalize.css הם כמה דפי Github הפופולרי. כדי ליצור אחד, אתה רק צריך ליצור סניף חדש של מאגר הפרוייקט שלך, ולקרוא את זה דפי גה. פרסם את הסניף לגיתוב.

ברגע שזה נגמר, האתר נגיש באמצעות כתובת האתר אשר נקבעת יחסית שם המשתמש שלך Github, כמו גם את שם המאגר. username .github.io / repository-name.

ניתן להגדיר דומיין מותאם אישית עבור דף Github שלך. הראינו את זה איך לעשות זאת במדריך הקודם שלנו.

דפי Github מפושטים

יצירת דף Github היא קלה ומהירה. אבל, יש אזהרה קטנה.

קח את אחד המאגרים הדגמה בחשבון Github שלנו, Advent לוח שנה, למשל. יש לנו שני סניפים - מאסטר ו דפי גה אשר חולקים בדיוק את אותו קוד של סניפים.

אנחנו צריכים לוודא את הקודים דפי גה מסונכרנים תמיד עם מאסטר ענף.

למרבה המזל, Github לאחרונה עשה את זה פשוט יותר על ידי הסרת דפי גה דרישת הסניף. עכשיו אנחנו יכולים עכשיו להאכיל את האתר ישירות דרך מאסטר ענף.

לשם כך, עבור אל מסך ההגדרות של מאגר Github. גלול מטה אל הקטע Github Pages ובחר את - סניף ראשי מהתפריט.

אתה כל להגדיר והוא יכול בבטחה להסיר את דפי גה סניף מהמאגר.

הגשת תיעוד

כמה פרויקטים כגון Bootstrap, קרן, או שלד דורשים דף תיעוד. מפתחי שלהם בדרך כלל גם לשרת את דפי תיעוד אלה דרך דפי גה מסמך.

אז במאגר יש עכשיו שני סניפים עם קבוצה שונה לחלוטין של קודים ותכלית; אחד הוא מקור עיקרי, בעוד השני תיעוד המארח וגם כמה קטעי קוד. במצב זה, לעתים קרובות אתה יכול למצוא התנגשויות שינוי בעת המעבר בין שני הענפים.

עם שינוי חדש זה מ- Github, מפתחים יכולים כעת להציג דפי תיעוד באמצעות שם תיקייה / docs / בתוך ה מאסטר ענף. לאחר מכן, עבור אל דפי Github ובחר באפשרות הבאה, סניף ראשי / תיקיית מסמכים.

עכשיו, שמירה על קוד המקור ותיעוד הפך stremalined יותר.