عن المشروع

docx مكتبة مفتوحة المصدر بلغة JavaScript/TypeScript لإنشاء وتعديل مستندات .docx (مايكروسوفت وورد). يعرض ملف README الخاص بها واجهة برمجية تعريفية: تصف بنية المستند بكائنات مثل Document وParagraph وHeader وTable، فتُنتج المكتبة ملف .docx. ويُذكر أنها تعمل في Node وفي المتصفح. توجد الوثائق والأمثلة على docx.js.org، ويتضمن المستودع مجلد demo. يربط ملف README بعروض توضيحية للمتصفح على CodePen وJSFiddle، وأمثلة أطر العمل Angular وReact وVue.js على StackBlitz، وأمثلة Node على RunKit تغطي الفقرات البسيطة والمتقدمة، والنقاط النقطية، والجداول، والصور، والهوامش، واتجاه الصفحة الأفقي، والرؤوس والتذييلات. ويوصف أحد الأمثلة بأنه سيرة ذاتية أُنشئت باستخدام docx. إلى جانب الحزمة الأساسية، يوثّق ملف README نقاط دخول اختيارية: docx/shapes للأشكال ومجموعات الأشكال والمخططات مع الموصلات؛ وdocx/watermarks للعلامات المائية؛ وdocx/charts لمخططات Word الأصلية. وهذه مُستبعدة من الحزمة الرئيسية كي لا تحمل المستندات التي لا تستخدمها شيفرتها. ويعرض نموذج برمجي استيراد ChartRun وShapeRun وTextWatermark واستخدامها داخل Document مع أقسام ورؤوس وفقرات. وبالنسبة للصفحات التي لا تستخدم أداة تجميع، يذكر ملف README تحميل dist/shapes.umd.cjs أو dist/watermarks.umd.cjs أو dist/charts.umd.cjs بعد dist/index.umd.cjs، مما يضيف المتغيرات العامة docxShapes وdocxWatermarks وdocxCharts. يشير ملف README أيضًا إلى Docx.js Editor، وهو ملعب تفاعلي لكتابة الشيفرة ومعاينة النتائج في الوقت الفعلي، وإلى إرشادات المساهمة. ويسرد عددًا من الشركات والمنتجات كمستخدمين للمكتبة، ويتضمن شارات لإصدار npm، والتنزيلات الشهرية، وحالة سير عمل GitHub Actions، والثغرات المعروفة، وحالة الترحيب بطلبات السحب، وتغطية الشيفرة. وتُوزَّع المكتبة عبر npm تحت اسم الحزمة docx.