Fumblr - Stop fumbling with your Tumblr themes
I loved Thimblr but it didn't quite fit my workflow. I wanted an easy way to manage an asset host for external css/js/images, and I also wanted to use Sass and Compass.
Clone the project
git clone http://github.com/pengwynn/fumblr.git <yoursite>
If you're using RVM, we've added an .rvmrc
file that sets the ruby version to 1.9.2 and the gemset to fumblr. Update it to be the name of your site and create that new gemset prior running bundle install
to keep your gems from colliding.
rvm gemset create <yoursite>
Once you've got the new gemset created you're ready to bundle install
. Since we are in a brand new gemset, we also need to install bundler.
gem install bundler; bundle install;
If you see output in your terminal like below, we're in the clear and can move on.
$ gem install bundler; bundle install;
Successfully installed bundler-1.0.13
1 gem installed
Fetching source index for http://rubygems.org/
Using rake (0.8.7)
Installing activesupport (2.3.5)
Using bundler (1.0.13)
Installing chunky_png (1.2.0)
Installing fssm (0.2.7)
Installing sass (3.1.1)
Installing compass (0.11.1)
Installing daemons (1.1.3)
Installing eventmachine (0.12.10) with native extensions
Installing fuzzyhash (0.0.11)
Installing i18n (0.5.0)
Installing nokogiri (1.4.4) with native extensions
Installing rack (1.2.2)
Installing tilt (1.3)
Installing sinatra (1.2.6)
Installing thor (0.14.6)
Installing usher (0.8.3) WARNING: usher-0.8.3 has an invalid nil value for @cert_chain
Installing padrino-core (0.9.10)
Installing padrino-gen (0.9.10)
Installing padrino-helpers (0.9.10)
Installing padrino-admin (0.9.10)
Installing tmail (1.2.7.1) with native extensions
Installing padrino-mailer (0.9.10)
Installing padrino (0.9.10)
Installing rack-flash (0.1.1)
Installing rack-test (0.6.0)
Installing shoulda (2.11.3)
Installing thin (1.2.11) with native extensions
Your bundle is complete! Use `bundle show [gemname]` to see where a bundled gem is installed.
Ok, let's move on ...
- Edit your theme in tumblr.html
- Add external assets in public under css/js/images
- In /public, rename
fumblr.example.yml
tofumblr.yml
- In /public, update
asset_host
infumblr.yml
Crank up the server with
bundle exec padrino start
or run under Passenger with something like yoursite.local
padrino rake import
Once you're ready to deploy, copy your assets to your asset host and paste the contents of theme.html into Tumblr.
- Fork the project.
- Make your feature addition or bug fix.
- Add tests for it. This is important so I don't break it in a future version unintentionally.
- Commit, do not mess with rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself I can ignore when I pull)
- Send me a pull request. Bonus points for topic branches.
Copyright (c) 2010 Wynn Netherland. See LICENSE for details.