Μετάβαση στο περιεχόμενο
Topos Uranos
Ελληνικά

Ομαδική συγγραφή

Περίληψη

Το μάθημα αυτό διδάσκει πώς γράφεται ένα έγγραφο από πολλούς συγγραφείς χωρίς να χάνεται δουλειά και χωρίς να μπερδεύονται οι εκδοχές. Εξηγεί γιατί η ανταλλαγή εκδοχών με ηλεκτρονικό ταχυδρομείο αποτυγχάνει και γιατί μια πηγή σε απλό κείμενο επιτρέπει να συγκρίνονται και να ενώνονται οι αλλαγές γραμμή προς γραμμή· παρουσιάζει το Overleaf ως κοινόχρηστο διαδικτυακό επεξεργαστή, με την πρόσκληση σε ένα έργο, την ταυτόχρονη επεξεργασία, τα σχόλια, την παρακολούθηση αλλαγών, το ιστορικό με τις επισημασμένες εκδοχές του, την επιλογή του LuaLaTeX και τη μεταφόρτωση ενός τοπικού έργου· διδάσκει την ελάχιστη ροή εργασίας του Git σε ένα έργο LaTeX, με το αρχείο .gitignore, τη γραφή μίας πρότασης ανά γραμμή και την επίλυση μιας σύγκρουσης σε ένα αρχείο .tex, με πραγματικές εξόδους από ένα δοκιμαστικό αποθετήριο· περιγράφει την ενοποίηση του Overleaf με το Git και τον συγχρονισμό του με το GitHub· συγκεντρώνει τις συμβάσεις που πρέπει να συμφωνήσει μια ομάδα· και κλείνει με το latexdiff, που παράγει ένα PDF με τις αλλαγές σημειωμένες ανάμεσα σε δύο εκδοχές.

Μαθησιακοί στόχοι

  1. Να εξηγεί γιατί μια πηγή σε απλό κείμενο επιτρέπει να συγκρίνεται και να ενώνεται η δουλειά πολλών συγγραφέων, και γιατί ένα αρχείο επεξεργαστή κειμένου δεν το επιτρέπει με τον ίδιο τρόπο.
  2. Να μοιράζεται ένα έργο του Overleaf με την κατάλληλη άδεια, να σχολιάζει, να αναθεωρεί με παρακολούθηση αλλαγών και να ανακτά μια προηγούμενη εκδοχή από το ιστορικό.
  3. Να διαχειρίζεται ένα έργο LaTeX με το Git: να δημιουργεί το αποθετήριο, να υποβάλλει αλλαγές, να διαβάζει το ιστορικό και τις διαφορές και να το συγχρονίζει με ένα απομακρυσμένο αποθετήριο.
  4. Να γράφει ένα .gitignore που αποκλείει τα βοηθητικά αρχεία χωρίς να αποκλείει ό,τι χρειάζεται το έγγραφο.
  5. Να προβλέπει πότε δύο ταυτόχρονες αλλαγές προκαλούν σύγκρουση και να την επιλύει σε ένα αρχείο .tex, ελέγχοντας έπειτα ότι το έγγραφο μεταγλωττίζεται και λέει ό,τι πρέπει.
  6. Να συμφωνεί σε ομάδα ένα κοινό προοίμιο, μια κοινή βιβλιογραφική βάση, έναν διαχωρισμό σε αρχεία και μια σύμβαση ετικετών, και να παράγει με το latexdiff ένα PDF που δείχνει τις αλλαγές ανάμεσα σε δύο εκδοχές.

Γιατί είναι δύσκολο να γράφουν πολλοί μαζί

Ο πιο συνηθισμένος τρόπος ομαδικής γραφής είναι και ο πιο εύθραυστος: ένας συγγραφέας στέλνει το αρχείο με ηλεκτρονικό ταχυδρομείο, ένας άλλος το διορθώνει και το επιστρέφει με νέο όνομα, και ύστερα από μερικές εβδομάδες ο φάκελος περιέχει έκθεση-τελική.docx, έκθεση-τελική-2.docx και έκθεση-τελική-διορθώσεις-άννας.docx. Αν δύο συγγραφείς δούλεψαν ταυτόχρονα πάνω στην ίδια εκδοχή, κάποιος πρέπει να μεταφέρει με το χέρι τις αλλαγές του ενός στο αρχείο του άλλου, και ό,τι ξεχαστεί σε αυτή τη μεταφορά χάνεται χωρίς να το αντιληφθεί κανείς. Ο επεξεργαστής κειμένου δεν βοηθά στη σύγκριση, επειδή το αρχείο του δεν είναι αναγνώσιμο κείμενο αλλά ένα συμπιεσμένο πακέτο που αναμειγνύει το περιεχόμενο με τη μορφοποίηση· έχει εργαλεία σύγκρισης, αλλά αυτά δεν επιτρέπουν να ενωθούν αυτόματα δύο ανεξάρτητες γραμμές εργασίας.

Μια πηγή LaTeX είναι κάτι άλλο: είναι απλό κείμενο, που οποιοδήποτε πρόγραμμα μπορεί να διαβάσει γραμμή προς γραμμή. Από αυτό προκύπτουν δύο λειτουργίες που με έναν επεξεργαστή κειμένου δεν είναι διαθέσιμες. Η πρώτη είναι η διαφορά (στα αγγλικά diff): δεδομένων δύο εκδοχών ενός αρχείου, ένα πρόγραμμα λέει ακριβώς ποιες γραμμές αφαιρέθηκαν και ποιες προστέθηκαν. Η δεύτερη είναι η συγχώνευση (στα αγγλικά merge): δεδομένων δύο συνόλων αλλαγών πάνω στην ίδια εκδοχή, ένα πρόγραμμα τα συνδυάζει μόνο του όταν αφορούν διαφορετικά σημεία του αρχείου, και ζητά από τον συγγραφέα να παρέμβει μόνο όταν και οι δύο άγγιξαν το ίδιο σημείο. Ωστόσο, για να είναι χρήσιμες αυτές οι λειτουργίες χρειάζεται επιπλέον μια οργάνωση: ένας κοινός τόπος όπου βρίσκεται η ισχύουσα εκδοχή και ένα αρχείο του ποιος άλλαξε τι και πότε. Το μάθημα αυτό παρουσιάζει τους δύο τρόπους με τους οποίους την εξασφαλίζει ο κύκλος μαθημάτων: το Overleaf, που λύνει το πρόβλημα στον περιηγητή, και το Git, που το λύνει στον υπολογιστή κάθε συγγραφέα, με επεξεργαστή το Texmaker.