SpreadsheetOnRails 使用与技术文档

1. 安装指南

在 Rails 3 项目中，首先将以下内容添加到你的 Gemfile 文件中，然后执行 bundle 命令。

gem "spreadsheet_on_rails"

执行以下命令，确保宝石被正确安装：

bundle install

2. 项目的使用说明

SpreadsheetOnRails 是一个基于 rxls 模板的xls文档生成宝石，它允许你在 Rails 项目中生成 Excel 文件，而不需要 Java 部分。

在你的 Rails 控制器中，添加对新格式的支持，如下所示：

class HomeController < ApplicationController

  def index
    respond_to do |format|
      format.html
      format.xls { render :xls => "filename" }
    end
  end
end

创建一个xls视图 app/views/home/index.rxls，然后按照以下示例编写内容：

sheet = workbook.create_worksheet
sheet.name = "What's in a name"

sheet.row(0).concat %w{Name Country Acknowlegement}
sheet[1,0] = 'Japan'
row = sheet.row(1)
row.push 'Creator of Ruby'
row.unshift 'Yukihiro Matsumoto'
sheet.row(2).replace [ 'Daniel J. Berger', 'U.S.A.',
                      'Author of original code for Spreadsheet::Excel' ]
sheet.row(3).push 'Charles Lowe', 'Author of the ruby-ole Library'
sheet.row(3).insert 1, 'Unknown'
sheet.update_row 4, 'Hannes Wyss', 'Switzerland', 'Author'

这个视图基本上允许你直接使用 spreadsheet 宝石进行编写。

3. 项目API使用文档

SpreadsheetOnRails 的API使用与 spreadsheet 宝石紧密集成。以下是一些基本用法：

• workbook.create_worksheet: 创建一个新的工作表。
• sheet.name: 设置工作表的名称。
• sheet.row(0).concat: 在第一行中添加标题。
• sheet[行索引, 列索引] = 值: 在指定单元格中设置值。
• sheet.row(行索引).push: 在行末添加值。
• sheet.row(行索引).insert: 在行首插入值。
• sheet.update_row: 更新整行的值。

更多详细信息，请参考 spreadsheet 宝石的官方文档。

4. 项目安装方式

请遵循以下步骤安装 SpreadsheetOnRails：

1. 将 gem "spreadsheet_on_rails" 添加到你的 Rails 3 项目的 Gemfile 中。
2. 运行 bundle install 命令。
3. 在控制器中添加对 xls 格式的响应支持。
4. 创建 xls 视图文件，并使用 spreadsheet 宝石的语法编写内容。

按照以上步骤操作，你就可以在 Rails 应用中使用 SpreadsheetOnRails 生成 Excel 文档了。