Markdown Quarkdown lehçesi 2.0.0 sürümünde yayınlandı. Güncellemenin merkezinde, derleme sırasında bir belgeye erişimi ve tamamen çevrimdışı çalışan HTML çıktısını sınırlayan yeni bir izin sistemi yer alıyor. Ayrıca paralel oluşturma, kanonik bağlantılar için yeni HTML seçenekleri ve sitemap.xml aynı zamanda bir tane public/-Statik kaynak dizini. Birkaç önemli değişiklik aynı zamanda varsayılan çıktı dizinini ve çıktı dizini adını da etkiler. --preview ve yeniden adlandırılan standart kütüphane modülü.
Duyurudan sonra devamını okuyun
Quarkdown, biçimlendirme dilini Turing-complete işlevsel diliyle genişletir. Klasik Markdown'dan farklı olarak açık kaynak proje, değişkenlere, işlevlere ve kontrol yapılarına doğrudan belgede izin verir. Kitaplar, teknik metinler, bilgi kitaplıkları ve sunumlar için HTML ve PDF çıktısını hedefler. Markdown'ı bilen herkes Quarkdown'u en iyi yerleşik komut dosyası ve düzen katmanına sahip Markdown olarak hayal edebilir.
Korumalı alan olarak yetkilendirme sistemi
En önemli yenilik ise yetkilendirme sistemidir. Derleme sırasında bir belgeye nelerin erişmesine izin verildiğini belirler. Derleyici uygun izin olmadan bir eylemi gerçekleştirmeye çalışırsa bir hata vererek iptal edilir. Kullanıcılar onayları ve yasakları tercüme eder --allow VE --deny; diğer şeylerin yanı sıra sağlanır project-read, global-read, network, native-content VE all. Bu özellik öncelikli olarak bir korumalı alan işlevi görür: Quarkdown belgeleri, işlevsel dilleri sayesinde saf Markdown'dan çok daha fazlasını yapabildiğinden, üçüncü taraf belgelerinin yürütülmesi daha iyi korunabilir.
Gözden geçirilmiş HTML çıktısı da merkezidir. Quarkdown artık kurulumla birlikte isteğe bağlı yazı tipleri, kod vurgulama temaları ve kitaplıklar sağlıyor ve bunları CDN veya Google Fonts'tan yeniden yüklemek yerine oluşturulan belgelere kopyalıyor. Bu, çıktının tamamen çevrimdışı çalıştığı anlamına gelir. Sürüm notlarına göre bu aynı zamanda daha öngörülebilir görüntü oluşturma ve daha hızlı sayfa görüntüleme olanağı sağlıyor. Yalnızca Çince yazılar dahil edilmiştir .doclang {zh} tıpkı açıkça seçilen Google Yazı Tiplerinin uzak kalması gibi. Fiyat, daha büyük çıktı dizinleridir ve ilk yürütme biraz daha yavaştır; Tasarım gereği sonraki derlemeler sağlama toplamı doğrulamalarını yavaşlatmaz.
Quarkdown ayrıca HTML projeleri için de yeni özellik sunuyor .htmloptions A. Setli baseurl dosyada kanonik bağlantılar oluşturur <head> her sayfaya bir tane yaz sitemap.xml üst ve alt belgeler için mutlak URL'lerle. Bu, kullanıcıların daha sonra bu tür SEO meta verilerini eklemesine gerek kalmadan Quarkdown'u tipik statik site oluşturuculara yaklaştırır.
Statik varlıklar ve yeni özellikler
Yeni dizin aynı zamanda web sürümleri için de kullanışlıdır public/ proje kök dizininde. İçeriği – yaklaşık olarak robots.txt, CNAME veya diğer statik dosyalar – çıktının kök dizininde değişmeden kalır. Ayrıca Quarkdown artık HTML'yi dışa aktarırken kök yol sembolünü de tanıyor @: Gibi bir referans @/assets/logo.png çıktı kökünü işaret ederek birden çok alt belgeyi paylaşan kaynaklar için uygun hale getirir. Konsept buna benziyor public/-Ortak web çerçevesi klasörleri.
Duyurudan sonra devamını okuyun
İlkel fonksiyon da yenidir .imageBu, medya depolamayı devre dışı bırakma yeteneği de dahil olmak üzere görüntüleri daha yapılandırılabilir hale getirir. mediastorage:{no}. Çapraz referanslar .ref Quarkdown artık tüm referans verilebilir türler için bağlantılar sunuyor: yalnızca başlıklar değil, aynı zamanda kullanıcı tanımlı şekiller, tablolar, kod blokları, denklemler ve numaralı bloklar. Bu, daha uzun teknik belgelerde gezinmeyi çok daha tutarlı hale getirir.
Daha küçük ama kullanışlı kolaylık sağlayan işlevler arasında, satırın sonunda ters eğik çizgi kullanan çok satırlı işlev çağrıları ve yeni işlev bulunur .keybinding klavye kısayolları için. İkincisi, kısayolları stilize edilmiş tuş etiketleri olarak gösterir ve örneğin platform farklılıklarını dikkate alır. ⌘ yerine Ctrl macOS'ta. Bu, dokümantasyon, bilgi kitaplıkları ve kullanıcı arayüzü içeriği gibi alanlar için kullanışlıdır.
Artan hız ve hata düzeltmeleri
Quarkdown 2.0 artık kardeş öğeleri paralel olarak işliyor ve bu da büyük belgeleri hızlandırıyor. Proje aynı zamanda medya arşivinin giriş ve çıkışını da revize etti: Quarkdown artık gereksiz kopyaları önleyen sağlama toplamlarının eklenmesiyle dosyaları içerik yerine referansa göre kopyalıyor.
Bazı uyumsuzluklara karşı mevcut konfigürasyonların hazırlanması gerekmektedir. Varsayılan çıktı dizini artık çağrılıyor ./quarkdown-output yerine ./output. İLE --preview olmadan --out-name Quarkdown gelecekte şemaya göre statik isimler atayacak preview-<mainfile>-<hash>kendin yerine .docname kendinizi yönlendirin. Standart kütüphanede ayrıca bir yeniden adlandırma vardır: Önceki modül Injection şimdi o çağrılıyor Html; Bu nedenle modül belgelerine ve işlevlerine ilişkin mevcut referanslar uyarlanmalıdır.
Lisans ve kurulum
Quarkdown 2.0.0 ile ilgili tüm bilgileri GitHub'daki sürüm notlarında bulabilirsiniz. Proje açık kaynaktır: Quarkdown ve modülleri varsayılan olarak GNU GPLv3 altında mevcuttur; modüller ve ikili paketler için quarkdown-cli VE quarkdown-lsp GNU AGPLv3 geçerlidir. Yazılım, Linux, macOS ve Windows'ta bir kurulum komut dosyası kullanılarak ve ayrıca Homebrew veya Scoop aracılığıyla kurulabilir; alternatif olarak proje bir şeye atıfta bulunur quarkdown.zip mevcut kararlı sürümden veya bir derlemeden gradlew installDist.
Ayrıca okuyun
(fo)
Bir yanıt yazın