Πώς να δημοσιεύσετε μια σελίδα Github

Οι σελίδες Github επιτρέπουν στους προγραμματιστές να φιλοξενήσουν δωρεάν έναν στατικό ιστότοπο του έργου τους. Είναι μία από τις βασικές διευκολύνσεις της Github που έχει κάνει τη διατήρηση δωρεάν έργων ανοιχτού κώδικα πιο οικονομικά, ειδικά για τους ανεξάρτητους προγραμματιστές.

Το Bootstrap και το Normalize.css είναι μερικές δημοφιλείς σελίδες Github. Για να δημιουργήσετε ένα, χρειάζεται μόνο να δημιουργήσετε ένα νέο υποκατάστημα της αποθήκης έργου σας και να το καλέσετε gh-σελίδες. Δημοσιεύστε το υποκατάστημα στο Github.

Μόλις ολοκληρωθεί, ο ιστότοπος είναι προσβάσιμος μέσω της διεύθυνσης URL που έχει οριστεί σε σχέση με το όνομα χρήστη Github καθώς και το όνομα του αποθετηρίου. username .github.io / repository-name.

Μπορείτε να ορίσετε έναν προσαρμοσμένο τομέα για τη σελίδα σας Github. Έχουμε δείξει πώς να το πράξει στο προηγούμενο εκπαιδευτικό μας πρόγραμμα.

Σελίδες Github απλοποιημένες

Η δημιουργία μιας σελίδας Github είναι εύκολη και γρήγορη. Αλλά, υπάρχει μια μικρή προειδοποίηση.

Πάρτε ένα από τα demo αποθετήρια στο λογαριασμό μας Github, το Ημερολόγιο Advent, για παράδειγμα. Έχουμε δύο κλάδους - κύριος και gh-σελίδες τα οποία μοιράζονται το ίδιο ακριβώς των κλάδων κώδικα.

Πρέπει να βεβαιωθούμε ότι οι κώδικες στο gh-σελίδες συγχρονίζονται πάντα με το κύριος κλαδί.

Ευτυχώς, ο Github το κατέστησε πιο απλό με την κατάργησή του gh-σελίδες απαίτηση κλάδου. Τώρα μπορούμε να τροφοδοτήσουμε την τοποθεσία απευθείας μέσω του κύριος κλαδί.

Για να το κάνετε αυτό, μεταβείτε σε οποιεσδήποτε από τις οθόνες ρυθμίσεων του αποθετηρίου Github. Μετακινηθείτε προς τα κάτω στην ενότητα Σελίδες Github και επιλέξτε το κύριο υποκατάστημα από την επιλογή.

Όλοι είστε έτοιμοι και μπορείτε να το αφαιρέσετε με ασφάλεια gh-σελίδες από τον αποθετήριο.

Εξυπηρέτηση Τεκμηρίωσης

Ορισμένα έργα όπως Bootstrap, Foundation ή Skeleton απαιτούν μια σελίδα τεκμηρίωσης. Και οι προγραμματιστές τους συνήθως εξυπηρετούν αυτές τις σελίδες τεκμηρίωσης μέσω του gh-σελίδες έγγραφο.

Επομένως, ο χώρος αποθεματοποίησης έχει τώρα δύο υποκαταστήματα με ένα εντελώς διαφορετικό σύνολο κωδικών και σκοπών. ένα είναι το κύρια πηγή, ενώ το άλλο κεντρικές τεκμηρίωσης καθώς και ορισμένα αποσπάσματα κώδικα. Σε αυτή την περίπτωση, μπορεί να βρείτε συχνά συγκρούσεις αλλαγών κατά την εναλλαγή μεταξύ αυτών των δύο κλάδων.

Με αυτήν τη νέα αλλαγή από την Github, οι προγραμματιστές μπορούν τώρα να προβάλλουν σελίδες τεκμηρίωσης μέσω ενός ονόματος φακέλου / docs / μέσα στο κύριος κλαδί. Στη συνέχεια, μεταβείτε στις σελίδες Github και επιλέξτε την επόμενη επιλογή, φάκελο κύριου παραρτήματος / docs.

Τώρα, η διατήρηση του πηγαίου κώδικα και της τεκμηρίωσης έχει γίνει πιο σταθεροποιημένη.