Menginstal alat penulisan konten
Artikel ini menjelaskan cara menginstal alat yang direkomendasikan yang Anda butuhkan untuk membuat kontribusi mendalam atau besar yang efisien ke Microsoft Learn. Contoh pembaruan utama meliputi:
- Revisi yang panjang untuk beberapa artikel
- Membuat artikel baru
- Bekerjalah untuk ekstensi Visual Studio Code yang tersedia, seperti Learn Authoring Pack.
Penting
Jika Anda hanya membuat perubahan kecil, Anda tidak perlu menyelesaikan langkah-langkah dalam artikel ini. Lihat Mengedit di browser untuk mempelajari cara melakukan pengeditan cepat tanpa menginstal alat apa pun.
Kontributor yang akan membuat perubahan besar didorong untuk menyelesaikan langkah-langkah ini. Bahkan jika Anda memiliki izin tulis di repositori utama, kami sangat menyarankan (dan panduan ini mengasumsikan) bahwa Anda menempa dan mengkloning repositori dan menyimpan perubahan yang Anda usulkan di fork Anda.
Dalam artikel ini, Anda akan:
- Pasang Git
- Pasang Visual Studio Code.
- Menginstal Learn Authoring Pack
Menginstal alat klien Git untuk Windows
Penginstalan ini mencakup sistem kontrol versi Git dan Git Bash, aplikasi baris perintah yang Anda gunakan untuk berinteraksi dengan repositori Git lokal Anda.
Unduh Git untuk Windows.
Jalankan file executable (.EXE) yang diunduh dan ikuti perintah untuk menginstal. Pilih Berikutnya di setiap perintah untuk menerima semua pengaturan default.
Pilih editor kode, saat diminta. Editor kode default adalah Vim.
Pilih Selesai untuk menyelesaikan penginstalan.
Setelah menginstal Git untuk Windows, konfigurasikan nama Git dan alamat email Anda.
Menginstal alat klien Git untuk Mac dan Linux
- Git untuk Mac disediakan sebagai bagian dari Xcode Command Line Tools. Cukup jalankan
gitdari baris perintah. Anda akan diminta untuk menginstal alat baris perintah jika diperlukan. Anda juga dapat mengunduh Git untuk Mac dari Software Freedom Conservancy. - Git untuk Linux dan Unix
Ikuti instruksi untuk klien pilihan Anda untuk penginstalan dan konfigurasi.
Pasang Visual Studio Code.
Visual Studio Code adalah editor ringan yang berfungsi di Windows, Linux, dan Mac. Ini termasuk integrasi Git dan dukungan untuk ekstensi.
Unduh dan instal Visual Studio Code untuk sistem operasi Anda:
Selama penginstalan, terima semua pengaturan default.
Tip
Untuk meluncurkan VISUAL Code dan membuka folder saat ini, jalankan perintah code . di baris perintah atau shell Bash. Jika folder saat ini adalah bagian dari repositori Git lokal, integrasi GitHub muncul di Visual Studio Code secara otomatis.
Menginstal Learn Authoring Pack
Learn Authoring Pack for Visual Studio Code mencakup bantuan penulisan Markdown dasar, pratinjau halaman, dukungan untuk templat Markdown, markdownlint, dan Pemeriksa Ejaan Kode. Fitur-fitur ini memudahkan dan menyederhanakan proses kontribusi. Dengan demikian, kami menganggap Learn Authoring Pack ekstensi yang diperlukan untuk kontributor.
Untuk menginstal Learn Authoring Pack, pilih Instal dari halaman Learn Authoring Pack di Vs Code Marketplace.
Untuk menggunakan fungsionalitas Learn Authoring Pack, tekan Alt+M di Visual Studio Code. Untuk mengonfigurasi toolbar untuk menampilkan fungsi yang tersedia, edit pengaturan Visual Studio Code (Control+comma), dan tambahkan pengaturan "markdown.showToolbar": truepengguna .
Untuk informasi selengkapnya, lihat Pelajari Paket Penulisan untuk Visual Studio Code.
Memahami editor Markdown
Markdown adalah bahasa markup ringan yang digunakan untuk menulis konten. Visual Studio Code adalah alat pilihan untuk mengedit Markdown di Microsoft. Alat pengeditan Markdown lainnya tersedia. Artikel Referensi Markdown mencakup dasar-dasar Markdown dan fitur yang didukung oleh learn.microsoft.com situs web.
Langkah berikutnya
Sekarang Anda siap untuk Menyiapkan repositori Git lokal.