Rilis Baru Paket Penulisan Dokumen untuk Visual Studio Code
Postingan ini ditulis oleh Megan Bradley, Senior Program Manager di tim docs.microsoft.com.
Pada bulan April, kami mengumumkan rilis pertama Docs Authoring Pack untuk VS Code, yang mencakup ekstensi Docs Markdown, ekstensi untuk pratinjau pengeditan berdasarkan DocFX, serta markdownlint. Hari ini kami dengan senang hati mengumumkan rilis utama kedua dari Docs Authoring Pack, yang mencakup ekstensi baru berikut:
- Pemeriksa Ejaan Kode. Dengan permintaan populer, kami telah melengkapi pemeriksa ejaan offline ini oleh Street Side Software, sehingga kontributor dapat memeriksa semua konten mereka, termasuk sampel kode, tanpa harus melakukannya melalui layanan online.
- Templat Artikel Dokumen. Ekstensi ini memungkinkan Anda menerapkan templat Markdown ke file baru, sehingga lebih mudah untuk membuat konten dan metadata secara konsisten.
- Pratinjau Dokumen. Penggantian untuk pratinjau DocFx yang disertakan dalam rilis pertama Paket Penulisan Dokumen. Ekstensi pratinjau baru jauh lebih kuat dan mewakili docs.microsoft.com CSS dalam keakuratan yang lebih tinggi.
Anda dapat menginstal ekstensi satu per satu, melalui tautan di atas, atau dalam satu bundel, melalui Paket Penulisan Dokumen.
Templat artikel adalah file Markdown kerangka yang menyediakan judul standar, metadata file, teks boilerplate, dan elemen dasar lainnya yang mengikuti panduan docs.microsoft.com, membuat berkontribusi artikel baru lebih mudah dan menghilangkan tebakan dari persyaratan penerbitan!
Untuk membuat file baru berdasarkan templat keluar, cukup tekan Alt+M dan pilih Templat:
Mesin pratinjau berbasis DocFX sebelumnya diganti dengan Pratinjau Dokumen baru, yang menampilkan penyempurnaan berikut:
- Dukungan untuk pengurai Markdig yang mematuhi CommonMark, bukan Markdown (DFM) dengan rasa DocFx.
- CSS docs.microsoft.com terbaru, merender elemen Markdown kustom dengan keakuratan yang lebih tinggi.
- Peningkatan keandalan, membuat pratinjau menjadi lebih cepat dan tanpa jeda.
- Dukungan untuk daftar ekstensi Markdown khusus Docs yang terus berkembang, karena ekstensi tersebut tersedia.
Ekstensi Markdown Dokumen adalah sumber terbuka - kami menyambut kontribusi!
Perlu diingat bahwa sebagian besar kontribusi mengharuskan Anda menyetujui Perjanjian Lisensi Kontributor (CLA) yang menandakan bahwa Anda memiliki hak untuk, dan benar-benar melakukannya, memberi kami hak untuk menggunakan kontribusi Anda dalam perangkat lunak dan konten kami. Untuk detailnya, kunjungi https://cla.microsoft.com. Ketika Anda mengirimkan permintaan tarik, CLA-bot akan secara otomatis menentukan apakah Anda perlu memberikan CLA dan menghias PR dengan tepat (misalnya, label, komentar). Cukup ikuti instruksi yang diberikan oleh bot. Anda hanya perlu melakukan ini sekali di semua repositori milik Microsoft.
Pernahkah berpikir tentang bagaimana kita dapat membuat ekstensi lebih baik? Cukup buka masalah baru!
Dan jangan lupa untuk mengikuti akun Twitter kami untuk pembaruan terbaru.
Bermimpi membuat dunia lebih baik bagi pengembang? Bergabunglah dengan tim kami!