GitHub

Προϋπόθεση για τα παρακάτω είναι να έχετε ενεργό λογαριασμό στο GitHub.

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 προσθέστε τα αρχεία που θέλετε (doc, pdf, txt, etc.)
2. Πηγαίνοντας τώρα ξανά στην εφαρμογή θα δείτε τις αλλαγές (uncommited changes)
3. Στο Summary γράψτε ένα περιγραφικό μήνυμα του τί αλλαγές κάνατε, πχ Upload images
4. Πατήστε Commit to master

Sync με το GitHub

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

Writing in 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. Διαβάστε εδώ πώς θα το κάνετε.

Δείτε το OpenDeskLab project για να πάρετε μια ιδέα του πώς θα πρέπει να είναι τα έργα στο GitHub. Ιδανικά θα πρέπει να έχει 3 αρχεία: markdown, odt, pdf.