منصوبے کے بارے میں

docx ایک اوپن سورس JavaScript/TypeScript لائبریری ہے جو .docx (Microsoft Word) دستاویزات بنانے اور تبدیل کرنے کے لیے استعمال ہوتی ہے۔ اس کا README ایک ڈیکلریٹو API پیش کرتا ہے: آپ Document، Paragraph، Header اور Table جیسی اشیاء کے ذریعے دستاویز کی ساخت بیان کرتے ہیں، اور لائبریری ایک .docx فائل تیار کرتی ہے۔ بتایا گیا ہے کہ یہ Node اور براؤزر دونوں میں کام کرتی ہے۔ دستاویزات اور مثالیں docx.js.org پر موجود ہیں، اور ریپوزٹری میں ایک demo فولڈر شامل ہے۔ README میں CodePen اور JSFiddle پر براؤزر ڈیموز، StackBlitz پر Angular، React اور Vue.js کے فریم ورک مثالیں، اور RunKit پر Node مثالیں لنک کی گئی ہیں جو سادہ اور جدید پیراگراف، بلٹ پوائنٹس، ٹیبل، تصاویر، مارجن، لینڈ اسکیپ اورینٹیشن، اور ہیڈر اور فوٹر کا احاطہ کرتی ہیں۔ ایک مثال کو docx کے ساتھ تیار کردہ CV بتایا گیا ہے۔ بنیادی پیکیج کے علاوہ، README اختیاری انٹری پوائنٹس کی دستاویز کرتا ہے: shapes، shapes کے گروپس اور connectors کے ساتھ diagrams کے لیے docx/shapes؛ watermarks کے لیے docx/watermarks؛ اور نیٹو Word charts کے لیے docx/charts۔ یہ مرکزی پیکیج سے باہر رکھے گئے ہیں تاکہ جو دستاویزات انہیں استعمال نہیں کرتیں ان میں ان کا کوڈ شامل نہ ہو۔ ایک کوڈ نمونہ ChartRun، ShapeRun اور TextWatermark درآمد کرنے اور انہیں sections، headers اور paragraphs والے Document کے اندر استعمال کرنے کو دکھاتا ہے۔ بغیر bundler والے صفحات کے لیے، README کہتا ہے کہ dist/index.umd.cjs کے بعد dist/shapes.umd.cjs، dist/watermarks.umd.cjs یا dist/charts.umd.cjs لوڈ کریں، جو docxShapes، docxWatermarks اور docxCharts globals شامل کرتے ہیں۔ README Docx.js Editor کی بھی نشاندہی کرتا ہے، جو کوڈنگ اور نتائج کو حقیقی وقت میں پیش نظارہ کرنے کے لیے ایک انٹرایکٹو پلے گراؤنڈ ہے، اور تعاون کی رہنما ہدایات کی طرف بھی۔ یہ کئی کمپنیوں اور مصنوعات کو لائبریری کے صارفین کے طور پر درج کرتا ہے، اور npm ورژن، ماہانہ ڈاؤن لوڈز، GitHub Actions ورک فلو اسٹیٹس، معلوم کمزوریوں، pull-request welcome اسٹیٹس اور code coverage کے بیجز شامل کرتا ہے۔ پروجیکٹ npm کے ذریعے docx پیکیج نام کے تحت تقسیم کیا جاتا ہے۔