opf

Open Presentation Format (OPF) سلائیڈ ڈیکس کے لیے ایک پورٹیبل، انسان کے پڑھنے کے قابل JSON دستاویز فارمیٹ ہے۔ یہ ریپوزٹری فارمیٹ کی تفصیلات (specification)، JSON Schemas، کیٹلاگ پری سیٹس، مثالوں، تیار کردہ ڈویلپر ٹائپس، مقامی تصدیق کے ٹولز اور مستقبل کے render/edit/convert ٹول کٹ کے لیے منصوبہ بندی کی دستاویزات کا مرکزی گھر ہے۔ اسے npm پر @openpresentation/opf کے طور پر شائع کیا گیا ہے، جو فی الحال پری-اسٹیبل (0.x) ہے، اور MIT لائسنس کے تحت دستیاب ہے۔ مقصد: .pptx ایک زپ شدہ XML بنڈل ہے جسے انسانوں کے لیے diff کرنا، ماڈلز کے لیے قابلِ بھروسہ طریقے سے پڑھنا اور لکھنا، اور git کے لیے بامعنی طور پر ٹریک کرنا مشکل ہے، کیونکہ ہر تبدیلی ایک بائنری blob کی طرح نظر آتی ہے۔ OPF سادہ JSON ہے — جو ایڈیٹر میں پڑھا جا سکتا ہے، کسی ماڈل کے ذریعے مثالوں سے اسکیما کا اندازہ لگائے بغیر لکھا جا سکتا ہے، اور دیگر کاموں کے ساتھ ورژن کنٹرول میں ٹریک کیا جا سکتا ہے۔ اس کا بیان کردہ مقصد LLMs کو مارک اپ ٹیگز سے لڑنے کے بجائے ڈیکس کی تیاری (بیانیہ ڈھانچہ، فریمینگ، ڈیٹا تجزیہ، چارٹ تجاویز، نظرثانی) میں حصہ لینے دینا ہے۔ روایات اور نامکالر: OPF دستاویزات مکمل پریزنٹیشنز کے لیے *.opf.json (مثال کے طور پر board-review.opf.json) نامی JSON فائلیں ہوتی ہیں۔ پروجیکٹ صرف *.opf ایکسٹینشن کے استعمال کے خلاف مشورہ دیتا ہے کیونکہ یہ پہلے ہی دیگر دستاویزات اور پروجیکٹ فارمیٹس میں استعمال ہو رہا ہے۔ Open Presentation Format کا نام اور اس کے اسکیماز، کیٹلاگز، پیکیجز اور مقامی ٹولز کو تیسرے فریق کے ٹولز کے ذریعے پڑھنے، لکھنے، تصدیق کرنے، رینڈر کرنے، تبدیل کرنے اور سپورٹ کی وضاحت کے لیے استعمال کیا جا سکتا ہے، بغیر کسی پروڈکٹ مخصوص برانڈنگ کے۔ JavaScript/TypeScript پیکیج کیا کرتا ہے: یہ spec/ سے کینونیکل اسکیماز اور بنڈل شدہ کیٹلاگ ریکارڈز، پیکیج-ایڈریس ایبل اسپیک مواد کے لیے ایک ٹائپڈ را (raw) اسپیک فائل مینی فیسٹ، Presentation کو ٹاپ لیول ٹائپ کے طور پر رکھنے والے تیار کردہ TypeScript types، اور OPF JSON اور کیٹلاگ ریکارڈز کے لیے مقامی تصدیق فراہم کرتا ہے۔ تصدیق کے نتیجے میں درستگی کے ساتھ ساتھ مشورتی وارننگز بھی ملتی ہیں، مثلاً نامعلوم کیٹلاگ IDs۔ اسکیماز، کیٹلاگز، اسپیک فائلوں، ویلیڈیٹر اور ٹائپس کے لیے فوکسڈ سب پاتھ امپورٹس دستیاب ہیں، اور انجن یا ریزولورز براہ راست را JSON اسکیماز کو امپورٹ کر سکتے ہیں۔ یہ پیکیج پیور کمپوزیشن جیومیٹری بھی فراہم کرتا ہے تاکہ ڈاؤن اسٹریم لائبریریز لے آؤٹ کے رویے میں یکسانیت رکھ سکیں۔ یہ واضح طور پر .pptx کو رینڈر یا پارس نہیں کرتا، AI کے ذریعے مواد تیار نہیں کرتا، ریموٹ کیٹلاگز حاصل نہیں کرتا، ہوسٹڈ APIs کو کال نہیں کرتا یا مینجڈ سروسز فراہم نہیں کرتا۔ مقامی ٹولنگ: ایک انسٹال ہونے والا MIT-لائسنسڈ CLI مقامی طور پر OPF فائلوں کو بنانے، تصدیق کرنے، ایڈٹ کرنے اور معائنہ کرنے کے لیے استعمال کیا جا سکتا ہے، مثلاً عنوان کے ساتھ ڈیک بنانا، فائل کی تصدیق کرنا، یا جگہ پر پیچ (patch) لگانا۔ ایک CLI 0.5.0 کمانڈ AI ایجنٹس کے لیے ایک پروجیکٹ میں چھ OPF اسکلز انسٹال کرتی ہے، مقامی کاپیوں کا استعمال کرتے ہوئے، موجودہ ہدایات کو محفوظ رکھتی ہے اور کسٹمائزڈ اسکلز کو اوور رائٹ کرنے سے انکار کرتی ہے، جس میں دستاویزی اہداف اور پری-ریلیز ٹیسٹنگ شامل ہے۔ دستاویزات میں ایجنٹ اسکلز، LLM authoring، ڈائنیمک کمپوزیشن اور مقامی ایکو سسٹم کی تصدیق شامل ہے۔ ریپوزٹری لے آؤٹ کی نمایاں خصوصیات: ٹاپ لیول 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 کے ذریعے دیا گیا ہے۔