Visual Studio Code için Yazma Paketini Öğrenme

Learn Yazma Paketi, Microsoft Learn içeriği için Markdown yazma işlemine yardımcı olan bir Visual Studio Code uzantıları koleksiyonudur. Paketi VS Code Marketi’nde mevcuttur ve şu uzantıları barındırır:

Önkoşullar ve varsayımlar

Learn Markdown uzantısıyla göreli bağlantılar, görüntüler ve diğer ekli içerik eklemek için VS Code çalışma alanınızın kapsamı kopyalanmış Açık Yayımlama Sistemi (OPS) deponuzun köküne göre belirlenmiş olmalıdır. Örneğin, docs deposunu C:\git\SomeDocsRepo\olarak kopyaladıysanız, vs Code: Dosya>Klasör Aç menüsünde veya komut satırından bu klasörü veya code C:\git\SomeDocsRepo\ alt klasörü açın.

Uzantı tarafından desteklenen uyarılar ve kod parçacıkları gibi bazı söz dizimi öğeleri, OPS için özel Markdown’dır. Özel Markdown, OPS yoluyla yayımlanmadığı sürece doğru işlenmez.

Learn Markdown uzantısını kullanma

Learn Markdown menüsüne erişmek için Alt+M yazın. İstediğiniz komutu seçmek için tıklayabilir veya yukarı ve aşağı okları kullanabilirsiniz. İsterseniz yazmaya başlayarak sonuçları filtreleyebilir ve istediğiniz işlev menüde vurgulandığında ENTER tuşuna basabilirsiniz.

Güncel komut listesi için Bkz. Learn Markdown benioku.

Ana yeniden yönlendirme dosyası oluşturma

Learn Markdown uzantısı, tek tek dosyalardaki meta verileri temel alarak bir depo için ana yeniden yönlendirme dosyası oluşturmaya veya güncelleştirmeye redirect_url yönelik bir betik içerir. Bu betik, deposundaki redirect_urlher Markdown dosyasını denetler ve yeniden yönlendirme meta verilerini deponun ana yeniden yönlendirme dosyasına (.openpublishing.redirection.json) ekler ve yeniden yönlendirilen dosyaları depo dışındaki bir klasöre taşır. Betiği çalıştırmak için:

1. VS Code komut paletini açmak için F1 tuşuna basın.
2. "Learn: Generate..." yazmaya başlayın
3. Learn: Generate main redirection file komutunu seçin.
4. Betiğin çalışması tamamlandığında, yeniden yönlendirme sonuçları VS Code çıkış bölmesinde gösterilir ve kaldırılan Markdown dosyaları varsayılan yolunuz altındaki Learn Authoring\redirects klasörüne eklenir.
5. Sonuçları inceleyin. Beklediğiniz gibiyse depoyu güncelleştirmek için bir çekme isteği gönderin.

Klavye kısayolları atama

1. Klavye Kısayolları listesini açmak için Ctrl+K ve Ctrl+S yazın.

2. Özel tuş bağlaması oluşturmak istediğiniz komutu aratın, örneğin formatBold.

3. Fare imlecinizle satırın üzerine geldiğinizde komutun yanında beliren artı işaretine tıklayın.

4. Giriş kutusu göründüğünde, bu komuta bağlamak istediğiniz klavye kısayolunu girin. Örneğin, kalın için ortak kısayolu kullanmak için Ctrl+B yazın.

5. Tuş bağlamanıza when yan tümcesini eklemek iyi bir fikir olabilir, böylece bu kısayol Markdown dışındaki dosyalarda geçerli olmayacaktır. Bunu yapmak için keybindings.json dosyasını açın ve komut adı altındaki şu satırı girin (satırlar arasına virgül koyduğunuzdan emin olun):

   "when": "editorTextFocus && editorLangId == 'markdown'"
   

   Tamamlanmış özel tuş bağlamanız, keybindings.json dosyasında şu şekilde görünmelidir:

   [
       {
           "key": "ctrl+b",
           "command": "formatBold",
           "when": "editorTextFocus && editorLangId == 'markdown'"
       }
   ]
   

   Bahşiş

   Varsayılan değerlerin üzerine yazmak için tuş bağlamalarınızı bu dosyaya yerleştirin.

6. keybindings.json dosyasını kaydedin.

Tuş bağlamaları hakkında daha fazla bilgi için VS Code belgelerine bakın.

Eski “Gauntlet” araç çubuğunu gösterme

"Gauntlet" adlı uzantı kodunun eski kullanıcıları Learn Markdown Uzantısı yüklendiğinde yazma araç çubuğunun artık VS Code penceresinin altında görünmediğini fark eder. Bu araç çubuğu, VS Code durum çubuğunda geniş yer kapladığı ve uzantı UX’i için en iyi deneyimleri izlemediği için yeni uzantıda devre dışı bırakılmıştır. Ancak dilerseniz settings.json dosyasında VS Code ayarlarınızı aşağıdaki gibi güncelleştirerek bu araç çubuğunu tekrar gösterebilirsiniz:

1. VS Code'da Dosya>Tercihleri'ne> gidin Ayarlar veya Ctrl+ tuşunu seçin.

2. Ayarları tüm VS Code çalışma alanları için değiştirmek istiyorsanız Kullanıcı Ayarları’nı, yalnızca geçerli çalışma alanı için değiştirmek istiyorsanız Çalışma Alanı Ayarları’nı seçin.

3. Uzantılar>Learn Markdown Uzantısı Yapılandırması'nı seçin ve ardından alt durum çubuğunda Eski araç çubuğunu göster'i seçin.

   

Seçiminizi yaptıktan sonra VS Code, settings.json dosyasını güncelleştirir. Değişikliklerin etkili olması için pencereyi yeniden yüklemeniz istenir.

Uzantıya eklenen yeni komutlar araç çubuğundan kullanılamaz.

Learn şablonlarını kullanma

Learn Makale Şablonları uzantısı, VS Code'daki yazarların merkezi bir mağazadan Markdown şablonu çekmesine ve bunu bir dosyaya uygulamasına olanak tanır. Şablonlar makalelere gerekli meta verilerin eklenmesi ve içerik standartlarına uygun hareket edilmesi gibi konulardan emin olmanıza yardımcı olabilir. Şablonlar, genel bir GitHub deposunda Markdown dosyaları olarak yönetilir.

VS Code'da şablon uygulama

1. Learn Makale Şablonları uzantısının yüklendiğinden ve etkinleştirildiğinden emin olun.
2. Learn Markdown uzantısı yüklü değilse, komut paletini açmak için F1'e tıklayın, filtrelemek için "şablon" yazmaya başlayın ve ardından öğesine tıklayınLearn: Template. Learn Markdown yüklüyse komut paletini kullanabilir veya Alt+M'ye tıklayarak Learn Markdown QuickPick menüsünü açıp listeden seçim yapabilirsiniz.Template
3. Açılan listeden istenen şablonu seçin.

GitHub kimliğinizi ve/veya Microsoft diğer adınızı VS Code ayarlarınıza ekleme

Templates uzantısı, üç dinamik meta veri alanını destekler: author, ms.author ve ms.date. Bu da şablon oluşturan bir kullanıcının bu alanları bir Markdown şablonunun meta veri başlığında kullanması durumunda bu değerlerin şablonu uyguladığınızda aşağıdaki şekilde dosyanıza otomatik olarak ekleneceği anlamına gelir:

author ve/veya ms.author değerlerini ayarlama

1. VS Code'da Dosya>Tercihleri'ne> gidin Ayarlar veya Ctrl+ tuşunu seçin.
2. Ayarları tüm VS Code çalışma alanları için değiştirmek istiyorsanız Kullanıcı ayarlarını, yalnızca geçerli çalışma alanı için değiştirmek istiyorsanız Çalışma Alanı ayarlarını seçin.
3. Soldaki Varsayılan Ayarlar bölmesinde, Learn Makale Şablonları Uzantısı Yapılandırması'nı bulun, istediğiniz ayarın yanındaki kalem simgesine tıklayın ve ardından Ayarlar Değiştir'e tıklayın.
4. Kullanıcı ayarları bölmesi yan tarafta açılır ve en altta yeni bir giriş gösterilir.
5. GitHub kimliğinizi veya Microsoft e-posta diğer adınızı ekleyin ve dosyayı kaydedin.
6. Değişikliklerin geçerli olması için VS Code uygulamasını kapatıp yeniden başlatmanız gerekebilir.
7. Artık dinamik alanları kullanan bir şablon uyguladığınızda GitHub kimliğiniz ve/veya Microsoft takma adınız meta veri başlığına otomatik olarak eklenecek.

Yeni bir şablonu VS Code'da kullanılabilir duruma getirmek için

1. Şablonunuzdan bir Markdown dosyası taslağı oluşturun.
2. MicrosoftDocs/content-templates deposunun templates klasörüne bir çekme isteği gönderin.

İçerik ekibi şablonunuzu gözden geçirir ve stil yönergelerini karşılıyorsa çekme isteğini birleştirir. Birleştirildikten sonra şablon, Learn Makale Şablonları uzantısının tüm kullanıcılarına sunulacaktır.

Farklı özelliklerin tanıtımı

Learn Yazma Paketi'nin aşağıdaki özelliklerini gösteren kısa bir video aşağıdadır:

• YAML dosyaları
  • "Learn: Depodaki dosya bağlantısı" desteği
• Markdown dosyaları
  • "ms.date" Meta Veri Değeri bağlam menüsü seçeneğini güncelleştirme
  • Kod çiti dil tanımlayıcıları için kod otomatik tamamlama desteği
  • Tanınmayan kod çiti dil tanımlayıcısı uyarıları/otomatik düzeltme desteği
  • Seçimi artan düzende sıralama (A - Z)
  • Seçimi azalan düzende sıralama (Z - A)

Sonraki adımlar

Learn Authoring Pack, Visual Studio Code uzantısında bulunan çeşitli özellikleri keşfedin.

• Geliştirme dili tamamlama
• Resim sıkıştırma
• Meta veri güncelleştirmeleri
• Tabloyu yeniden biçimlendirme
• Akıllı tırnak değişikliği
• Yeniden yönlendirmeleri sıralama
• Seçimi sıralama