انتقل إلى المحتوى
اللغات · العربية

إنشاء إضافة لـ PolyPDF | دليل المطور

أضف رموز مكتبك إلى PolyPDF. لا يوجد كود ولا سوق ولا قائمة انتظار للموافقة.

التطبيق الحالي: PolyPDF 1.5.2 (النسخة 24) · تنسيق الحزمة: PolyPDF 1.3.1+ · يتطلب تثبيت المكونات الإضافية وتشغيلها وجود PolyPDF Pro في الإصدار 1.4.1+

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

البرنامج المساعد هو البيانات، وليس البرنامج

  • المكون الإضافي PolyPDF عبارة عن مجلد موقع للأعمال الفنية وJSON. لا توجد نقطة دخول لـ JavaScript ولا يتم تنفيذ أي شيء في الحزمة على الإطلاق.
  • توفر الحزمة الخاصة بك كتالوج الرموز، وعمل SVG الفني له، ونموذجًا موصوفًا بتنسيق JSON. يقوم PolyPDF بعرض النموذج وتشغيل المولد الخاص به وإضافة النتيجة إلى الرسم كتعليقات توضيحية عادية في خطوة واحدة غير قابلة للتراجع.
  • التجارة متعمدة: أنت تتخلى عن السلوك التعسفي، وفي المقابل لا يمكن للمكون الإضافي الخاص بك تسريب رسومات العميل، ولا يمكنه كسر تطبيقه، ولا يحتاج إلى عملية مراجعة قبل أن يتمكن أي شخص من تثبيته بأمان.

ما يبنيه الناس به

  • أسهم الشمال مطابقة للشمال الحقيقي للورقة، ومثلثات المراجعة، وعلامات الغرفة والمعدات، وعلامات التفاصيل، ورموز اللحام، ورموز ADA والسلامة من الحرائق، ووسائل شرح المرافق - مجموعة الرموز القياسية الخاصة بالمكتب، مختومة بالحجم المطبوع الصحيح في كل مرة.
  • يتم وضع الرموز بحجم بالبوصة، مع الحفاظ على نسبها المرسومة، وتدويرها، ويمكن أن تحمل تسمية توضيحية - أسفلها لسهم الشمال، وداخل الشكل لرقم المراجعة أو رقم الغرفة.
  • بمجرد وضعها، تصبح تعليقات توضيحية عادية: قابلة للتحديد، ومنقولة، وقابلة للتصميم، وقابلة للتصدير، وتظل موجودة إذا تم إيقاف تشغيل المكون الإضافي أو إزالته لاحقًا.

ما لا يمكن للمكون الإضافي فعله أبدًا

  • تشغيل التعليمات البرمجية. لا يوجد JavaScript ولا WASM ولا مكتبة أصلية.
  • الوصول إلى الشبكة. لا توجد طلبات، من أي نوع، على الإطلاق - يتم رفض العمل الفني الذي يحمل مرجعًا خارجيًا في وقت التثبيت على وجه التحديد، لذلك لا يمكن للرمز الاتصال بالمنزل عند فتح الورقة.
  • اقرأ المستندات الخاصة بك. يتم إخبار المكون الإضافي بحجم الصفحة وتدويرها والمكان الذي نقرت عليه. ليس النص، وليس التعليقات التوضيحية، وليس اسم الملف، وليس بايت PDF.
  • المس ملفاتك، أو راجع تفاصيل الترخيص، أو غيّر تعليقًا توضيحيًا موجودًا، أو احفظ أي شيء.
  • هذه عملية معمارية، وليست سياسة نعد بتنفيذها: لا توجد واجهة برمجة تطبيقات (API) لأي منها.

ما تكتبه

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

my-plugin/
  manifest.json          identity, permissions, commands, the form
  data/symbols.json      each symbol: id, label, artwork, size in inches
  assets/*.svg           the artwork
  icons/icon.png         optional, 256 x 256

كيف تقوم ببنائها

ملف واحد، بدون تبعيات، Node 18 أو أحدث. فهو يتحقق من صحة الحزمة بأكملها قبل أن تكتب أي شيء — التخطيط، والبيان، وأسماء الأذونات، والكتالوج الخاص بك، وما إذا كان عملك الفني مقبولًا — ويسمي الملف وإصلاح أي خطأ.

curl -O https://www.polypdf.com/plugins/polypdf-plugin-pack.mjs

node polypdf-plugin-pack.mjs keygen --out ~/.polypdf-keys
node polypdf-plugin-pack.mjs pack my-plugin --key ~/.polypdf-keys/polypdf-plugin-key.pem

ثم قم بتثبيته في PolyPDF: الإضافات... ▸ التثبيت من الملف.

حول هذا التوقيع

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

  • إنه يؤكد أن الحزمة لم يتم تغييرها منذ إنشائها، ويثبت المكون الإضافي الخاص بك بمفتاحك: يتم رفض التحديث الموقع من قبل أي شخص آخر.
  • التوقيع ليس مراجعة أو موافقة على PolyPDF. يتم توقيع المكونات الإضافية التي يتم شحنها داخل PolyPDF بواسطة PolyPDF؛ المكون الإضافي الذي تقوم بالتوقيع عليه بنفسك هو طبقة منفصلة ذات علامات واضحة.
  • يرى أي شخص يقوم بتثبيت المكون الإضافي الخاص بك شاشة الموافقة أولاً: ما يمكنه فعله بلغة واضحة، وبصمة مفتاحك، والمجموع الاختباري للحزمة. يقول صفه في مدير البرنامج المساعد تم التثبيت من ملف طالما تم تثبيته.
  • قم بعمل نسخة احتياطية من مفتاحك الخاص. ونظرًا لأن عمليات التثبيت مثبتة عليه، فإن المفتاح المفقود يعني أنه يجب على المستخدمين إلغاء التثبيت قبل أن يتمكنوا من الحصول على الإصدار التالي.

الدليل الكامل

المرجع الكامل — كل حقل بيان، وتنسيق الحزمة، وقواعد العمل الفني، والإصدار، والتوزيع، وقسم استكشاف الأخطاء وإصلاحها — يأتي مع PolyPDF على docs/plugins/PLUGIN-AUTHORING.md، إلى جانب مثال إضافي عملي يمكنك إنشاؤه وتثبيته في حوالي دقيقة.

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

أسئلة

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

اتصل بالدعم