1. Продукти
  2.   Обробка текстів
  3.   Ruby
  4.   Caracal
 
  

Безкоштовний API Ruby для створення та обробки Word DOCX 

Бібліотека Ruby з відкритим кодом, яка дає програмістам можливість створювати професійні документи Office Word, змінювати файли DOCX, додавати поля сторінок, вставляти вкладені таблиці за допомогою синтаксису, подібного до HTML.

Бібліотека Caracal дає розробникам Ruby можливість створювати професійні документи Office Word у своїх власних програмах за допомогою HTML-подібного синтаксису. Бібліотека полегшує роботу розробників, дозволяючи їм використовувати деякі прості команди для створення та керування Office Open XML (OOXML). Бібліотека є відкритим кодом і доступна за ліцензією MIT.

Бібліотека дуже добре розроблена, і вона відокремлює інструкції для розбору документа від інструкцій для обробки. Ця стратегія надає процесу візуалізації велику кількість гнучкості. Бібліотека містить кілька важливих функцій, пов’язаних із обробкою текстових документів, таких як створення текстових документів, налаштування розміру сторінки, підтримка полів сторінки, розрив сторінки, номери сторінок, підтримка шрифтів, підтримка стилів і форматування, додавання абзацу, використання посилань і закладок, вставлення таблиці, підтримка вкладених таблиць, підтримка зображень та багато іншого.

Previous Next

Початок роботи з Каракалом

Будь ласка, додайте Gemfile наступної командної програми для плавного використання бібліотеки.

Встановіть Caracal, додавши код до Gemfile програми

 gem 'caracal'

Встановіть Caracal, додавши код до Gemfile програми

bundle install

Створення файлів Word Docx за допомогою Ruby

Бібліотека Caracal з відкритим кодом дозволяє розробникам Ruby створювати файли DOCX у своїх програмах за допомогою коду Ruby. Формат файлу DOCX — це заархівована колекція документів XML, створена за стандартом OOXML. Бібліотека допомагає програмістам, створюючи всю структуру документа та заархівувавши вихідні документи. Бібліотека підтримує зміну існуючих файлів, налаштування розміру сторінки, налаштування полів, застосування стилів і багато іншого.

Створити документи Word за допомогою бібліотеки Ruby Caracas

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 рівнів стилів за замовчуванням як для впорядкованих, так і для невпорядкованих списків.

Як використовувати списки у документах Word через бібліотеку Ruby

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. Бібліотека містить кілька функцій, пов’язаних із обробкою абзаців, наприклад вирівнювання тексту, вибір шрифтів, визначення кольору та розміру шрифту, налаштування кольору фону, застосування вертикального вирівнювання тощо. Він також забезпечує підтримку для легкого вставлення закладок безпосередньо в документ або всередині блоків абзаців.

Додати закладки до документів Word за допомогою бібліотеки Ruby

# 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
 Українська