magick_title

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 50 Open GitHub ↗

Convert text to an image via ImageMagick

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Magick Title [![Build Status](https://secure.travis-ci.org/citrus/magick_title.png)](http://travis-ci.org/citrus/magick_title)

Want beautiful copyright-protected browser-compatible custom-smoothed & kerned fonts? MagickTitle delivers just that by using [imagemagick](http://www.imagemagick.org/script/index.php) to generate titles based on the options you provide.

Want your titles to be automagically created for your Rails apps' models? Check out [has_magick_title](https://github.com/citrus/has_magick_title).

Requirements
------------

MagickTitle is framework agnostic but requires [imagemagick](http://www.imagemagick.org/script/index.php) built with [freetype](http://www.freetype.org/).

Installation
------------

As usual, just use the `gem install` command:

(sudo) gem install magick_title
    
Or add magick_title as a gem in your Gemfile:

gem 'magick_title', '>= 0.2.0'

Then run `bundle install`

Usage
-----

Using MagickTitle is easy. In it's simplest form, it can be used like so:

MagickTitle.say("Hello")

This will create an image of the word "Hello" with all of the default options. These options can be set globally or on the fly.

Customize your global title styles by setting MagickTitle's default options while loading your app. If your using rails, it's best to do this in `config/initializers/magick_title.rb`.

# Here's the defaults

:root => "./",
    :font => "PermanentMarker.ttf",
    :font_path => Proc.new{ File.join MagickTitle.root, "fonts" },
    :font_size => 50,
    :destination => Proc.new{ File.join MagickTitle.root, "public/system/titles" },
    :extension => "png",
    :text_transform => nil,
    :width => 800,
    :height => nil,
    :background_color => '#ffffff',
    :background_alpha => '00',
    :color => '#68962c',
    :weight => 400,
    :kerning => 0,
    :line_height => 0,
    :command_path => nil,
    :log_command => false,
    :cache => true,
    :to_html => {
      :parent => {
        :tag   => "h1",
        :class => "image-title"
      },
      :class => "magick-title"
    }

Set as few or as many options as you'd like. Your custom options will get merged into the defaults... You can also set individual options like this:

MagickTitle.options[:font] = 'Lobster.ttf'
    
      
Once you've set your options to your liking, just create a title like so:

MagickTitle.say("Hello!").to_html 
    
    #=> <h1 class="image-title"><img class="magick-title" alt="Hello!" src="/system/titles/hello_8e05f22657a3573d8fc6fa8115fecfc0812d82be.png"/></h1>

Place the image title in a div rather than an h1:

MagickTitle.say("Hello!").to_html("div")
    
    #=> <div><img class="magick-title" alt="Hello!" src="/system/titles/hello_f76179c852bb2fa264b8ad2c0c9ceeb9f99dfc0b.png"/></div>

Or without the h1 tag: 
  
    MagickTitle.say("Hello!").to_html(false)
    
    #=> <img class="magick-title" alt="Hello!" src="/system/titles/hello_f76179c852bb2fa264b8ad2c0c9ceeb9f99dfc0b.png"/>

To just get an instance of MagickTitle::Image:

title = MagickTitle.say("Hello!")
    
    puts title.filename #=> "hello.png"
    puts title.url #=> "/system/titles/hello.png"

Or set some options on the fly:

MagickTitle.say("Hello!", :font_size => 24, :color => '#ff0000').to_html
    
    #=> <h1 class="image-title"><img class="magick-title" alt="Hello!" src="/system/titles/hello_080fb04470589c55cd0e22c3229d2006baa05f7d.png"/></h1>
    
Note how the token is different than the previous 'Hello!' titles since we've set custom options.
    
    
The html helper can also be customized:

MagickTitle.say("Hello!").to_html(:class => "custom-title", :parent => { :tag => "h3", :id => "maaaagick" })
    
    #=> <h3 id="maaaagick"><img class="custom-title" alt="Hello!" src="/system/titles/hello_f76179c852bb2fa264b8ad2c0c9ceeb9f99dfc0b.png"/></h3>

Combine no-parent with custom attributes:

MagickTitle.say("Hello!").to_html(:class => "custom-title", :parent => nil)
     
    #=> <img class="custom-title" alt="Hello!" src="/system/titles/hello_f76179c852bb2fa264b8ad2c0c9ceeb9f99dfc0b.png"/>

To make sure all titles are the same height:

MagickTitle.say("HELLO!", :height => 50).to_html
    MagickTitle.say("lowercase j's!", :height => 50).to_html

New in version 0.1.8 are styles. Store styles in your initializer using the slick new DSL:

MagickTitle.style :h1 do
      font_size   50
      line_height -10
    end
    
    MagickTitle.style :sidebar do
      font      "Lobster.ttf"
      font_size 30
      color     "#cc0000"
      to_html   :parent => { :tag => "h2" }
    end
    
    
Now in your views just:
    
    MagickTitle.say("Hello!", :h1).to_html 
    MagickTitle.say("World.", :sidebar).to_html   
     
    
### More to come!

To Do
-----

* Smart option validation (:color => 'fff' converts to :color => '#fff' and :color => 'pink' fails)
* More documentation
* Heroku support / tempfiles / base64
* Clean up and publish demo app (/test/dummy)
* Write more tests

License
-------

magick_title

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README