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 позволяет создавать сложные документы с минимальным кодом. Поддержка текста, изображений и таблиц даёт гибкость для создания разнообразных документов. Элегантный 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

Библиотека PureDocx для Ruby упрощает разработчикам создание и применение различных стилей и форматирования к содержимому внутри документов 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.')
 Русский