Generator ile tasarım

Bir şablonla başlayın

Hesabınızdaki Şablonlar sayfasından yeni bir şablon oluşturun veya mevcut şablonu Generator’da açın. Varlıklar panelinden metin, başlık, tablo, görsel ya da grafik ekleyin. Tuvalde bir eleman seçtiğinizde Denetçi o elemanın ayarlarını gösterir.

Yerleşim ve kullanılabilir alan

Düzen sekmesinde konum, boyut ve hizalamayı; Stil sekmesinde yazı ve iç boşluk ayarlarını düzenleyin. Akış yerleşimi içeriği belge sırasına göre yerleştirir; mutlak yerleşim belirli bir konuma ihtiyaç duyan elemanlar içindir. Uzayan raporlarda akışı tercih edin ve uzun veriyle sayfa geçişlerini kontrol edin.

Boyut, kenar boşluğu ve iç boşluk

%100 genişlik, elemanın bulunduğu alanı doldurur; kağıdın tamamını ifade etmez. Sayfa kenar boşlukları kullanılabilir belge alanını, iç boşluk elemanın içindeki alanı daraltır. Kolon içindeki tablo ve grafikleri de kolon genişliğine göre değerlendirin.

Aynı işi API üzerinden yapın

Editör, şablon tanımını sizin de çağırabileceğiniz uçtan yazıyor. Mevcut tanımı okuyun, değiştirin ve okuduğunuz sürüm numarasıyla geri yazın — böylece bu arada başkasının yayımladığı bir değişikliğin üzerine yanlışlıkla yazılamaz.

# 1 - Editörün üzerinde çalıştığı tanımı indirin
curl -s https://api.pdfgine.com/api/v1/templates/invoice \
  -H "X-PDFgine-Key: $PDFGINE_KEY" > invoice.json

# 2 - invoice.json içindeki "definition" nesnesini düzenleyin

# 3 - Aynı sürüm numarasıyla geri yazın
curl -X POST https://api.pdfgine.com/api/v1/templates \
  -H "X-PDFgine-Key: $PDFGINE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "code": "invoice",
        "name": "Invoice",
        "saveMode": "manual",
        "expectedVersion": 1,
        "changeReason": "Logo sağ kenar boşluğuna taşındı.",
        "definition": { "page": { "size": "A4", "orientation": "portrait" }, "elements": [] }
      }'

Bunu güvenli yapan şey expectedVersion. Şablon bu arada ilerlediyse yazma 409 ile reddediliyor ve yanıt güncel sürümü söylüyor; yeniden okuyup değişikliğinizi tekrar uygulayın.

Kaydetme ve çıktı kontrolü

Düzenlemeyi kaydedin; ardından Önizleme ve ihtiyacınız olan PDF veya Word çıktısını kontrol edin. Tuvalde sığan bir örnek, daha uzun gerçek veride yeni sayfalar oluşturabilir. Yayınlamadan önce başlıkları, tabloları, grafik etiketlerini ve sayfa sonlarını birlikte inceleyin.

Sık takılınan yerler

• Editörde gördüğünüz taslaktır. Siz yayımlayana kadar her üretim eski yayımlanmış sürümü kullanmaya devam eder.
• Örnek veri gerçek veriden kısadır. Tuvale sığan bir düzen, gerçek bir müşteri adı, adres ve otuz satır gelince ikinci sayfaya taşar.
• 100%, sayfanın değil içinde bulunduğu alanın genişliğidir. Kenar boşlukları ve iç boşluk payını öğeden önce alır.
• Mutlak yerleşim kenara çekilmez. Sabit koordinata konan bir öğe orada kalırken akış içeriği büyüyüp üstüne gelir; sayfa aşabilecek her şey akışta durmalı.
• Aynı şablonda iki kişi birleştirme değil 409 demektir. Yazma, başladığınız sürümü taşır ve o sürüm ilerlediyse reddedilir.