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 install ruby-docx-templater

Как создать документ Word внутри Ruby‑приложения?

 git clone https://github.com/jawspeak/ruby-docx-templater.git
You can also download it directly from GitHub.

Создание документов Word с помощью Ruby

Открытая библиотека PureDocx включает полный набор функций для создания и управления документами Word внутри Ruby‑приложений. По своей сути PureDocx позволяет определить документ с заголовком и содержимым. Заголовок будет отображаться на каждой странице, а содержимое будет переходить от одной страницы к другой. Разработчики могут применять различные типы форматирования, добавлять таблицы и изображения, а также легко вставлять контент. Ниже приведён простой пример, показывающий, как создать документ Word с помощью команд Ruby.

Как применить текстовое форматирование в документе Word через Ruby API?

require 'docx_templater'

# Load your template file
doc = DocxTemplater::TemplateProcessor.new('invoice_template.docx')

# Define your data as a hash
data = {
  'COMPANY_NAME' => 'Acme Corporation',
  'INVOICE_NUMBER' => 'INV-2024-001',
  'INVOICE_DATE' => '2024-11-04',
  'CLIENT_NAME' => 'John Smith',
  'TOTAL_AMOUNT' => '$1,250.00'
}

# Render the document with your data
doc.render(data)

# Save the output
doc.save('output_invoice.docx')

Применение текстового форматирования в документах через Ruby

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

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

require 'docx_templater'

doc = DocxTemplater::TemplateProcessor.new('product_report.docx')

# Define items as an array of hashes
data = {
  'REPORT_TITLE' => 'Monthly Sales Report',
  'REPORT_DATE' => 'November 2024',
  'ITEMS_LIST' => [
    {
      'PRODUCT_NAME' => 'Laptop Pro 15"',
      'QUANTITY' => '5',
      'UNIT_PRICE' => '$1,200.00',
      'TOTAL' => '$6,000.00'
    },
    {
      'PRODUCT_NAME' => 'Wireless Mouse',
      'QUANTITY' => '12',
      'UNIT_PRICE' => '$25.00',
      'TOTAL' => '$300.00'
    },
    {
      'PRODUCT_NAME' => 'USB-C Cable',
      'QUANTITY' => '20',
      'UNIT_PRICE' => '$15.00',
      'TOTAL' => '$300.00'
    }
  ]
}

doc.render(data)
doc.save('output_sales_report.docx')

Создание и настройка таблиц в файлах Word через Ruby

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

Применение пагинации, разрывов строк и новых страниц через Ruby

Открытая библиотека PureDocx предоставляет различные возможности для работы с документами внутри Ruby‑приложений. Библиотека позволяет легко добавлять номера страниц в документы. Вы можете указать положение номеров страниц в нижнем колонтитуле как «слева», «справа» или «по центру». Для добавления разрыва строки используйте метод brake, а для начала новой страницы — метод new_page. Пример ниже демонстрирует, как применить разрыв строки и добавить новые страницы в документы Word.

 Русский