Ruby gem 用于从用户名(或任何其他字符串 :-) )创建字母头像。
Gem for creating letter avatar from user's name (or any other strong / character).
Code extracted from discourse source (thanks guys!) - I needed this functionality in three projects, so here's the gem! :-)
System requirements
$ sudo apt-get install -y imagemagickMac OS X
$ brew install imagemagick ghostscriptAdd this line to your application's Gemfile:
gem 'letter_avatar'And then execute:
$ bundleOr install it yourself as:
$ gem install letter_avatarLetterAvatar.setup do |config|
config.fill_color = 'rgba(255, 255, 255, 1)' # default is 'rgba(255, 255, 255, 0.65)'
config.cache_base_path = 'public/system/lets' # default is 'public/system'
config.colors_palette = :iwanthue # default is :google
config.weight = 500 # default is 300
config.annotate_position = '-0+10' # default is -0+5
config.letters_count = 2 # default is 1
config.pointsize = 70 # default is 140
endWe have three color palettes implemented: iwanthue, google and custom.
Each of them have different colors, but the iwanthue also differently calculates the color for specified username.
The google selected will generate the same avatar for both, "Krzysiek" and "ksz2k" usernames given (both of them starts with letter "k"), but iwanthue will calculate it's md5 and then selects color, so there's huge chance that these usernames get different colors.
You can define your own custom palette:
LetterAvatar.setup do |config|
config.colors_palette = :custom
config.custom_palette = [[120, 132, 205], [91, 149, 249], [72, 194, 249], [69, 208, 226]]
endYou can define your own custom palette:
LetterAvatar.setup do |config|
config.font = File.join(File.expand_path('../../', File.dirname(__FILE__)), 'app/assets/fonts', 'font_name.ext')
endLetterAvatar.generate 'ksz2k', 200
=> "public/system/letter_avatars/2/K/87_178_230/200.png"There's also helper for this. To use it, you need:
in your helper (eg. ApplicationHelper) or controller:
include LetterAvatar::AvatarHelperand in your view:
letter_avatar_for('ksz2k', 200)
=> "public/system/letter_avatars/2/K/87_178_230/200.png"
# or
letter_avatar_url('ksz2k', 200)
=> "/system/letter_avatars/2/K/87_178_230/200.png"
# or even
letter_avatar_tag('ksz2k', 200, class: 'av')
=> ""Say, you have a model User (which must have attribute or method name)
require 'letter_avatar/has_avatar'
class User
include LetterAvatar::HasAvatar
...
def name
'ksz2k'
end
endThen, in your views you can use:
@user.avatar_path(200)
=> "public/system/letter_avatars/2/K/87_178_230/200.png"
# or
@user.avatar_url(200)
=> "/system/letter_avatars/2/K/87_178_230/200.png"class User
def username_for_avatar
# Translate Chinese hanzi to pinyin
# https://github.com/flyerhzm/chinese_pinyin
Pinyin.t(self.username)
end
endThen you can get right avatar now:
letter_avatar_for(user.username_for_avatar, 200)
# or
letter_avatar_tag(user.username_for_avatar, 200, class: 'av')git checkout -b my-new-feature)git commit -am 'Add some feature')git push origin my-new-feature)暂无开放 Issues,或尚未同步最近议题。