सामग्री पर जाएं
भाषाएँ · हिन्दी

PolyPDF प्लगइन बनाएँ | डेवलपर गाइड

अपने कार्यालय के प्रतीकों को PolyPDF में जोड़ें। कोई कोड नहीं, कोई बाज़ार नहीं, कोई अनुमोदन कतार नहीं।

वर्तमान ऐप: PolyPDF 1.5.2 (बिल्ड 24) · पैकेज प्रारूप: PolyPDF 1.3.1+ · प्लगइन्स को स्थापित करने और चलाने के लिए 1.4.1+ में PolyPDF प्रो की आवश्यकता होती है

यदि आपकी टीम प्रत्येक शीट पर एक ही उत्तरी तीर, पुनरीक्षण त्रिकोण या रूम टैग की मुहर लगाती है, तो आप उस सेट को स्वयं पैकेज कर सकते हैं और अपने सहयोगियों को एक फ़ाइल के रूप में सौंप सकते हैं। इसमें एक टेक्स्ट एडिटर, एक ड्राइंग टूल और नोड की आवश्यकता होती है। पैकेज बनाना मुफ़्त है; वर्तमान ऐप में प्लगइन सामग्री को स्थापित करने, चलाने और संपादित करने के लिए PolyPDF Pro की आवश्यकता होती है।

प्लगइन डेटा है, प्रोग्राम नहीं

  • PolyPDF प्लगइन कलाकृति और JSON का एक हस्ताक्षरित फ़ोल्डर है। कोई जावास्क्रिप्ट प्रविष्टि बिंदु नहीं है और पैकेज में कुछ भी निष्पादित नहीं किया गया है।
  • आपका पैकेज एक प्रतीक सूची, उसके लिए एसवीजी कलाकृति और JSON में वर्णित एक फॉर्म प्रदान करता है। PolyPDF फॉर्म को प्रस्तुत करता है, अपना स्वयं का जनरेटर चलाता है, और परिणाम को एक ही पूर्ववत चरण में सामान्य एनोटेशन के रूप में ड्राइंग में जोड़ता है।
  • व्यापार जानबूझकर किया जाता है: आप मनमाना व्यवहार छोड़ देते हैं, और बदले में आपका प्लगइन किसी ग्राहक के चित्र लीक नहीं कर सकता है, उनके ऐप को तोड़ नहीं सकता है, और किसी को भी इसे सुरक्षित रूप से इंस्टॉल करने से पहले किसी समीक्षा प्रक्रिया की आवश्यकता नहीं है।

लोग इससे क्या बनाते हैं

  • उत्तर तीर एक शीट के वास्तविक उत्तर से मेल खाते हैं, संशोधन त्रिकोण, कमरे और उपकरण टैग, विवरण मार्कर, वेल्डिंग प्रतीक, एडीए और अग्नि-सुरक्षा प्रतीक, उपयोगिता कॉलआउट - एक कार्यालय का अपना मानक प्रतीक सेट, हर बार सही मुद्रित आकार पर मुहर लगाई जाती है।
  • प्रतीकों को इंच में आकार में रखा जाता है, उनके खींचे गए अनुपात को बनाए रखा जाता है, घुमाया जाता है, और एक कैप्शन ले जा सकते हैं - उत्तरी तीर के लिए नीचे, एक संशोधन संख्या या कक्ष संख्या के लिए आकार के अंदर।
  • एक बार रखे जाने पर वे सामान्य एनोटेशन होते हैं: चयन करने योग्य, चल सकने योग्य, स्टाइल करने योग्य, निर्यात करने योग्य, और यदि प्लगइन बाद में बंद या हटा दिया जाता है तो वे अभी भी मौजूद हैं।

एक प्लगइन क्या कभी नहीं कर सकता

  • कोड चलाएँ. कोई जावास्क्रिप्ट नहीं, कोई WASM नहीं, कोई मूल पुस्तकालय नहीं।
  • नेटवर्क तक पहुंचें. किसी भी प्रकार का कोई अनुरोध, कभी नहीं - बाहरी संदर्भ वाली कलाकृति को इंस्टॉल समय पर अस्वीकार कर दिया जाता है, इसलिए जब कोई शीट खोली जाती है तो कोई प्रतीक घर पर फोन नहीं कर सकता है।
  • अपने दस्तावेज़ पढ़ें. एक प्लगइन में पेज का आकार, रोटेशन और आपने कहां क्लिक किया, यह बताया जाता है। न पाठ, न एनोटेशन, न फ़ाइल का नाम, न पीडीएफ बाइट्स।
  • अपनी फ़ाइलें स्पर्श करें, अपना लाइसेंस विवरण देखें, मौजूदा एनोटेशन बदलें, या कुछ भी सहेजें।
  • यह वास्तुशिल्प है, ऐसी नीति नहीं जिसे हम लागू करने का वादा करते हैं: इसके लिए कोई एपीआई नहीं है।

आप क्या लिखते हैं

प्लगइन एक फ़ोल्डर है. मेनिफेस्ट बताता है कि यह क्या है और यह टूल मेनू में क्या जोड़ता है; कैटलॉग आपके प्रतीकों और उनके मुद्रित आकारों को सूचीबद्ध करता है; संपत्तियाँ सादे एसवीजी फ़ाइलें हैं।

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

आप इसे कैसे बनाते हैं

एक फ़ाइल, कोई निर्भरता नहीं, नोड 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, एक कार्यशील उदाहरण प्लगइन के साथ आप लगभग एक मिनट में बना और इंस्टॉल कर सकते हैं।

कोई बाज़ार नहीं है. एक प्लगइन फ़ाइल वितरण है: इसे अपने इंट्रानेट पर, रिलीज़ में, या ईमेल में रखें। डाउनलोड के आगे इसका चेकसम और अपनी कुंजी फिंगरप्रिंट प्रकाशित करें और कोई भी सत्यापित कर सकता है कि उन्हें आपकी फ़ाइल मिली है, किसी और की नहीं।

प्रश्न

यदि रनटाइम आपके मन में मौजूद ड्राइंग कार्य को व्यक्त नहीं कर सकता है, तो इसके चारों ओर काम करने के बजाय ऐसा कहें - नए रनटाइम ऐप के साथ आते हैं, और यह जानना कि लोगों को वास्तव में क्या चाहिए, अगला कैसे चुना जाता है।

समर्थन से संपर्क करें