Home ar

English · 简体中文 · 繁體中文 · Español · العربية · Français · Português (Brasil) · Deutsch · हिन्दी · 日本語 · 한국어 · Русский · Bahasa Indonesia · Türkçe · Italiano · Tiếng Việt

ويكي docxi: إنشاء مستندات Word ‏(.docx) باستخدام Ruby

مكتبة docxi حزمة (gem) للغة Ruby تُنشئ ملفات Microsoft Word بصيغة .docx من خلال الشيفرة البرمجية. تدعم الفقرات والنص المنسّق والجداول والصور ورؤوس الصفحات وتذييلاتها وأرقام الصفحات والارتباطات التشعبية وجدول محتويات بسيطًا. لا تحتاج إلى Microsoft Word أو LibreOffice أو قالب، وتعمل في برامج Ruby العادية كما تعمل في تطبيقات Ruby on Rails.

يقدّم ملف README تعريفًا مختصرًا، أما هذا الويكي فيغطي كل الخيارات، ويضم وصفات جاهزة للنسخ، ويشرح طريقة عمل docxi من الداخل، ويساعدك عندما يحدث خطأ ما.

الإصدار الحالي: 0.1.1، ويتطلب Ruby 2.5 أو أحدث. راجع سجل التغييرات.

ابدأ من هنا

البداية مع docxi

• البدء: ثبّت الحزمة وأنشئ مستندك الأول
• التثبيت: المتطلبات، وBundler، والترقية من 0.0.x
• أمثلة الاستخدام: تقارير وفواتير وخطابات وجداول مبنية من البيانات، جاهزة للنسخ

بناء المستندات

• الميزات: كل عنصر والخيارات التي يقبلها
• الإعدادات: الهوامش وإعداد الصفحة والوحدات
• مرجع API: الأصناف والدوال في لمحة
• أفضل الممارسات: عادات تجنّبك المفاجآت المعتادة

عندما يحدث خطأ ما

• استكشاف الأخطاء وإصلاحها: رسائل الخطأ والمستندات التي لا تظهر كما ينبغي
• الأسئلة الشائعة: إجابات مختصرة عن الأسئلة الشائعة
• الأمان: الإبلاغ عن المشكلات والتعامل مع المدخلات غير الموثوقة

للتعمق أكثر

• البنية: كيف تتحول استدعاءات Ruby إلى حزمة .docx
• التكامل: وحدات التحكم في Rails وتطبيقات Rack والمهام في الخلفية
• النشر: تشغيل docxi في بيئة الإنتاج، وطريقة نشر الإصدارات
• المساهمة وإعداد بيئة التطوير
• خارطة الطريق وسجل التغييرات والشكر والتقدير

ما الذي تفعله docxi وما الذي لا تفعله

تُنشئ docxi مستندات جديدة. لا يمكنها فتح ملف .docx موجود أو تعديله، ولا ملء قالب Word، ولا تنفيذ دمج المراسلات. ليس فيها قوائم مرقمة ولا أنماط عناوين ولا جدول محتويات تلقائي، والصفحات دائمًا بمقاس US Letter وباتجاه عمودي. المشكلات المعروفة المخطط إصلاحها في الإصدار 0.2.0 مدرجة في خارطة الطريق.

الشكر والتقدير

صيانة docxi مسؤولية Hammad Maqbool في Phaedra Solutions. بدأت المكتبة عام 2016 انطلاقًا من docxer من تأليف Timur Gabdrakipov. راجع صفحة الشكر والتقدير لمزيد من التفاصيل.

اللغات

النسخة الإنجليزية هي النسخة المرجعية لهذا الويكي. روابط الترجمات موجودة في الشريط الجانبي وفي أعلى كل صفحة.

---

الإبلاغ عن مشكلة · README · RubyGems