Şablonlara genel bakış
Recipe ve FeatureRecipe yazarları, belirli değerlendirme noktalarında Go text/template kodu yazar: provides girdileri, locals girdileri, valuesMapping (satır içi veya $import: ile yüklenen), workload: içeriği (satır içi veya $import: ile yüklenen), artifacts: girdileri (satır içi veya girdi başına $import: ile yüklenen), FeatureRecipe injectMapping, source:, assertions: girdileri ve her pipeline: adımının with: ve when: alanları. Her nokta, derleme işlem hattının tanımlı bir aşamasında çalışır ve sütun bağlamının tanımlı bir görünümünü alır. Bu bölüm kümesi şablon yüzeyini belgeler: şablonların nerede çalıştığı, bağlamın her noktada neyi sunduğu ve hangi yardımcı fonksiyonların kullanılabildiği.
Şablon bağlamının biçimi ve değerlendirme sırası, taşıyıcı sözleşmelerdir; bunlardan herhangi birindeki değişiklik mevcut her Recipe şablonunu bozar. Şablon bağlamı, derleyiciyle birlikte gelen bir JSON Schema’da biçimsel olarak tanımlanır; nokta başına değerlendirme matrisi hangi sütunların hangi noktada okunabildiğini açıklar ve Go şablon motoru, Sprig yardımcı kütüphanesi ile Aggrega’ya özgü uzantılarla birlikte gelir. Bu değerlendirme noktalarını sabitleyen işlem hattı aşamaları, mimari düzeyde ../architecture/10-compilation-pipeline.md içinde açıklanır: FeatureRecipe injectMapping için enjeksiyon eşlemesi, Recipe .locals ve .source için locals ön bölümü ve kaynak çözümleme, temel Recipe valuesMapping için temel işleme ve FeatureRecipe kaynak üretimi için özellik işleme.
Konu bazında başvuru
- Şablon genişletme matrisi — her şablon değerlendirme noktasını, noktanın hangi sütunları okuduğunu ve çıktıların IR grafiğine veya sonraki alt geçişlere nasıl aktığını kapsayan, nokta başına yetkili tablo.
- Şablon bağlamı sözleşmesi — derleyicinin şablonlara verdiği şablon bağlamının biçimsel yapısı; çift durumlu
.inject/.inject_rawçifti ve zenginleştirilmiş.context.usesJOIN izdüşümü dahil. - İşlenmiş bir kaynağı adlandırma — iki kimlik anahtarından hangisinin neyi adlandırdığı, bir
useshedefi ile bir üreticinin yayımladığı referans arasındaki fark, hangi sağlayıcıların işledikleri kaynaklar için bir ad bildirdiği ve diğerlerinin neden hiç ad bildirmediği ve böyle bir adın bulunmadığı yerde anahtarı reddeden durdurma. - Sprig fonksiyonları ve yardımcıları — Go şablonları içinde kullanılabilen Sprig yardımcıları ile Aggrega’ya özgü uzantılar ve güvenlik yardımcıları, yazılmış bir sayının bir değer şablonunda nasıl okunduğu, yazdırıldığı ve karşılaştırıldığı ve hangi yardımcıların bir değerin yazılıp yazılmadığını, hangilerinin boş olup olmadığını sorduğu.
- Parametre şablon bağlamı — Release tarafından karşılanan
parameters:değerlerinin bir şablona nerede ulaştığı: değer şablonlarına çalışmadan önce enterpolasyonla yerleştirilir ve yalnızca yol şablonları tarafından doğrudan okunur. assertions:bloğu — bir Component, Feature, Recipe veya FeatureRecipe’in şablon olarak bildirdiği, işlemeden önce değerlendirilen adlandırılmış alanlar arası kurallar.