1. 产品
  2.   字处理
  3.   Ruby
  4.   PureDocx
 
  

开源 Ruby API 用于创建 Word DOCX 文档

领先的免费 Ruby 库，帮助开发者创建 Word 文档，添加并自定义表格，插入图像，在 Ruby 应用中应用换行和文本格式化。

PureDocx 库是什么？

PureDocx 是一个强大、开源的 Ruby 库，简化了在 Ruby 应用中创建 Microsoft Word .docx 文件的过程。它提供了一种直接且直观的方式以编程方式生成 Word 文档，是需要即时创建报告、发票或其他任何类型文档的软件开发者的极佳工具。在其核心，PureDocx 允许您定义具有页眉和内容的文档。页眉会在文档的每一页出现，而内容则会在页面之间流动。

PureDocx 库是任何需要生成 .docx 文件的 Ruby 开发者的绝佳库。其简洁的 API、灵活的功能以及开源特性使其成为各种应用的首选。其干净直观的 API 让开发者只需最少的代码即可创建复杂文档。支持文本、图像和表格，PureDocx 为您提供了创建多种文档的灵活性。其优雅的 DSL、对页眉/页脚、图像和表格的支持，以及与流行办公套件的兼容性，使其成为报告生成和文档自动化的理想选择。

Previous Next

开始使用 PureDocx

推荐的安装 PureDocx 方式是使用 RubyGems。请使用以下命令进行平稳安装。

通过 RubyGems 安装文档

 gem install ruby-docx-templater

如何在 Ruby 应用中创建 Word 文档？

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

通过 Ruby 创建 Word 文档

开源的 PureDocx 库已完整支持在 Ruby 应用中创建和管理 Word 文档。在其核心，PureDocx 允许您定义具有页眉和内容的文档。页眉会在文档的每一页出现，而内容则会在页面之间流动。软件开发者可以轻松应用各种格式、添加表格和图像并插入内容。以下是一个基本示例，展示如何使用 Ruby 命令创建 Word 文档。

如何通过 Ruby API 在 Word 文档中应用文本格式化？

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 Ruby 库让软件开发者可以轻松在 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')

通过 Ruby 在 Word 文件中创建并自定义表格

表格是组织和展示文档内数据的强大方式。PureDocx 库通过 Ruby 库在 Word 文档中创建具有自定义样式的表格变得很容易。软件开发者还可以通过多种选项自定义表格外观，例如设置表格宽度、定义单元格的顶部和左侧内边距、指定哪些边不需要边框、设置各列宽度、指定哪些边需要粗边框等。以下示例展示了如何在 Ruby 应用中创建一个简单表格。

通过 Ruby 应用分页、换行和新页面

开源的 PureDocx 库为在 Ruby 应用中处理工作文档提供了多种选项。该库允许您轻松向文档添加页码。您可以将页码在页脚的位置设为“左侧”“右侧”或“居中”。您可以使用 brake 方法添加换行，使用 new_page 方法开始新页。以下示例展示了如何在 Word 文档中应用换行并添加新页。

 中国人