opf

Open Presentation Format (OPF) स्लाइड डेक के लिए एक पोर्टेबल, मानव-पठनीय JSON दस्तावेज़ प्रारूप है। यह रिपॉजिटरी प्रारूप विनिर्देश (specification), JSON Schemas, कैटलॉग प्रीसेट्स, उदाहरणों, जनरेटेड डेवलपर टाइप्स, लोकल वैलिडेशन टूलिंग और भविष्य के रेंडर/एडिट/कन्वर्ट टूलकिट के लिए प्लानिंग दस्तावेज़ों का आधिकारिक घर है। इसे npm पर @openpresentation/opf के रूप में प्रकाशित किया गया है, जो वर्तमान में प्री-स्टेबल (0.x, जिसमें 1.0 से पहले माइनर वर्ज़न के बीच ब्रेकिंग बदलाव अपेक्षित हैं) है और MIT लाइसेंस के तहत है। प्रेरणा: .pptx XML का एक ज़िप किया हुआ बंडल है जिसे मनुष्यों के लिए diff करना कठिन है, मॉडल्स के लिए विश्वसनीय रूप से पढ़ना और लिखना कठिन है, और git के लिए सार्थक रूप से ट्रैक करना कठिन है, इसलिए हर बदलाव एक बाइनरी ब्लॉब जैसा दिखता है। OPF सादा JSON है — जिसे एडिटर में पढ़ा जा सकता है, उदाहरणों के माध्यम से स्कीमा का अनुमान लगाए बिना मॉडल द्वारा लिखा जा सकता है, और अन्य कार्यों के साथ वर्ज़न कंट्रोल में ट्रैक किया जा सकता है। इसका घोषित लक्ष्य LLMs को मार्कअप टैग से लड़ने के बजाय डेक बनाने (कथा संरचना, फ्रेमिंग, डेटा विश्लेषण, चार्ट सुझाव, संशोधन) में भाग लेने देना है। परंपराएं और नामकरण: पूर्ण प्रस्तुतियों के लिए OPF दस्तावेज़ *.opf.json (उदाहरण के लिए board-review.opf.json) नाम की JSON फाइलें होते हैं। प्रोजेक्ट केवल *.opf एक्सटेंशन के उपयोग के विरुद्ध सलाह देता है क्योंकि इसका उपयोग पहले से ही अन्य दस्तावेज़ और प्रोजेक्ट प्रारूपों द्वारा किया जा रहा है। Open Presentation Format नाम और स्कीमा, कैटलॉग, पैकेज और लोकल टूलिंग का उपयोग तीसरे पक्ष के टूल्स द्वारा उत्पाद-विशिष्ट ब्रांडिंग अपनाए बिना पढ़ने, लिखने, वैलिडेट करने, रेंडर करने, कन्वर्ट करने और समर्थन का वर्णन करने के लिए किया जा सकता है। JavaScript/TypeScript पैकेज क्या करता है: यह spec/ से कैनोनिकल स्कीमा और बंडल कैटलॉग रिकॉर्ड्स, पैकेज-एड्रेसेबल स्पेक कंटेंट के लिए एक टाइप्ड रॉ स्पेक फाइल मैनिफेस्ट, Presentation को टॉप-लेवल टाइप के रूप में रखने वाले जनरेटेड TypeScript टाइप्स, और OPF JSON और कैटलॉग रिकॉर्ड्स के लिए लोकल वैलिडेशन एक्सपोर्ट करता है। वैलिडेशन वैधता के साथ-साथ एडवाइजरी चेतावनियाँ लौटाता है, उदाहरण के लिए अज्ञात कैटलॉग आईडी। स्कीमा, कैटलॉग, स्पेक फाइल्स, वैलिडेटर और टाइप्स के लिए फोकस्ड सबपाथ इम्पोर्ट्स उपलब्ध हैं, और रॉ JSON स्कीमा को सीधे इंजनों या रिज़ॉल्वर द्वारा इम्पोर्ट किया जा सकता है। पैकेज प्योर कंपोजिशन ज्योमेट्री भी एक्सपोज़ करता है ताकि डाउनस्ट्रीम लाइब्रेरीज़ लेआउट व्यवहार साझा कर सकें। यह स्पष्ट रूप से .pptx को रेंडर या पार्स नहीं करता है, AI के साथ कंटेंट जनरेट नहीं करता है, रिमोट कैटलॉग फेच नहीं करता है, होस्टेड APIs को कॉल नहीं करता है या प्रबंधित सेवाएं प्रदान नहीं करता है। लोकल टूलिंग: एक इंस्टॉलेबल MIT-लाइसेंस प्राप्त CLI स्थानीय रूप से OPF फाइलों को बना सकता है, वैलिडेट कर सकता है, एडिट कर सकता है और निरीक्षण कर सकता है, उदाहरण के लिए शीर्षक के साथ एक डेक बनाना, फाइल को वैलिडेट करना, या इन-प्लेस पैच लागू करना। एक CLI 0.5.0 कमांड AI एजेंटों के लिए एक प्रोजेक्ट में छह OPF स्किल्स इंस्टॉल करता है, जो लोकल प्रतियों का उपयोग करता है, मौजूदा निर्देशों को सुरक्षित रखता है और कस्टमाइज़्ड स्किल्स को ओवरराइट करने से मना करता है, जिसमें दस्तावेज़ित लक्ष्य और प्री-रिलीज़ टेस्टिंग शामिल हैं। दस्तावेज़ीकरण में एजेंट स्किल्स, LLM ऑथरिंग, डायनेमिक कंपोजिशन और लोकल इकोसिस्टम वेरिफिकेशन शामिल हैं। रिपॉजिटरी लेआउट की मुख्य विशेषताएं: टॉप-लेवल Presentation दस्तावेज़ों के लिए कैनोनिकल JSON Schema; दस्तावेज़ मॉडल, कंटेंट शेप्स, कैटलॉग रिज़ॉल्यूशन और वैलिडेशन दर्शन का वैचारिक परिचय; एक डिज़ाइन प्रेसिडेंस एल्गोरिदम (स्लाइड डिज़ाइन, डेक डिज़ाइन, रिज़ॉल्व्ड थीम, इंजन डिफॉल्ट्स); टॉप-लेवल फील्ड्स, स्कीमा डेफिनिशन, साथी कैटलॉग स्कीमा और चार्ट और टेबल सहित स्लाइड/रीजन कंटेंट पेलोड के लिए लेखक-केंद्रित संदर्भ; तकनीकी फिक्स्चर और परिदृश्य-उन्मुख गैलरी उदाहरणों के लिए गाइड; ब्राउज़र कैनवस, फ़ॉन्ट लोडिंग और वर्तमान फिडेलिटी सीमाओं पर लाइव एडिटर नोट्स; और एक मेंटेनर रिलीज़ रनबुक। डाउनस्ट्रीम सेवाओं के लिए एक वैकल्पिक संदर्भ OpenAPI कॉन्ट्रैक्ट मौजूद है जो HTTP पर OPF को एक्सपोज़ करना चुनते हैं, लेकिन OpenPresentation उस API को होस्ट नहीं करता है। इकोसिस्टम सीमा: रेंडर, एडिट और कन्वर्ट क्षमताएं अलग-अलग MIT सिबलिंग रिपॉजिटरीज़ में रहती हैं — opf-render (OPF से SVG/PNG/PDF), opf-editor (हेडलेस एडिटर प्रिमिटिव्स और वैकल्पिक UI कंपोनेंट्स) और opf-pptx (प्योर लोकल PPTX इम्पोर्ट/एक्सपोर्ट)। ये केवल ओपन-सोर्स प्रिमिटिव्स प्रदान करते हैं; डाउनस्ट्रीम एप्लिकेशन होस्टिंग, ऑथेंटिकेशन, स्टोरेज, सहयोग, क्यू, प्रीव्यू, एनालिटिक्स, सपोर्ट और वर्कफ़्लो UX के मालिक होते हैं। भविष्य के Python और Go पैकेज के उसी लोकल-फर्स्ट सीमा का पालन करने की उम्मीद है, जो बिना किसी आवश्यक नेटवर्क कॉल या छिपे हुए टेलीमेट्री के स्कीमा, मॉडल, कैटलॉग, वैलिडेशन और पैकेज-एड्रेसेबल एसेट्स को एक्सपोज़ करेंगे। मानव-ब्राउज़ेबल कैटलॉग प्रीसेट्स जैसे लेआउट, थीम, कलर और फ़ॉन्ट स्कीम, चार्ट प्रकार, नैरेटिव्स, ऑडियंस, उद्देश्य, टोन, भाषाएं और सोशल प्लेटफॉर्म pptx.gallery के माध्यम से संदर्भित हैं।