أدوات لالتقاط وتحويل الويب

كيفية إضافة الرؤوس والتذييلات إلى مستندات DOCX و PDF؟

رأس

لإضافة رؤوس و/أو تذييلات إلى مستندات DOCX أو PDF، عليك أولاً القيام بذلك إنشاء قالب، مع معرف محدد. في هذه الحالة report. يمكن أن يتضمن القالب كافة النصوص والصور والجداول التي تريد عرضها، بالإضافة إلى القواعد الخاصة بوقت إظهار الرؤوس والتذييلات.

متغيرات القالب القياسية

محرر القالب يحتوي على مجموعة كبيرة من متغيرات القالب المضمنة، وتشمل ما يلي.

  • رقم الصفحة
  • عنوان قوات الدفاع الشعبي
  • URL
  • عدد الصفحات
  • السنة
  • شهر
  • يوم
  • ساعة
  • دقيقة
  • الثاني

متغيرات القالب المخصص

يمكنك أيضًا تحديد متغيرات القالب المخصصة في القالب الخاص بك والتي يمكن أن تحتوي على أي نص عادي. ليس من الممكن تمرير HTML باستخدام متغيرات القالب المخصصة، ولكن سيتم تحويل أي أحرف /n أو /r إلى فواصل أسطر.

في المثال أدناه، يتم استخدام متغير مخصص في نص الرأس، are {number} هو متغير مخصص.

Report number: {number}

يمكنك بعد ذلك تمرير معرف القالب هذا إلى GrabzIt لإضافة الرأس المحدد إلى أي مستند DOCX أو PDF. في الأمثلة الموضحة أدناه، يتم عرض الرأس أعلاه في كل مستند PDF يتم إنشاؤه، لكل لغة برمجة ندعمها. ومع ذلك، يمكن تعديل هذا الكود بسهولة لإضافة رؤوس وتذييلات إلى مستندات DOCX أيضًا.

GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
PDFOptions options = new PDFOptions();
options.TemplateId = "report";
options.MarginTop = 50;
options.MarginBottom = 50;
options.AddTemplateParameter("number", "12345");

grabzIt.URLToPDF("http://www.spacex.com", options);
grabzIt.Save("http://www.example.com/Home/Index");
GrabzItClient grabzIt = new GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
PDFOptions options = new PDFOptions();
options.setTemplateId("report");
options.setMarginTop(50);
options.setMarginBottom(50);
options.AddTemplateParameter("number", "12345");

grabzIt.URLToPDF("http://www.spacex.com", options);
grabzIt.Save("http://www.example.com/handler");
<script src="https://cdn.jsdelivr.net/npm/@grabzit/js@3.5.2/grabzit.min.js"></script>
<script>
GrabzIt("Sign in to view your Application Key").AddTemplateVariable("number", "12345").ConvertURL("http://www.spacex.com", 
{"format": "pdf", 
"mtop":50, 
"mbottom":50, 
"templateid":"report"}).Create();
</script>

لتحديد متغيرات قالب متعددة، ما عليك سوى فصل كل زوج من قيم المفاتيح بعلامة &.

var grabzit = require('grabzit');

var client = new grabzit("Sign in to view your Application Key", "Sign in to view your Application Secret");
var options = {"marginTop":50,"marginBottom":50,"templateId":"report",
"templateVariables":"number=12345"};

client.url_to_pdf("http://www.spacex.com", options);
client.save("http://www.example.com/handler", function (error, id){
    if (error != null){
        throw error;
    }
});
$grabzIt = GrabzItClient->new("Sign in to view your Application Key", "Sign in to view your Application Secret");
$options = GrabzItPDFOptions->new();
$options->marginTop(50);
$options->marginBottom(50);
$options->templateId("report");
$options->AddTemplateParameter("number","12345");

$grabzIt->URLToPDF("http://www.spacex.com", $options);
$grabzIt->Save("http://www.example.com/handler.pl");
$grabzIt = new \GrabzIt\GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret");
$options = new \GrabzIt\GrabzItPDFOptions();
$options->setMarginTop(50);
$options->setMarginBottom(50);
$options->setTemplateId("report");
$options->AddTemplateParameter("number","12345");

$grabzIt->URLToPDF("http://www.spacex.com", $options);
$grabzIt->Save("http://www.example.com/handler.php");
grabzIt = GrabzItClient.GrabzItClient("Sign in to view your Application Key", "Sign in to view your Application Secret")
options = GrabzItPDFOptions.GrabzItPDFOptions()
options.marginTop = 50
options.marginBottom = 50
options.templateId = "report"
options.AddTemplateParameter("number","12345")

grabzIt.URLToPDF("http://www.spacex.com", options)
grabzIt.Save("http://www.example.com/handler.py")

تذكر عند تقديم الطلبات يرجى التأكد من جميع يتم ترميز قيم المعلمات بعنوان URL. لاحظ أنه يجب أيضًا تشفير عنوان URL لكل اسم وقيمة POST أولاً. لتحديد متغيرات قالب متعددة، ما عليك سوى فصل كل زوج من قيم المفاتيح بعلامة &، ثم يقوم عنوان URL بتشفير ملف tvars المعلمة.

https://api.grabz.it/services/convert?key=Sign in to view your Application Key&format=pdf&tvars=number%3D12345&mtop=50&mbottom=50&templateid=report&url=https%3A%2F%2Fspacex.com%2F
grabzIt = GrabzIt::Client.new("Sign in to view your Application Key", "Sign in to view your Application Secret")
options = GrabzIt::PDFOptions.new()
options.marginTop = 50
options.marginBottom = 50
options.templateId = "report"
options.add_template_parameter("number","12345")

grabzIt.url_to_pdf("http://www.spacex.com", options)
grabzItClient.save("http://www.example.com/handler/index")

لا يظهر الرأس أو التذييل في ملف PDF

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