# Andy Rails Toolbox [](http://badge.fury.io/rb/andy_rails_toolbox)
Andy Rails Toolbox includes many useful helpers for rails development.
## Installation
Add this line to your application's Gemfile:
```ruby
gem 'andy_rails_toolbox'
```
And then execute:
$ bundle
Or install it yourself as:
$ gem install andy_rails_toolbox
## Usage
#### BootstrapHelper
Bootstrap Homepage: http://getbootstrap.com/
Add below codes to layout `app/views/layout/application.html.erb`
``` erb
...
<%= stylesheet_link_tag '//maxcdn.bootstrapcdn.com/bootstrap/3.3.1/css/bootstrap.min.css' %>
...
<%= javascript_include_tag '//maxcdn.bootstrapcdn.com/bootstrap/3.3.1/js/bootstrap.min.js' %>
...
```
Examples
ICONS
``` ruby
bs_icon 'user'
# =>
```
LINK BUTTONS
``` ruby
link_button 'link_label', '/'
# => link_label
link_button 'link_label', '/', color: 'primary'
# => link_label
link_button 'link_label', '/', size: 'sm'
# => link_label
link_button 'link_label', '/', block: true
# => link_label
link_button 'link_label', '/', active: true
# => link_label
link_button 'link_label', '/', disabled: true
# => link_label
link_button 'link-button', '/', class: 'preset-class'
# => link_label
link_button 'link-button', '/', label_hidden: 'xs'
# => link_label
link_button 'link_label', '/', icon: 'user'
# => link_label
```
BUTTONS
``` ruby
button 'button'
# =>
submit_button 'submit'
# =>
reset_button 'reset'
# =>
```
RADIO BUTTONS GROUP
``` ruby
= radio_buttons_group name: 'sex' do |radios|
- radios << { label: 'Male', value: 'male', active: params[:sex] == 'male', icon: 'male' }
- radios << { label: 'Female', value: 'female', active: params[:sex] == 'female', icon: 'female' }
# =>
# =>
# =>
# =>
```
IMAGES
``` ruby
image_responsive 'pic.png'
# => 
image_rounded 'pic.png'
# =>
image_circle 'pic.png'
# =>
image_thumbnail 'pic.png'
# =>
```
#### MarkdownHelper
New a css erb file `app/assets/stylesheets/pygments.css.erb` for pygments color style
``` erb
<%= Pygments.css(style: "igor") %>
```
All styles:
``` sh
$ rails c
# => Loading development environment (Rails 4.2.0)
irb(main):001:0> require 'pygments.rb'
# => true
irb(main):002:0> Pygments.styles
# => ["manni", "igor", "xcode", "vim", "autumn", "vs", "rrt", "native", "perldoc", "borland", "tango", "emacs", "friendly", "monokai", "paraiso-dark", "colorful", "murphy", "bw", "pastie", "paraiso-light", "trac", "default", "fruity"]
```
Examples
``` ruby
markdown '# h1'
# => h1
markdown '## h2'
# => h2
markdown '[an example](http://example.com/)'
# => an example
markdown @post.content
# => transform markdown code to html codes and payments highlighter
```
#### QrcodeHelper Examples
``` ruby
qrcode 'Hello world!'
```
QRCode options parameters: Here
``` ruby
qrcode 'Hello world!', width: '300', output_encoding: 'Shift_JIS', error_correction_level: 'H', margin: '10'
```
#### FontAwesomeHelper
Font Awesome icons Homepage: http://fortawesome.github.io/Font-Awesome/
In your `application.css`, include the css file:
```css
/*
*= require font-awesome
*/
```
Then restart your webserver if it was previously running
Examples
``` ruby
fa_icon "user"
# =>
fa_icon "user", text: "Login"
# => Login
fa_icon "user", text: "Login", right: true
# => Login
fa_icon "user 4x"
# =>
```
#### TimeagoHelper
Add below codes to file `app/assets/javascripts/application.js`
``` js
...
//= require jquery.timeago
//= require jquery.timeago.zh-TW
//= require jquery.timeago.load
...
```
Use in View
``` ruby
timeago '2014-11-21 09:38:27.256503'
# => '2εζδΉε'
```
## Contributing
1. Fork it ( https://github.com/ChouAndy/andy_rails_toolbox/fork )
2. Create your feature branch (`git checkout -b my-new-feature`)
3. Commit your changes (`git commit -am 'Add some feature'`)
4. Push to the branch (`git push origin my-new-feature`)
5. Create a new Pull Request