Οδηγίες δημιουργίας αποθετηρίου στο Github

Αρχικά θα πρέπει να δημιουργήσετε ένα λογαριασμό στο github(δείτε για ενημέρωση σχετικά με το git το http://git-class.gr/), κατά προτίμηση με όνομα έργου στο οποίο να αναφέρεται το όνομα του σχολείου ή του έργου σας(π.χ 5gymnLamias ή learn2bot).  Εκπαιδευτικά προτείνετε όλα τα μέλη της ομάδας σας να δημιουργήσουν λογαριασμό στο github και να είναι μέλη( Contributors ) του έργου σας, πχ https://github.com/itminedu/ToolKit-Mature-OpenSource .

Δημιουργία λογαριασμού

https://github.com/join

  • Και να δημιουργήσετε ένα αποθετήριο με το όνομα του έργου σας ή του σχολείου σας.
  • Μόλις δημιουργήσετε το αποθετήριο, θα πρέπει να γράψετε την περιγραφή του έργου σας στο Readme.md. Αν δεν έχετε κάτι έτοιμο παραλείψετε το βήμα (ή γράψτε κάτι σαν “Αποθετήριο του σχολείου Χ για στην συμμετοχή στον Διαγωνισμό Ρομποτικής Ανοιχτών Τεχνολογιών”.  Στην επεξεργασία του readme.md μπορείτε να επανέλθετε αργότερα (και είναι μια από τις πιο σημαντικές σελίδες του github σας, μιας και εκεί θα πρέπει να υπάρχει αναλυτική περιγραφή του έργου σας και όλων των βημάτων που ακολουθήθηκαν).
  • Το Αποθετήριο σας θα έχει δημιουργηθεί, και αυτό θα είναι το αποθετήριο που θα πρέπει να ανεβάσετε, όλα τα σχέδια, τον κώδικα και την τεκμηρίωση του έργου σας.

Πως θα πρέπει να είναι το αποθετήριο μου? Υπάρχει κάποιο πρότυπο?

Το αποθετήριο σας θα πρέπει να είναι εύκολο στην ανάγνωση και στην πλοήγηση από κάποιον τρίτο. Δεν είναι απλά ένας φάκελος που θα ρίξετε εκεί όλα τα σχετικά αρχεία.

Θα πρέπει να έχει συγκεκριμένη δομή (ανάλογα με το έργο σας )

Ένα παράδειγμα μπορείτε να δείτε εδώ

 

Πως να ρυθμίσετε τον υπολογιστή σας για να ανεβάσετε τα αρχεία στο αποθετήριο σας

Λήψη και Εγκατάσταση του git

Εγκατάσταση σε Linux

Για διανομές βασισμένες σε Debian(όπως το ubuntu)

sudo apt-get install git-core

ενώ, για διανομές βασισμένες σε Fedora

yum install git-core

TIP: Με την εντολή sudo aptitude search git εμφανίζονται πακέτα που σχετίζονται με το git.

 

Οι πρώτες Ρυθμίσεις

Στην εφαρμογή του git που εγκαταστήσατε στον υπολογιστή σας θα πρέπει να κάνετε κάποιες ρυθμίσεις, δηλώνοντας το όνομα σας και το email σας

Πληκτρολογήστε (‘η αντιγράψτε τις παρακάτω εντολές – αντικαθιστώντας τα Your Name και τα email@provider.com

git config –global user.name «Your Name”

git config –global user.email «email@provide.com”

Για email χρησιμοποιείστε τη διεύθυνση που δώσατε στο GitHub

Δημιουργία τοπικού αποθετηρίου στον υπολογιστή σας

Για να αντιγράψουμε το project από το github στο δίσκο μας εκτελούμε:

git clone https://github.com/username/onomaergou

με το όνομα του repository της ομάδας σας

Έτσι λοιπόν θα δημιουργηθεί ένας κατάλογος onomaergou στον σκληρό σας.

Ο κατάλογος αυτός είναι ο κατάλογος στον οποίο θα εργάζεστε και θα βάζετε τα αρχεία για κοινή χρήση στο github

Βασικές εντολές που πρέπει να γνωρίζετε

1) git-add

Προσθέτει το περιεχόμενο του αρχείου και το ετοιμάζει για να γίνει το επόμενο commit. Είναι και η πρώτη εντολή που θα πληκτρολογήσετε

Χρήση εντολής

git add <filenames>

πχ git add readme.txt

 

2) git commit

Η εντολή git commit ξεκινά έναν editor ώστε να γράψετε ένα σύντομο κείμενο που να εξηγεί τι περιλαμβάνει το commit

– εναλλακτικά:

πληκτρολογήστε

git commit -­‐m “το μήνυμα σας (p.x add initial plan for myproject)”

Τα κείμενα αυτά είναι σημαντικά

– πρέπει να μπορεί κανείς να καταλαβαίνει τι κάνατε (και γιατί)

– φανταστείτε ότι το γράφετε για κάποιον άλλο

 

3) git push

Με αυτή την εντολή ανεβάζετε οριστικά στο github τα αρχεία τα οποία κάνατε add και commit.

 

4) git-status

Περιγραφή: Εμφανίζει την κατάσταση του καταλόγου σας (ποια αρχεία ειναι ήδη στο Github, ποια αρχεία έχουν αλλάξει και ποια είναι εντελώς καινούργια και πρέπει να προστεθούν (add).

 

5) git-diff

Περιγραφή: Εμφανίζει διαφορές στα commit που έχουν γίνει και στο github

Περισσότερες πληροφορίες

Μια γρήγορη αναφορά για τις βασικές εντολές στο github (pdf)

Αναλυτική βοήθεια για την χρήση του github https://help.github.com/

 

Εγκατάσταση σε Windows

Η εγκατάσταση στα windows είναι πολύ εύκολη! Κατεβάστε από τον σύνδεσμο

https://git-scm.com/download/win το εκτελέσιμο αρχείο και τρέξτε το. Μόλις γίνει η

εγκατάσταση θα πρέπει να έχετε ένα πρόγραμμα Git Bash, σαν ένα απλό κέλυφος όπου

μπορείτε να εκτελείτε εντολές σχετικά με το git.

Για windows υπάρχει ακόμα ένα γραφικό περιβάλλον χρήσης  που πιθανώς να σας ειναι πιο εύκολο μιας και το GitHub παρέχει μία εφαρμογή για τους χρήστες των Windows. Παρακάτω θα βρείτε συνοπτικά βήματα για να ξεκινήσετε.

Κατέβασμα και εγκατάσταση του GitHub Desktop

  1. Πηγαίνετε στη σελίδα https://desktop.github.com/
  2. Επιλέξτε Download for Windows
  3. Αποθηκεύστε το αρχείο και μόλις κατέβει τρέξτε το με διπλό κλικ
  4. Επιλέξτε Run και μετά Install

Authenticating to GitHub

  1. Πάνω δεξιά κάντε κλικ στο εικονίδιο με το γρανάζι
  2. Επιλέξτε Options
  3. Κάτω από το Accounts, πατήστε Add account
  4. Κάτω από το Log in, επιλέξτε GitHub
  5. Συμπληρώστε το username και το password και πατήστε Log in

Configuring Git for GitHub Desktop

  1. Στην πάνω δεξιά γωνία πατήστε στο γρανάζι
  2. Επιλέξτε Options
  3. Κάτω από το Configure Git, στο πεδίο Full name, γράψτε το όνομα που θέλετε να χρησιμοποιηθεί για το Git configuration. Μπορεί να είναι απλά το username σας ή το full όνομα με λατινικούς χαρακτήρες
  4. Στο πεδίο Email, γράψτε το email με το οποίο εγγραφήκατε στο GitHub

Cloning your repository

  1. Στην πάνω αριστερή γωνία κάντε κλικ στο σύμβολο +
  2. Επιλέξτε Clone
  3. Πατήστε πάνω στο username σας και μετά στο repository που θέλετε να κάνετε clone
  4. Πατήστε στο Clone your_repo_name, όπου your_repo_name το repository σας
  5. Αν σας ζητηθεί η τοποθεσία όπου θα αποθηκευτεί πατήστε απλά ΟΚ ή επιλέξτε μια τοποθεσία που εσείς θέλετε

Προσθήκη αρχείων

  1. Στο φάκελο του υπολογιστή σας όπου αποθηκεύτηκε το repository προσθέστε τα αρχεία που θέλετε Πηγαίνοντας τώρα ξανά στην εφαρμογή θα δείτε τις αλλαγές (uncommited changes)
  2. Στο Summary γράψτε ένα περιγραφικό μήνυμα του τί αλλαγές κάνατε, πχ Upload images
  3. Πατήστε Commit to master

Sync με το GitHub

  1. Αφού ολοκληρωθεί η προηγούμενη διαδικασία, πατήστε το κουμπί Publish πάνω δεξιά
  2. Πλέον οι αλλαγές έχουν ανέβει στο repository στο GitHub

 

Γράφοντας στο GitHub

To GitHub κάνει render συγκεκριμένα text αρχεία έτσι ώστε κάποιος να μπορεί να διαβάσει τα περιεχόμενα στον browser. Αρχεία τύπου doc,odt δεν τα κάνει render και θα πρέπει κάποιος πρώτα να τα κατεβάσει πριν τα διαβάσει. Η πιο διαδεδομένη markup γλώσσα για γράψιμο στο GitHub είναι η markdown. Θα πρέπει τα αρχεία που ανεβαίνουν στο GitHub να έχουν κατάληξη .md ή markdown ώστε το GitHub να το καταλάβει και να εμφανίσει το περιεχόμενο σωστά formatted, δηλαδή με επικεφαλίδες, bold, italic, κλπ.

Για το editing τέτοιων text αρχείων σε Windows προτείνεται η χρήση του notepadd++ ή του atom τα οποία είναι και τα 2 ανοιχτού κώδικα.

Για μια εισαγωγή στη γλώσσα markdown διαβάστε το Mastering Markdown.

Στην ατυχή περίπτωση που κάποιος χρησιμοποιεί Windows, είναι θεμιτό να μην ανεβάζει αρχεία docx στο GitHub μιας και είναι κλειστό format. Το Microsoft Office παρέχει τη δυνατότητα να κάνει export τα word αρχεία σε odt format. Διαβάστε εδώ πώς θα το κάνετε.

 

Εγκατάσταση σε Mac OS:

https://git-scm.com/download/mac

Τι είναι το git;

Tο git είναι ένα σύστημα διαχείρισης εκδόσεων αρχείων

– Στα Αγγλικά: version control system

– Παρακολουθεί τις αλλαγές σε ένα σύνολο αρχείων κρατώντας στιγμιότυπά τους

– Το σύνολο στιγμιοτύπων ονομάζεται αποθετήριο ( repository)

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

Η σχεδιαστική φιλοσοφία αντικατοπτρίζεται στην κοινή φιλοσοφία χρήσης:

  • Commit νωρίς και συχνά,
  • κάθε commit αντιπροσωπεύει μία ιδέα ή μια ολόκληρη αλλαγή ( και έτσι είναι ευκολότερη η ανάγνωση και η επαναφορά σε προηγούμενη έκδοση)
  • Κάθε branch αντιπροσωπεύει ένα χαρακτηριστικό (ή θέμα) ( και έτσι είναι ευκολότερη η ανάγνωση και η συγχώνευση) την τοπική σας κατάλογο εργασίας, και ο δείκτης των τοπικών συμφωνιών επαναφοράς είναι τακάκια το μηδέν.

Χρήσεις του git:

– συμμετοχή σε κοινά έργα, και έργα ανοικτού λογισμικού

– επιστροφή σε μια παλιότερη έκδοση αν έχει γίνει κάποιο λάθος

– δοκιμή παραλλαγών (ονομάζονται παρακλάδια -­‐ branches) χωρίς να επηρεάζεται η τρέχουσα κατάσταση των αρχείων

Περισσότερα για το git μπορείτε να διαβάσετε εδώ.