PlatyPS'ye genel bakış

PlatyPS, Get-Helpkullanılarak görüntülenen PowerShell yardımını oluşturmaya yönelik birincil araçtır. PowerShell yardım dosyaları, Microsoft Yardım Biçimlendirme Dili (MAML) olarak bilinen bir XML biçiminde depolanır. PlatyPSöncesinde, yardım dosyaları karmaşık araç zincirleri kullanılarak el ile yazılmıştır. Markdown, Visual Studio Codegibi birçok düzenleyici tarafından desteklenen ve daha kolay yazılan açık kaynak topluluğunda yaygın olarak kullanılır. PlatyPS, Markdown'da yardım dosyalarını yazmanıza ve ardından MAML'ye dönüştürmenize olanak tanıyarak işlemi basitleştirir.

PlatyPS'nin iki ana sürümü vardır.

• platyPS v0.14.2, Markdown biçiminde PowerShell yardım dosyaları oluşturmak için kullanılan geçerli PlatyPS sürümüdür.
• Microsoft.PowerShell.PlatyPS v1.0.0-preview1, PlatyPS'nin yeni sürümüdür. Bu sürüm, Markdown ayrıştırmak için markdig yararlanarak C# dilinde tam bir yeniden yazma işlemidir. Bu sürüm çeşitli iyileştirmeler içerir:
  • PowerShell cmdlet'inin ve parametrelerinin daha doğru bir açıklamasını sağlar
  • Artan performans - saniyeler içinde 1000 sn Markdown dosyasını işler
  • Yardım dosyasının bellekte işleyebileceğiniz bir nesne modeli oluşturur
  • Karmaşık işlemleri gerçekleştirmek için birbirine zincirleyebileceğiniz cmdlet'ler sağlar
  • Get-Helpiçin gereken tüm öğeleri ve daha önce kullanılamayan bilgileri içeren yeni bir Markdown şeması tanımlar.
  • Mevcut Markdown'ın (eski şemayı kullanarak) yeni nesnelere otomatik olarak dönüştürülerek yeni Markdown, YAML veya MAML'ye dışarı aktarmanızı sağlar.