Deployment ar

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

تشغيل docxi في بيئة الإنتاج ونشر الإصدارات

مكتبة docxi مكتبة وليست خدمة، لذا لا يوجد ما يُنشر منها بمفردها. تتناول هذه الصفحة ما يهم عند نشر تطبيق يستخدم docxi، وكيف تُنشر الإصدارات الجديدة من docxi.

نشر تطبيق يستخدم docxi

• الاعتماديات. يثبّت bundle install المكتبتين nokogiri وrubyzip. توفّر nokogiri حزمًا مُصرَّفة مسبقًا لمنصات Linux وmacOS وWindows الشائعة. أما على المنصات الأخرى، مثل بعض صور الحاويات المصغّرة، فتُصرَّف من الشيفرة المصدرية وتحتاج إلى مصرّف C. راجع دليل تثبيت nokogiri.
• لا حاجة إلى برامج مكتبية. لا تحتاج الخوادم والحاويات إلى Microsoft Word أو LibreOffice.
• الذاكرة. تبني render المستند كاملًا في الذاكرة وتعيده ككائن StringIO. يزداد استهلاك الذاكرة بزيادة عدد الصفحات وحجم الصور.
• الشبكة والملفات. لا تقرأ docxi نظام الملفات إلا لمسارات الصور التي تمررها إلى add_media، ولا تستخدم الشبكة إلا لعناوين URL للصور التي تمررها. راجع الأمان.
• المستندات الطويلة. ابنِها في مهمة في الخلفية بدلًا من بنائها أثناء طلب ويب. راجع التكامل.

كيف تُنشر إصدارات docxi

هذه الخطوات موجّهة إلى القائمين على الصيانة. تُنشر الإصدارات على RubyGems عبر GitHub Actions باستخدام النشر الموثوق (trusted publishing)، لذا لا يُخزَّن أي مفتاح API في المستودع.

1. حدّث lib/docxi/version.rb وCHANGELOG.md، وادمج التغييرات في master.
2. ضع على الإيداع (commit) وسمًا باسم الإصدار مسبوقًا بالحرف v، مثل v0.1.1، ثم ادفع الوسم.
3. يبني .github/workflows/release.yml الحزمة ويدفعها إلى RubyGems.

تتبع الإصدارات التجريبية الخطوات نفسها برقم إصدار مثل 0.2.0.rc1. لا يثبّت Bundler الإصدارات التجريبية إلا عند طلبها صراحةً. تعمل CI ‏(.github/workflows/ci.yml) مع كل دفع إلى master ومع كل طلب سحب (pull request).

صفحات ذات صلة

• التثبيت
• إعداد بيئة التطوير
• سجل التغييرات

---

→ الصفحة الرئيسية للويكي · README