Difference between revisions of "GitHub"

From Ελεύθερο Λογισμικό / Λογισμικό ανοιχτού κώδικα
Jump to navigation Jump to search
Line 2: Line 2:
  
 
__TOC__
 
__TOC__
 
== Writing in GitHub ==
 
 
To GitHub κάνει render συγκεκριμένα text αρχεία έτσι ώστε κάποιος να μπορεί να διαβάσει τα περιεχόμενα στον browser. Αρχεία τύπου doc,odt δεν τα κάνει render και θα πρέπει κάποιος πρώτα να τα κατεβάσει πριν τα διαβάσει.
 
 
Η πιο διαδεδομένη markup γλώσσα για γράψιμο στο GitHub είναι η markdown. Θα πρέπει τα αρχεία που ανεβαίνουν στο GitHub να έχουν κατάληξη <pre>.md</pre> ή <pre>.markdown</pre> ώστε το GitHub να το καταλάβει και να εμφανίσει το περιεχόμενο σωστά formatted, δηλαδή με επικεφαλίδες, bold, italic, κλπ.
 
 
Για το editing τέτοιων text αρχείων σε Windows προτείνεται η χρήση του [https://notepad-plus-plus.org/download/ notepadd++] ή του [https://github.com/atom/atom/releases/latest atom] τα οποία είναι και τα 2 ανοιχτού κώδικα.
 
 
Για μια εισαγωγή στη γλώσσα markdown διαβάστε το [https://guides.github.com/features/mastering-markdown/ Mastering Markdown].
 
 
Στην ατυχή περίπτωση που κάποιος χρησιμοποιεί Windows, είναι θεμιτό να μην ανεβάζει αρχεία '''docx''' στο GitHub μιας και είναι κλειστό format. Το Microsoft Office παρέχει τη δυνατότητα να κάνει export τα word αρχεία σε odt format. Διαβάστε [https://support.office.com/en-za/article/Use-Word-to-open-or-save-a-document-in-the-OpenDocument-Text-odt-format-20e5189f-86f8-4d8f-ae74-ea06b7df3b0e εδώ πώς θα το κάνετε].
 
 
Δείτε το [https://github.com/ellak-monades-aristeias/OpenDeskLab OpenDeskLab project] για να πάρετε μια ιδέα του πώς θα πρέπει να είναι τα έργα στο GitHub. Ιδανικά θα πρέπει να έχει 3 αρχεία: markdown, odt, pdf.
 
  
 
== Windows ==
 
== Windows ==
Line 62: Line 48:
 
# Αφού ολοκληρωθεί η προηγούμενη διαδικασία, πατήστε το κουμπί '''Publish''' πάνω δεξιά
 
# Αφού ολοκληρωθεί η προηγούμενη διαδικασία, πατήστε το κουμπί '''Publish''' πάνω δεξιά
 
# Πλέον οι αλλαγές έχουν ανέβει στο repository στο GitHub
 
# Πλέον οι αλλαγές έχουν ανέβει στο repository στο GitHub
 +
 +
== Writing in GitHub ==
 +
 +
To GitHub κάνει render συγκεκριμένα text αρχεία έτσι ώστε κάποιος να μπορεί να διαβάσει τα περιεχόμενα στον browser. Αρχεία τύπου doc,odt δεν τα κάνει render και θα πρέπει κάποιος πρώτα να τα κατεβάσει πριν τα διαβάσει.
 +
 +
Η πιο διαδεδομένη markup γλώσσα για γράψιμο στο GitHub είναι η markdown. Θα πρέπει τα αρχεία που ανεβαίνουν στο GitHub να έχουν κατάληξη <pre>.md</pre> ή <pre>.markdown</pre> ώστε το GitHub να το καταλάβει και να εμφανίσει το περιεχόμενο σωστά formatted, δηλαδή με επικεφαλίδες, bold, italic, κλπ.
 +
 +
Για το editing τέτοιων text αρχείων σε Windows προτείνεται η χρήση του [https://notepad-plus-plus.org/download/ notepadd++] ή του [https://github.com/atom/atom/releases/latest atom] τα οποία είναι και τα 2 ανοιχτού κώδικα.
 +
 +
Για μια εισαγωγή στη γλώσσα markdown διαβάστε το [https://guides.github.com/features/mastering-markdown/ Mastering Markdown].
 +
 +
Στην ατυχή περίπτωση που κάποιος χρησιμοποιεί Windows, είναι θεμιτό να μην ανεβάζει αρχεία '''docx''' στο GitHub μιας και είναι κλειστό format. Το Microsoft Office παρέχει τη δυνατότητα να κάνει export τα word αρχεία σε odt format. Διαβάστε [https://support.office.com/en-za/article/Use-Word-to-open-or-save-a-document-in-the-OpenDocument-Text-odt-format-20e5189f-86f8-4d8f-ae74-ea06b7df3b0e εδώ πώς θα το κάνετε].
 +
 +
Δείτε το [https://github.com/ellak-monades-aristeias/OpenDeskLab OpenDeskLab project] για να πάρετε μια ιδέα του πώς θα πρέπει να είναι τα έργα στο GitHub. Ιδανικά θα πρέπει να έχει 3 αρχεία: markdown, odt, pdf.
  
 
[[Κατηγορία:Οδηγοί]]
 
[[Κατηγορία:Οδηγοί]]

Revision as of 13:57, 13 November 2015

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

Windows[edit | edit source]

Το GitHub παρέχει μία εφαρμογή για τους χρήστες των Windows. Παρακάτω θα βρείτε συνοπτικά βήματα για να ξεκινήσετε.

Κατέβασμα και εγκατάσταση του GitHub Desktop[edit | edit source]

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

Authenticating to GitHub[edit | edit source]

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

Configuring Git for GitHub Desktop[edit | edit source]

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

Cloning your repository[edit | edit source]

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

Προσθήκη αρχείων[edit | edit source]

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

Sync με το GitHub[edit | edit source]

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

Writing in GitHub[edit | edit source]

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.