Κοινή χρήση μέσω

Εγκατάσταση εργαλείων σύνταξης περιεχομένου

  • Άρθρο

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

  • Μακροσκελείς αναθεωρήσεις σε πολλά άρθρα
  • Δημιουργία νέου άρθρου
  • Εργαστείτε για τις οποίες θέλετε να χρησιμοποιήσετε τις διαθέσιμες επεκτάσεις του Visual Studio Code, όπως το Πακέτο σύνταξης του Learn.

Σημαντικό

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

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

Σε αυτό το άρθρο, θα κάνετε τα εξής:

  • Εγκατάσταση του Git
  • Εγκατάσταση του Visual Studio Code
  • Εγκατάσταση του Πακέτου σύνταξης του Learn

Εγκατάσταση εργαλείων προγράμματος-πελάτη Git για Windows

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

  1. Κάντε λήψη του Git για Windows.

  2. Εκτελέστε το αρχείο εκτελέσιμου αρχείου (.EXE) που λήφθηκε και ακολουθήστε τις υποδείξεις για εγκατάσταση. Επιλέξτε Επόμενο σε κάθε μήνυμα για να αποδεχτείτε όλες τις προεπιλεγμένες ρυθμίσεις.

  3. Επιλέξτε ένα πρόγραμμα επεξεργασίας κώδικα, όταν σας ζητηθεί. Το προεπιλεγμένο πρόγραμμα επεξεργασίας κώδικα είναι Vim.

  4. Επιλέξτε Τέλος για να ολοκληρώσετε την εγκατάσταση.

Μετά την εγκατάσταση του Git για Windows, ρυθμίστε το όνομα Git και τη διεύθυνση ηλεκτρονικού ταχυδρομείου σας.

Εγκατάσταση εργαλείων προγράμματος-πελάτη Git για Mac και Linux

  • Το Git για Mac παρέχεται ως μέρος των εργαλείων γραμμής εντολών Xcode. Απλώς εκτελέστε το git από τη γραμμή εντολών. Θα σας ζητηθεί να εγκαταστήσετε τα εργαλεία γραμμής εντολών, εάν χρειάζεται. Μπορείτε επίσης να κάνετε λήψη του Git για Mac από το Software Freedom Conservancy.
  • Git για Linux και Unix

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

Εγκατάσταση του Visual Studio Code

Το Visual Studio Code είναι ένα ελαφρύ πρόγραμμα επεξεργασίας που λειτουργεί σε Windows, Linux και Mac. Περιλαμβάνει ενοποίηση Git και υποστήριξη για επεκτάσεις.

Λήψη και εγκατάσταση του Visual Studio Code για το λειτουργικό σύστημά σας:

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

Φιλοδώρημα

Για να εκκινήσετε το VS Code και να ανοίξετε τον τρέχοντα φάκελο, εκτελέστε την εντολή code . στη γραμμή εντολών ή στο κέλυφος Bash. Εάν ο τρέχων φάκελος αποτελεί μέρος ενός τοπικού αποθετηρίου Git, η ενοποίηση GitHub εμφανίζεται αυτόματα στον κώδικα Visual Studio.

Εγκατάσταση του Learn Authoring Pack

Το Πακέτο σύνταξης του Learn για κώδικα Visual Studio περιλαμβάνει βασική βοήθεια σύνταξης Markdown, προεπισκοπήσεις σελίδων, υποστήριξη για πρότυπα Markdown, markdownlint και Code Spell Checker. Αυτές οι δυνατότητες διευκολύνουν και απλοποιούν τη διαδικασία συμβολής. Ως εκ τούτου, θεωρούμε το Πακέτο σύνταξης του Learn μια απαιτούμενη επέκταση για τους συμβάλλοντες.

Για να εγκαταστήσετε το Πακέτο σύνταξης του Learn, επιλέξτε Εγκατάσταση από τη σελίδα Learn Authoring Pack στο VS Code Marketplace.

Για να χρησιμοποιήσετε τη λειτουργικότητα Learn Authoring Pack, πατήστε Alt+M στο Visual Studio Code. Για να ρυθμίσετε τις παραμέτρους μιας γραμμής εργαλείων για να εμφανίσετε τις διαθέσιμες συναρτήσεις, επεξεργαστείτε τις ρυθμίσεις του Visual Studio Code (Control+κόμμα) και προσθέστε τη ρύθμιση "markdown.showToolbar": trueχρήστη .

Για περισσότερες πληροφορίες, ανατρέξτε στο θέμα Learn Authoring Pack για το Visual Studio Code.

Κατανόηση των προγραμμάτων επεξεργασίας Markdown

Το Markdown είναι μια ελαφριά γλώσσα σήμανσης που χρησιμοποιείται για τη σύνταξη του περιεχομένου. Το Visual Studio Code είναι το προτιμώμενο εργαλείο για την επεξεργασία Markdown στη Microsoft. Υπάρχουν διαθέσιμα και άλλα εργαλεία επεξεργασίας Markdown. Το άρθρο Αναφορά Markdown καλύπτει τα βασικά στοιχεία markdown και τις δυνατότητες που υποστηρίζονται από την learn.microsoft.com τοποθεσία Web.

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

Τώρα είστε έτοιμοι να δημιουργήσετε ένα τοπικό αποθετήριο δεδομένων Git.