LlosLab Software Development BlogEngineering notes for PDF, Delphi, and document software developers.

مقالة تقنية

إضافة ارتباطات تشعبية قابلة للنقر إلى ملفات PDF باستخدام HotPDF

· برامج PDF

يوضح نموذج HotPDF هذا كيفية وضع ارتباطات تشعبية قابلة للنقر في مستند PDF مولد. الارتباطات التشعبية ميزة صغيرة، لكنها مهمة في الفواتير والتقارير وصفحات المنتجات وتصدير الوثائق وأي PDF يجب أن يعيد القارئ إلى موقع ويب أو صفحة طلب أو نموذج دعم أو دليل عبر الإنترنت.

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

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
unit Main;
 
interface
 
uses
  Windows, Messages, SysUtils, Classes, Graphics, Controls, StdCtrls, Forms, Dialogs, HPDFDoc;
 
type
  TForm1 = class(TForm)
    HotPDF: THotPDF;
    HelloWorldButton: TButton;
    edtWeb: TEdit;
    edtProduct: TEdit;
    edtOrder: TEdit;
    edtContact: TEdit;
    Label1: TLabel;
    Label2: TLabel;
    Label3: TLabel;
    Label4: TLabel;
    procedure HelloWorldButtonClick(Sender: TObject);
  private
    { Private declarations }
  public
    { Public declarations }
  end;
 
var
  Form1: TForm1;
 
implementation
 
{$R *.dfm}
 
procedure TForm1.HelloWorldButtonClick(Sender: TObject);
begin
    HotPDF.BeginDoc;
    HotPDF.CurrentPage.SetFont( 'Microsoft Sans Serif', [], 13 );
 
    HotPDF.CurrentPage.TextOut(20,30,0,'Clickable links:');
    HotPDF.CurrentPage.PrintHyperlink(20, 60, 'Company site: ' + edtWeb.Text, edtWeb.Text);
    HotPDF.CurrentPage.PrintHyperlink(20, 80, 'Product page: ' + edtProduct.Text, edtProduct.Text);
    HotPDF.CurrentPage.SetRGBHyperlinkColor(clRed);
    HotPDF.CurrentPage.PrintHyperlink(20, 100, 'Purchase link: ' + edtOrder.Text, edtOrder.Text);
    HotPDF.CurrentPage.SetRGBHyperlinkColor(clBlue);
    HotPDF.CurrentPage.PrintHyperlink(20, 120, 'Contact form: ' + edtContact.Text, edtContact.Text);
 
    HotPDF.EndDoc;
end;
 
end.

أين يناسب هذا النمط

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

الموضع والتنسيق

روابط PDF هي annotations موضوعة فوق منطقة في الصفحة. إذا غيرت الخط أو موضع النص أو التحجيم أو نظام إحداثيات الصفحة، فتحقق أن المستطيل القابل للنقر لا يزال يطابق النص الذي يراه المستخدم. قد يبدو الرابط معطلا إذا انزاح بصريا بضعة بكسلات حتى عندما يكون URL نفسه صحيحا.

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

قائمة التحقق

  • استخدم عناوين HTTPS مؤهلة بالكامل للمستندات العامة.
  • تحقق من عناوين URL التي يقدمها المستخدم قبل كتابتها في PDF.
  • اختبر الروابط في أكثر من عارض PDF لأن التعامل مع annotations قد يختلف بين القراء.
  • افحص المنطقة القابلة للنقر بعد تغيير حجم الصفحة أو الهوامش أو الخطوط أو التحجيم.
  • لا تخف إجراءات سير عمل مهمة خلف نص الرابط فقط؛ وفر سياقا محيطا في متن PDF.

ملاحظة SEO وتوزيع المستندات

عند نشر ملفات PDF عبر الإنترنت، تساعد تسميات الروابط الواضحة المستخدمين ومحركات البحث على فهم العلاقة بين المستند والمورد المرتبط. فضل نصا وصفيا مثل product documentation أو customer support portal بدلا من تسميات عامة مثل click here.