التصميم في أداة الإنشاء

ابدأ بقالب

أنشئ قالبًا من قسم القوالب في حسابك أو افتح قالبًا موجودًا في أداة الإنشاء. استخدم الموارد لإضافة نصوص أو عناوين أو جداول أو صور أو مخططات. يعرض تحديد عنصر في مساحة العمل إعداداته في لوحة الفحص.

التخطيط والمساحة المتاحة

استخدم التخطيط للموضع والحجم والمحاذاة، والنمط للخطوط والمسافات الداخلية. يتبع موضع التدفق ترتيب المستند، أما الموضع المطلق فللعناصر التي تحتاج موقعًا محددًا. فضّل flow للتقارير المتنامية وافحص فواصل الصفحات ببيانات طويلة.

الحجم والهوامش والمسافات الداخلية

يملأ عرض 100% المنطقة الحاوية لا الورقة كلها. تقلل هوامش الصفحة مساحة المستند المتاحة، وتقلل المسافات الداخلية المساحة داخل العنصر. وتتقيد الجداول والمخططات داخل الأعمدة بعرض العمود أيضًا.

نفّذ العملية نفسها عبر API

يكتب المحرر تعريف القالب عبر الطرف النهائي نفسه الذي يمكنك استدعاؤه. اقرأ التعريف الحالي وعدّله، ثم أعد كتابته مع الإصدار الذي قرأته، كي لا تستبدل بالخطأ تغييرًا نشره شخص آخر في هذه الأثناء.

# 1 - نزّل التعريف الذي يعمل عليه المحرر
curl -s https://api.pdfgine.com/api/v1/templates/invoice \
  -H "X-PDFgine-Key: $PDFGINE_KEY" > invoice.json

# 2 - عدّل الكائن "definition" داخل invoice.json

# 3 - أعد كتابته برقم الإصدار نفسه
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": "نُقل الشعار إلى الهامش الأيمن.",
        "definition": { "page": { "size": "A4", "orientation": "portrait" }, "elements": [] }
      }'

تضمن expectedVersion أمان العملية. إذا تغير القالب، تُرفض الكتابة بالحالة 409 وتتضمن الاستجابة الإصدار الحالي؛ اقرأ مجددًا وأعد تطبيق تغييرك ثم اكتب مرة أخرى.

حفظ المخرجات وفحصها

احفظ تغييراتك ثم افحص المعاينة وناتج PDF أو Word المطلوب. قد ينشئ نموذج يناسب مساحة العمل صفحات أكثر مع بيانات فعلية أطول. راجع العناوين والجداول وتسميات المخططات وفواصل الصفحات معًا قبل النشر.

الأخطاء الشائعة

• ما تراه في المحرر هو المسودة. حتى تنشرها، يستمر كل إنشاء إنتاج في استخدام الإصدار المنشور الأقدم.
• البيانات النموذجية أقصر من الفعلية. قد يتجاوز تخطيط يناسب مساحة العمل إلى صفحة ثانية عند وصول اسم عميل حقيقي وعنوان وثلاثين صفًا.
• تعني 100% المنطقة الحاوية لا الورقة. تُقتطع الهوامش والمسافات الداخلية قبل حصول العنصر على عرضه.
• الموضع المطلق لا يفسح المجال. يبقى العنصر ذو الإحداثيات الثابتة في مكانه بينما يمتد المحتوى المتدفق حوله؛ استخدم flow لما قد يمتد عبر صفحات.
• عمل شخصين على القالب نفسه يؤدي إلى 409 لا إلى دمج. تحمل الكتابة إصدار البداية وتُرفض إذا تغير.