Installation ar

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

تثبيت docxi: المتطلبات وإعداد Bundler والترقية

مكتبة docxi حزمة مكتوبة بلغة Ruby بالكامل. يجلب تثبيتها اعتماديتين فقط، هما nokogiri وrubyzip، ولا شيء غيرهما. لا حاجة إلى أي برنامج مكتبي.

المتطلبات

المتطلب	الإصدار
لغة Ruby	الإصدار 2.5 أو أحدث
مكتبة nokogiri	>= 1.8, < 2، تُثبَّت تلقائيًا
مكتبة rubyzip	>= 1.3, < 4، تُثبَّت تلقائيًا
إطار Rails	غير مطلوب

التثبيت باستخدام Bundler

أضف الحزمة إلى ملف Gemfile:

gem "docxi", "~> 0.1"

ثم ثبّتها:

bundle install

التثبيت دون Bundler

gem install docxi

التحقق من التثبيت

ruby -e 'require "docxi"; puts Docxi::VERSION'

في مشروع يستخدم Bundler، شغّله بالشكل bundle exec ruby -e 'require "docxi"; puts Docxi::VERSION'. يطبع الأمر الإصدار المثبّت، مثل 0.1.0.

الترقية من 0.0.x

إذا كان ملف Gemfile يثبّت docxi على إصدار 0.0.x، مثل "~> 0.0.6"، فغيّر السطر إلى gem "docxi", "~> 0.1". ثم شغّل bundle update docxi. لا حاجة إلى أي تغيير في الشيفرة، فالإصدار 0.1.0 يولّد المستندات نفسها التي يولّدها 0.0.6، إذ تقارن مجموعة الاختبارات المخرجات بملفات ولّدها الإصدار 0.0.6.

ما الذي تغيّر داخليًا:

• يمكن الآن أن تكون nokogiri وrubyzip بأي إصدار ضمن النطاقات السابقة، لذا تُثبَّت docxi إلى جانب إصدارات Rails الحالية.
• لم تعد docxi تحتاج إلى تحميل ActiveSupport.
• تُكتب الأرشيفات دون سجلات Zip64.
• تُحمَّل الصور دون Kernel#open، لذا تعمل عناوين URL على Ruby 3.
• تعمل الآن tab وframe وأرقام الصفحات في رؤوس الصفحات.

التطبيقات التي تعمل بإصدار Ruby أقدم من 2.5 تستمر في الحصول على 0.0.6، لأن الإصدار 0.1.0 يحدد Ruby 2.5 حدًا أدنى. يسرد سجل التغييرات كل التغييرات.

الإصدارات المختبرة في CI

يعمل كل إصدار من Rails مع تحميل إطار العمل كاملًا إلى جانب docxi.

إصدار Ruby	إصدار Rails
2.5	5.2
2.7	6.0
3.0	6.1
3.1	7.0
3.2	7.1
3.3	7.2
3.4	8.0
4.0	8.1

تشغّل CI أيضًا:

• الاختبارات دون Rails على Ruby 2.5 و2.6 و4.0
• اختبارات مع rubyzip 1.3 ‏(Ruby 2.5) وrubyzip 2.4 ‏(Ruby 3.3) وnokogiri 1.11 ‏(Ruby 2.5)
• فحصًا للتأكد من أن LibreOffice يستطيع تحويل المستندات النموذجية

ملاحظات حول المنصات

• توفّر nokogiri حزمًا مُصرَّفة مسبقًا لمنصات Linux وmacOS وWindows الشائعة. وحين لا تتوفر حزمة مطابقة، تُصرَّف من الشيفرة المصدرية وتحتاج إلى مصرّف C. راجع دليل تثبيت nokogiri.
• تعمل CI على Ubuntu 24.04، كما شُغّلت الاختبارات على macOS. أما Windows فلم يُختبر.

إذا فشل التثبيت

تعارضات Bundler حول nokogiri أو rubyzip تعني في الغالب أن الإصدار القديم docxi 0.0.6 هو الذي يجري حلّه. راجع استكشاف الأخطاء وإصلاحها.

صفحات ذات صلة

• البدء
• الإعدادات
• النشر

---

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