Configuration ar

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

إعداد docxi: هوامش الصفحة وإعداد الصفحة والوحدات

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

هوامش الصفحة

تُمرَّر الهوامش عند إنشاء المستند:

require "docxi"

# جميع القيم بوحدة جزء من عشرين من النقطة، و1440 تساوي بوصة واحدة
word = Docxi::Document.new(top: 1440, right: 1080, bottom: 1440, left: 1080, header: 720, footer: 720)
word.document.p { |p| p.text "One-inch top and bottom margins" }

File.binwrite("margins.docx", word.render.string)

الخيار	القيمة الافتراضية	المعنى
top	720 ‏(0.5 بوصة)	الهامش العلوي
right	1440 ‏(بوصة واحدة)	الهامش الأيمن
bottom	720 ‏(0.5 بوصة)	الهامش السفلي
left	1440 ‏(بوصة واحدة)	الهامش الأيسر
header	190	المسافة من الحافة العليا للصفحة إلى رأس الصفحة
footer	200	المسافة من الحافة السفلى للصفحة إلى تذييل الصفحة

القاموس (Hash) الذي تمرره يحل محل القيم الافتراضية، لذا اضبط top وright وbottom وleft معًا. أي واحد من هذه الأربعة لا تضبطه يُكتب قيمةً فارغة. أما header وfooter فيعودان إلى 190 و200 عندما يكونان مفقودين أو فارغين.

حجم الصفحة واتجاهها

الصفحات بمقاس US Letter وباتجاه عمودي: 12240 × 15840 جزءًا من عشرين من النقطة، أي 8.5 × 11 بوصة. لا يمكن تغيير الحجم ولا الاتجاه في الإصدار 0.1.0.

الصفحة الأولى

تفعّل docxi دائمًا خيار «صفحة أولى مختلفة» في Word. تُستخدم رؤوس الصفحات وتذييلاتها المضافة عبر add_header وadd_footer بدءًا من الصفحة 2. أما الصفحة 1 فتستخدم add_first_header وadd_first_footer، لذا اضبطهما أيضًا إذا احتاجت الصفحة الأولى إلى رأس أو تذييل. راجع الميزات.

ما يحتويه كل مستند

• الخط الافتراضي هو Arial بحجم 12 نقطة.
• الأنماط المعرّفة: Normal وDefaultParagraphFont وTableNormal وTableCustom وNoList.
• تستخدم عناصر القائمة النقطية (ul: true) شرطةً كعلامة نقطية.
• تذكر خصائص المستند أن اسم التطبيق «Docxi Ruby Gem»، وتسجّل وقت توليد المستند.

الوحدات

الخيار	الوحدة
الخيار size: للنص	النقاط (تضاعفها docxi لتحويلها إلى أنصاف النقاط التي يستخدمها Word)
الهوامش، وleft: وright: للفقرة، وiwidth: للجدول، وheight: للصف	جزء من عشرين من النقطة (1440 لكل بوصة)
أحجام borders: للخلية	ثُمن النقطة
الخيار columns_width: وwidth: للخلية	تُضرب في 14.92 للحصول على أجزاء من عشرين من النقطة، وهي قريبة من البكسلات عند 96 نقطة في البوصة
الخيار style: للصورة المضمّنة	أطوال CSS مثل "120pt"
الخياران pH: وpV: للصورة المحددة الموضع	وحدة EMU ‏(914400 لكل بوصة)
ألوان النص والتعبئة	قيمة ست عشرية دون #، مثل "8B0000"
الخيار fill_color: للصورة	لون VML مع #، مثل "#00FF00"

صفحات ذات صلة

• الميزات
• مرجع API
• أفضل الممارسات

---

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