Paperclip Meta 项目技术文档

1. 安装指南

1.1 添加 Gem

首先，将 paperclip-meta 添加到项目的 Gemfile 中：

gem 'paperclip-meta'

1.2 创建迁移

接下来，创建一个迁移文件，用于添加 *_meta 列到相应的数据库表中。例如，如果你有一个 users 表，并且想要为用户的头像添加元数据，可以创建如下迁移：

class AddAvatarMetaToUsers < ActiveRecord::Migration
  def change
    add_column :users, :avatar_meta, :text
  end
end

1.3 重建缩略图

如果你已经有一些附件，需要重建所有缩略图以填充 meta 列。

2. 项目的使用说明

2.1 获取图像尺寸

安装并配置完成后，你可以通过以下方式获取图像的尺寸信息：

image_tag user.avatar.url, size: user.avatar.image_size
image_tag user.avatar.url(:medium), size: user.avatar.image_size(:medium)
image_tag user.avatar.url(:thumb), size: user.avatar.image_size(:thumb)

2.2 使用内置方法

paperclip-meta 提供了一些内置方法来获取图像的宽度、高度、尺寸和宽高比：

user.avatar.width(:thumb)
=> 100
user.avatar.height(:medium)
=> 200
user.avatar.image_size
=> '60x70'
user.avatar.aspect_ratio
=> 1.5

你可以将图像样式传递给这些方法，如果没有传递样式，默认使用默认样式。

3. 项目API使用文档

3.1 获取图像宽度

user.avatar.width(style = nil)

• style: 可选参数，指定图像样式。如果不传递，使用默认样式。

3.2 获取图像高度

user.avatar.height(style = nil)

• style: 可选参数，指定图像样式。如果不传递，使用默认样式。

3.3 获取图像尺寸

user.avatar.image_size(style = nil)

• style: 可选参数，指定图像样式。如果不传递，使用默认样式。

3.4 获取图像宽高比

user.avatar.aspect_ratio(style = nil)

• style: 可选参数，指定图像样式。如果不传递，使用默认样式。

4. 项目安装方式

4.1 通过 Gemfile 安装

将 paperclip-meta 添加到 Gemfile 中，然后运行 bundle install 进行安装：

gem 'paperclip-meta'

4.2 手动安装

你也可以手动安装 paperclip-meta：

gem install paperclip-meta

4.3 测试安装

安装完成后，可以通过以下命令运行测试：

bundle
bundle exec rake

通过以上步骤，你可以成功安装并使用 paperclip-meta 来获取图像的尺寸信息。