Ruby API בחינם ליצירה ועיבוד של DOCX 

תחילת העבודה עם קרקל

אנא הוסף את Gemfile של אפליקציית הפקודה הבאה לשימוש חלק של הספרייה.

 gem 'caracal'

bundle install

יצירת קבצי Word Docx באמצעות רובי

ספריית הקוד הפתוח Caracal מאפשרת למפתחי Ruby ליצור קבצי DOCX בתוך האפליקציות שלהם באמצעות קוד Ruby. פורמט הקובץ DOCX הוא אוסף מכווץ של מסמכי XML והוא נוצר באמצעות תקן OOXML. הספרייה מסייעת למתכנתים על ידי יצירת כל המבנה של המסמך ודוכסת לו את מסמכי הפלט. הספרייה תומכת בשינוי הקבצים הקיימים, התאמת גודל העמוד, הגדרת שוליים, החלת סגנונות ועוד ועוד.

Caracal::Document.save 'example.docx' do |docx|
  # page 1
  docx.h1 'Page 1 Header'
  docx.hr
  docx.p
  docx.h2 'Section 1'
  docx.p  'Lorem ipsum dolor....'
  docx.p
  docx.table @my_data, border_size: 4 do
    cell_style rows[0], background: 'cccccc', bold: true
  end
  # page 2
  docx.page
  docx.h1 'Page 2 Header'
  docx.hr
  docx.p
  docx.h2 'Section 2'
  docx.p  'Lorem ipsum dolor....'
  docx.ul do
    li 'Item 1'
    li 'Item 2'
  end
  docx.p
  docx.img 'https://www.example.com/logo.png', width: 500, height: 300
end

הוסף טבלאות וטבלאות מקוננות בקובצי Word

ספריית Caracal החינמית מאפשרת למפתחי תוכנה להוסיף ולשנות טבלאות למסמך ה-word שלהם עם כמה שורות בלבד של קוד Ruby. הספרייה כללה מספר פונקציות חשובות הקשורות לניהול טבלאות כגון הוספת כותרת, הוספת עמודות ושורות חדשות, עיצוב החלק העליון, התחתון או משמאל וימין, החלת סגנון על תא ספציפי, מיזוג או פיצול תאים ועוד רבים. הספרייה כללה גם תמיכה בטבלאות מקוננות.

השתמש ברשימות בתוך מסמכי Word

ספריית הקוד הפתוח של Caracal כללה תמיכה בשימוש ברשימות בתוך קבצי DOCX באמצעות פקודות Ruby. הספרייה מאפשרת להוסיף רשימות מסודרות וגם לא מסודרות בתוך מסמכי word. זה גם תומך ברשימות מקוננות עמוקות ובערבוב בשילוב אחר. אתה יכול בקלות להגדיר סגנונות עבור הרשימות. הספרייה תומכת ב-9 רמות של סגנונות ברירת מחדל עבור רשימות מסודרות ולא מסודרות כאחד.

docx.ol do
  li 'First item'
  li do
    text 'Second item with a '
    link 'link', 'http://www.google.com'
    text '.'
    br
    text 'This sentence follows a line break.'
  end
end

הוסף פסקה וסימניות לקובץ DOCX

ספריית Caracal סיפקה פונקציונליות להוספת פסקה למסמכי Word שלהם בקלות. הספרייה כללה מספר פונקציות הקשורות לטיפול בפסקאות, כגון יישור טקסט, בחירת גופנים, הגדרת צבע הגופן וגודל הגופן הגדרת צבע הרקע, החלת יישור אנכי וכן הלאה. זה גם מספק תמיכה להכנסת סימניות ישירות למסמך או בתוך בלוקים של פסקה בקלות.

# document-level bookmark
dox.bookmark_start id: 's1', name: 'section1'
docx.h2 'Section Heading'
docx.bookmark_end id: 's1'
docx.p  'Section content.'
# pargraph-level bookmark
docx.h2 'Section Heading'
docx.p do
  text 'Pretend this paragraph has a lot of text and we want to bookmark '
  bookmark_start id: 'p1', name: 'phrase1'
  text 'a single phrase'
  bookmark_end id: 'p1'
  text ' inside the larger block.'
end