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

Відкритий Ruby API для створення Word DOCX документів

Ведуча безкоштовна Ruby бібліотека, яка дозволяє розробникам створювати Word документи, додавати та налаштовувати таблиці, вставляти зображення, застосовувати розрив рядка та форматування тексту у Word документах всередині Ruby‑застосунків.

Що таке бібліотека PureDocx?

PureDocx — потужна відкрита бібліотека Ruby, що спрощує процес створення Microsoft Word .docx файлів у Ruby‑застосунках. Вона надає простий і інтуїтивний спосіб програмно генерувати Word документи, що робить її відмінним інструментом для розробників, які потрібно швидко створювати звіти, рахунки‑фактури або будь‑які інші документи. У своїй основі PureDocx дозволяє визначити документ з верхнім колонтитулом і вмістом. Верхній колонтитул буде відображатися на кожній сторінці, а вміст плавно переходить з однієї сторінки на іншу.

Бібліотека PureDocx — фантастичний інструмент для будь‑якого Ruby‑розробника, який потребує генерувати .docx файли. Її просте API, гнучкі можливості та відкритий характер роблять її провідним вибором для широкого спектру застосувань. Чисте та інтуїтивне API дозволяє розробникам створювати складні документи з мінімальним кодом. Підтримка тексту, зображень і таблиць дає PureDocx гнучкість у створенні різноманітних документів. Елегантний DSL, підтримка верхніх/нижніх колонтитулів, зображень і таблиць, а також сумісність з популярними офісними пакетами роблять її чудовим вибором для генерації звітів та автоматизації документів.

Previous Next

Перші кроки з PureDocx

Рекомендований спосіб встановлення PureDocx — використання RubyGems. Будь ласка, скористайтеся наступною командою для плавного встановлення.

Встановлення документів через RubyGems


$ gem 'puredocx

// Or install it yourself as

$ gem install PureDocx
You can also download it directly from GitHub.

Створення Word документів за допомогою Ruby

Відкрита бібліотека PureDocx надає повну підтримку створення та керування Word документами всередині Ruby‑застосунків. У своїй основі PureDocx дозволяє визначити документ з верхнім колонтитулом і вмістом. Верхній колонтитул з'являтиметься на кожній сторінці, а вміст плавно переходить з однієї сторінки на іншу. Розробники можуть застосовувати різні типи форматування, додавати таблиці та зображення та легко вставляти вміст. Ось простий приклад, який показує, як створити Word документ за допомогою Ruby‑команд.

Як створити Word документ всередині Ruby‑застосунків?

PureDocx.create('my_document.docx') do |doc|
  doc.header([
    doc.text('My Awesome Document Header')
  ])
  doc.content([
    doc.text('This is the main content of my document.')
  ])
end

Застосування форматування тексту у документах за допомогою Ruby

Ruby‑бібліотека PureDocx спрощує розробникам створення та застосування різних стилів і форматування до вмісту в Word документах. Бібліотека пропонує багато варіантів форматування тексту, включаючи жирний чи курсивний стиль, встановлення розміру шрифту, вирівнювання тексту ліворуч, по центру або праворуч тощо. Ось простий приклад, який демонструє, як розробники можуть застосовувати різні параметри форматування до тексту в Word документі.

Як застосувати форматування тексту у Word документах через Ruby API?

Створення та налаштування таблиць у Word файлах за допомогою Ruby

Таблиці — потужний спосіб організувати та відображати дані у ваших документах. Бібліотека PureDocx спрощує створення таблиць з кастомним стилем у Word документах за допомогою Ruby. Розробники можуть також налаштувати зовнішній вигляд своїх таблиць за допомогою різних параметрів, таких як встановлення ширини таблиці, визначення відступу зверху та зліва для клітинок, вказання, які сторони таблиці не повинні мати межі, встановлення ширини окремих колонок, вказання, які сторони таблиці повинні мати жирну межу тощо. Нижче наведений приклад показує, як створити просту таблицю в Ruby‑застосунках.

Як створити просту таблицю всередині Ruby‑застосунків?


table_data = [
  [{ column: [doc.text('Column 1')] }, { column: [doc.text('Column 2')] }],
  [{ column: [doc.text('Row 2, Col 1')] }, { column: [doc.text('Row 2, Col 2')] }]
]
doc.table(table_data)

Як налаштувати таблицю за допомогою користувацького стилю через Ruby API?


table_options = {
  table_width: 8000,
  paddings: { top: 100, left: 100 },
  sides_without_border: [:top, :bottom],
  bold_sides: [:left, :right],
  col_width: [4000, 4000]
}
doc.table(table_data, table_options)

Застосування пагінації, розриву рядка та нових сторінок за допомогою Ruby

Відкрита бібліотека PureDocx пропонує різні можливості для роботи з документами у Ruby‑застосунках. Бібліотека дозволяє легко додавати номери сторінок до документів. Ви можете вказати розташування номерів сторінок у нижньому колонтитулі як «лівий», «правий» або «центр». Ви можете використати метод brake для додавання розриву рядка та метод new_page для створення нової сторінки. Нижче наведений приклад показує, як застосувати розрив рядка та додати нові сторінки в Word документах.

Як застосувати розриви рядка та додати нові сторінки через Ruby?


doc.text('This is the first line.')
doc.brake
doc.text('This is the second line.')
doc.new_page
doc.text('This is on a new page.')
 Українська