Ρύθμιση ενός τοπικού αποθετηρίου Git για τεκμηρίωση

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

Θα εκτελέσετε αυτές τις δραστηριότητες μία φορά για να ξεκινήσετε τη συμβολή:

• Προσδιορίστε το κατάλληλο αποθετήριο δεδομένων.
• Διακλαδώσετε το αποθετήριο στον λογαριασμό σας GitHub.
• Επιλέξτε έναν τοπικό φάκελο για τα κλωνοποιημένα αρχεία.
• Κλωνοποιήστε το αποθετήριο στον τοπικό υπολογιστή σας.
• Ρυθμίστε τις παραμέτρους της απομακρυσμένης τιμής upstream.

Σημαντικό

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

Επισκόπηση

Για να συμβάλετε στην τεκμηρίωση για το Microsoft Learn, μπορείτε να δημιουργήσετε και να επεξεργαστείτε τοπικά αρχεία Markdown, κλωνοποιώντας το αποθετήριο της αντίστοιχης τεκμηρίωσης. Η Microsoft απαιτεί τη διακλάδωμα του κατάλληλου αποθετηρίου στον λογαριασμό σας GitHub, ώστε να έχετε δικαιώματα ανάγνωσης/εγγραφής για να αποθηκεύσετε τις προτεινόμενες αλλαγές. Στη συνέχεια, χρησιμοποιείτε αιτήματα έλξης (ΑΙΤΉΜΑΤα έλξης) για να συγχωνεύσετε τις αλλαγές στο κεντρικό κοινόχρηστο αποθετήριο μόνο για ανάγνωση.

Το αποθετήριο δεδομένων Microsoft αναφέρεται ως ανιατό αποθετήριο δεδομένων. Χρησιμοποιώντας την ενέργεια διακλάδωση στο περιβάλλον εργασίας χρήστη GitHub, ο χρήστης διακλαδώνει το αποθετήριο δεδομένων microsoft στον δικό του λογαριασμό GitHub. Αυτό το διακλάδωμα αναφέρεται ως Προέλευση. Χρησιμοποιώντας το git clone, ο χρήστης κλωνοποιεί την Προέλευση στον τοπικό υπολογιστή του. Τέλος, ο χρήστης χρησιμοποιεί απομακρυσμένη προσθήκη Git upstream για να συνδέσει τον τοπικό κλώνο του στο αποθετήριο upstream της Microsoft.

Προσδιορίστε το αποθετήριο δεδομένων

Η τεκμηρίωση που φιλοξενείται στο Microsoft Learn βρίσκεται σε διάφορα αποθετήρια στο GitHub.

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

   

2. Αυτή η ενέργεια σάς μεταφέρει στο αρχείο προέλευσης στο GitHub. Το όνομα του αποθετηρίου εμφανίζεται στην επάνω αριστερή γωνία της σελίδας.

   

   Δείτε ορισμένα δημοφιλή αποθετήρια που είναι διαθέσιμα για δημόσιες συνεισφορές:

   • Περιεχόμενο κοινότητας του Microsoft Learn https://github.com/MicrosoftDocs/community-content/
   • Τεκμηρίωση του Azure https://github.com/MicrosoftDocs/azure-docs
   • Τεκμηρίωση του SQL Server https://github.com/MicrosoftDocs/sql-docs
   • Τεκμηρίωση του Visual Studio https://github.com/MicrosoftDocs/visualstudio-docs
   • Τεκμηρίωση του .NET https://github.com/dotnet/docs
   • Τεκμηρίωση του Azure .NET SDK https://github.com/azure/azure-docs-sdk-dotnet
   • Τεκμηρίωση του ConfigMgr https://github.com/MicrosoftDocs/SCCMdocs

Διακλάδωση του αποθετηρίου

Αφού εντοπίσετε το σωστό αποθετήριο, το επόμενο βήμα είναι να δημιουργήσετε ένα αποθετήριο στον δικό σας λογαριασμό GitHub.

Για τη διακλάδωμα ενός αποθετηρίου σημαίνει ότι δημιουργείτε ένα αντίγραφό του στον λογαριασμό σας GitHub. Απαιτείται μια προσωπική διακλάδωσή, επειδή όλα τα αποθετήρια τεκμηρίωσης της Microsoft παρέχουν πρόσβαση μόνο για ανάγνωση, αλλά η διακλάδωσή σας σάς δίνει πρόσβαση εγγραφής για να κάνετε τις αλλαγές σας. Το διακλάδωση σάς επιτρέπει να ανοίγετε αιτήματα έλξης από τη διακλάδωση στο αποθετήριο δεδομένων της Microsoft.

1. Από τη σελίδα GitHub του κύριου αποθετηρίου, επιλέξτε το κουμπί Διακλάδωμα στην επάνω δεξιά γωνία.

   

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

   

Κλωνοποίηση του αποθετηρίου

Κλωνοποίηση σημαίνει δημιουργία αντιγράφου του αποθετηρίου στον τοπικό υπολογιστή σας.

Προειδοποίηση

1. ΜΗΝ κλωνοποιείτε τοπικά αποθετήρια δεδομένων σε φακέλους συγχρονισμένους στο OneDrive. Όταν επιλέγετε τον φάκελο στον οποίο θα κλωνοποιήσετε το αποθετήριο δεδομένων, αποφύγετε τους φακέλους που συγχρονίζονται με το OneDrive (για παράδειγμα, τον φάκελο Έγγραφα ). Το OneDrive μπορεί να προκαλέσει ακούσιες διενέξεις συγχώνευσης όταν συγχωνεύσετε τις αλλαγές σας ξανά στην κύρια διακλάδωση. Αντί για αυτό, είναι προτιμότερο να δημιουργήσετε μια σύντομη διαδρομή αρχείου στη C:\ μονάδα δίσκου (για παράδειγμα, C:\GitHub).

2. Git στα Windows: Ενεργοποίηση ονομάτων μεγάλων διαδρομών. Από προεπιλογή, το Git για Windows απενεργοποιεί την υποστήριξη για μεγάλες διαδρομές αρχείων, το οποίο αποτρέπει την κλωνοποίηση οποιουδήποτε αρχείου με διαδρομή προορισμού μεγαλύτερη από 255 χαρακτήρες. Ενεργοποιήστε μεγάλες προσαυξήσεις αρχείων για να αποφύγετε αυτό το πρόβλημα εκτελώντας την ακόλουθη εντολή ως διαχειριστής:
   git config --global core.longpaths true

1. Δημιουργήστε έναν GitHub φάκελο στον τοπικό υπολογιστή σας. Για παράδειγμα, C:\GitHub. (Μην κλωνοποιήσετε σε έναν συγχρονισμένο φάκελο του OneDrive.)

2. Σε ένα πρόγραμμα περιήγησης, μεταβείτε στην GitHub.com και πραγματοποιήστε είσοδο.

3. Στο GitHub στην επάνω δεξιά γωνία, από την αναπτυσσόμενη λίστα προφίλ σας, επιλέξτε Τα αποθετήρια δεδομένων σας. Η σελίδα αποθετηρίων εμφανίζεται με μια λίστα με τα διακλαδωμένα αποθετήρια δεδομένων σας.

4. Επιλέξτε το αποθετήριο που θέλετε να κλωνοποιήσετε. Εμφανίζεται η σελίδα αποθετηρίου δεδομένων Της διακλάδησής σας .

   Βεβαιωθείτε ότι βρίσκεστε στη σελίδα αποθετηρίου δεδομένων για τη διακλάδωση και όχι στη σελίδα για το αποθετήριο παραγωγής. Μπορείτε να επιβεβαιώσετε ότι το αποθετήριο στο οποίο βρίσκεστε είναι η διακλάδωσή σας, ελέγχοντας τη διεύθυνση URL: θα πρέπει να εμφανίζει το όνομα χρήστη σας GitHub, όχι τον οργανισμό της Microsoft (για παράδειγμα, https://github.com/nancydavolio/azure-docs και ΟΧΙ https://github.com/MicrosoftDocs/azure-docs). Επίσης, θα δείτε το όνομά σας στην επάνω αριστερή γωνία και θα δείτε μια σημείωση που αναφέρει Διακλαδωμένες από, ακολουθούμενη από το όνομα του κύριου αποθετηρίου δεδομένων.

   

5. Επιλέξτε την <> καρτέλα Κώδικας στην επάνω αριστερή γωνία της σελίδας.

6. Στη δεξιά πλευρά, από την αναπτυσσόμενη λίστα Κώδικας , αντιγράψτε τη διεύθυνση URL κάτω από την επιλογή HTTPS .

   

Σημαντικό

Αντιγράψατε τη διεύθυνση URL κλωνοποίησης μέσω του περιβάλλοντος εργασίας χρήστη του GitHub. Τα υπόλοιπα βήματα πρέπει να εκτελεστούν στο τερματικό VS Code.

Για κλωνοποίηση από το Visual Studio Code

1. Ανοίξτε το Visual Studio Code.

2. Από το επάνω μενού περιήγησης, επιλέξτε Προβολή και, στη συνέχεια, επιλέξτε Τερματικό. Η προβολή τερματικού εμφανίζεται στο κάτω μέρος της οθόνης του Visual Studio Code.

3. Στην προβολή Τερματικό, εκτελέστε την εντολή για να αλλάξετε τον κατάλογο (cd) στον GitHub φάκελο που δημιουργήσατε για αποθετήρια στη μονάδα δίσκου στο Βήμα 1 στην ενότητα Κλωνοποίηση αποθετηρίου δεδομένων.

   Παράδειγμα:

    cd C:\GitHub
   

   Εάν λάβετε ένα σφάλμα, ίσως χρειαστεί να αλλάξετε τον κατάλογο έναν φάκελο κάθε φορά.

4. Εκτελέστε την ακόλουθη εντολή για να κλωνοποιήσετε το αποθετήριο δεδομένων:

   git clone <paste the clone URL you copied via the GitHub UI>
   

   Για παράδειγμα:

   git clone https://github.com/nancydavolio/azure-docs.git
   

5. Όταν σας ζητηθεί να κάνετε έλεγχο ταυτότητας μέσω του προγράμματος περιήγησης, επιλέξτε το κουμπί "Είσοδος με το πρόγραμμα περιήγησής σας" και ολοκληρώστε τη διαδικασία. Φροντίστε να κάνετε λήψη της τελευταίας έκδοσης του Git, η οποία υποστηρίζει τον έλεγχο ταυτότητας μέσω της λειτουργικότητας του προγράμματος περιήγησης. Εάν επιλέξετε να χρησιμοποιήσετε ένα προσωπικό διακριτικό πρόσβασης GitHub, μπορείτε να δημιουργήσετε μία από τις παρακάτω οδηγίες: Δημιουργία προσωπικού διακριτικού πρόσβασης.

   Η εντολή κλωνοποίησης κάνει λήψη των αρχείων αποθετηρίου από τη διακλάδωση σε έναν νέο φάκελο, στη θέση που επιλέξατε στο Βήμα 3. Ένας νέος φάκελος δημιουργείται μέσα στον τρέχοντα φάκελο. Ίσως χρειαστούν μερικά λεπτά, ανάλογα με το μέγεθος του αποθετηρίου. Μπορείτε να εξερευνήσετε τον φάκελο για να δείτε τη δομή μόλις ολοκληρωθεί.

Ρύθμιση απομακρυσμένων

Αφού κλωνοποιήσετε το αποθετήριο, ρυθμίστε μια απομακρυσμένη σύνδεση μόνο για ανάγνωση στο κύριο αποθετήριο με το όνομα upstream. Τα απομακρυσμένα είναι ψευδώνυμα που αναφέρονται σε απομακρυσμένα αποθετήρια δεδομένων. Η προέλευση αναφέρεται στη διακλάδωσή σας και ως ανομοιότες αναφέρεται στο αποθετήριο παραγωγής. Το Git δημιούργησε αυτόματα το origin απομακρυσμένο όταν εκτελέσατε την clone εντολή. Μπορείτε να χρησιμοποιήσετε τη διεύθυνση URL upstream για να διατηρήσετε το τοπικό αποθετήριο συγχρονισμένο με τις πιο πρόσφατες αλλαγές που έγιναν από άλλους χρήστες.

Εκτελέστε τις ακόλουθες εντολές είτε στο Git Bash, είτε στο Τερματικό κώδικα VS.

1. Αλλάξτε τον κατάλογο (cd) στον φάκελο αποθετηρίου που δημιούργησε η clone εντολή. Για παράδειγμα:

   cd repo-name
   

2. Εκτελέστε την ακόλουθη εντολή για να προσθέσετε ένα απομακρυσμένο όνομα upstream που δείχνει στο αποθετήριο παραγωγής. Για παράδειγμα, η upstream διεύθυνση URL του αποθετηρίου είναι https://github.com/MicrosoftDocs/azure-docs.git αντί για https://github.com/nancydavolio/azure-docs.git.

   git remote add upstream <the clone URL of the main repo>
   

   Για παράδειγμα:

   git remote add upstream https://github.com/MicrosoftDocs/azure-docs.git
   

3. Εκτελέστε την ακόλουθη εντολή για να βεβαιωθείτε ότι τα απομακρυσμένα στοιχεία είναι σωστά:

   git remote -v
   

   Παράδειγμα εξόδου:

   origin  https://github.com/nancydavolio/azure-docs.git (fetch)
   origin  https://github.com/nancydavolio/azure-docs.git (push)
   upstream        https://github.com/MicrosoftDocs/azure-docs.git (fetch)
   upstream        https://github.com/MicrosoftDocs/azure-docs.git (push)
   

4. Εάν κάνατε κάποιο λάθος, καταργήστε το απομακρυσμένο και επαναλάβετε το βήμα για να το προσθέσετε. Για να καταργήσετε upstreamτο , εκτελέστε την εντολή:

   git remote remove upstream
   

Επόμενα βήματα

• Τώρα που έχετε ρυθμίσει τον τοπικό κλώνο σας, είναι ώρα να κάνετε σημαντικές αλλαγές.