How do I get Haml to work with Rails?

Question

I am trying to get Haml to work with my Ruby on Rails project. I am new to Ruby on Rails and I really like it. However, when I attempt to add an aplication.html.haml or index.html.haml for a view, I just receive errors.

I am using NetBeans as my IDE.

What are the errors? Do you have the HAML plugin installed? – Otto Sep 19 '08 at 03:22 — Otto, Sep 19 '08 at 03:22

score 88 · Answer 1 · edited Feb 16 '11 at 19:23

88

Haml with Rails 3

For Rails 3 all you need to do is add gem "haml", '3.0.25' to your Gemfile. No need to install plugin or run haml --rails ..

Just:

$ cd awesome-rails-3-app.git
$ echo 'gem "haml"' >> Gemfile

And you're done.

edited Feb 16 '11 at 19:23

Tim Scollick

1,242
1
16
17

answered May 22 '10 at 12:22

kch

77,385
46
136
148

2

Add echo 'gem "haml-rails", :group => :development' >> Gemfile to use haml for scaffolding as default option. – Fa11enAngel Nov 06 '12 at 17:13
and also `bundle` I presume – Michael Durrant Apr 23 '15 at 12:02

score 60 · Answer 2 · answered Feb 17 '11 at 21:15

60

The answers above are spot-on. You just need to put gem 'haml' in your Gemfile.

One other tip that was not mentioned: to have rails generators use haml instead of erb, add the following to config/application.rb:

config.generators do |g|
  g.template_engine :haml

  # you can also specify a different test framework or ORM here
  # g.test_framework  :rspec
  # g.orm             :mongoid
end

answered Feb 17 '11 at 21:15

bowsersenior

12,524
2
46
52

31

Alternatively to editing `application.rb`, you can add `gem 'haml-rails'` to the development group in `Gemfile`. That will also take care of the generators. – Felix Rabe Jan 04 '12 at 13:00
1

this is equivalent to `config.generators.template_engine :haml` although the do block is nice if you want to customize a number of generators. And to reiterate, if you use `gem 'haml-rails'` it should solve this problem without needing a line of code in `config/application.rb` – Ryan Taylor May 24 '13 at 19:52

Ryan McGeary · Answer 3 · 2010-10-01T02:26:43.210

37

First, install haml as a gem in bundler by adding this to your Gemfile:

gem "haml"

Run bundle install, then make sure your views are named with a *.html.haml extension. For example:

`-- app
    `-- views
        |-- layouts
        |   `-- application.html.haml
        `-- users
            |-- edit.html.haml
            |-- index.html.haml
            |-- new.html.haml
            `-- show.html.haml

edited Oct 01 '10 at 02:26

answered Sep 19 '08 at 20:54

Ryan McGeary

235,892
13
95
104

3

If you have erb templates already go ahead and rename them .html.haml. At the top of the file tell haml to use the erb filter by putting :erb at the top of the file. Then you can slowly convert your templates. More on filters by visiting. http://haml.hamptoncatlin.com/docs/rdoc/classes/Haml.html – gregf Apr 21 '09 at 22:56
4

Why is it important to end with .html.haml and not just .haml? – boo-urns Apr 26 '10 at 23:39
12

mathee, It's Rails convention. `name.mime.format` (e.g. show.html.erb, show.xml.builder, show.html.haml) – Ryan McGeary Apr 29 '10 at 12:34

score 25 · Answer 4 · edited Nov 27 '12 at 18:17

25

Add haml to your Gemfile:

gem "haml"

If you want to use the scaffold-functions too, add haml-rails within your development-group:

gem 'haml-rails', :group => :development

Don't forget to run:

$ bundle install

edited Nov 27 '12 at 18:17

likethesky

846
3
12
28

answered May 08 '12 at 17:55

Matthias

10,816
2
19
12

score 11 · Answer 5 · answered Apr 21 '09 at 18:44

11

Before trying to use haml in your rails application, you can verify that the command line executable is installed correctly:

$ haml
%p 
  %span Hello World!

Then press CTRL-D and you should see:

<p>
  <span>Hello World!</span>
</p>

answered Apr 21 '09 at 18:44

gdelfino

11,053
6
44
48

nice...that's pretty neat. – Apr 12 '13 at 13:28

score 10 · Answer 6 · answered Sep 20 '08 at 00:23

10

First, make sure you have the HAML gem.

gem list --local | grep haml

If haml doesn't show up in the list, then do this:

sudo gem install haml

Then do this from your project directory:

# cd ../
# haml --rails <yourproject>

That should install everything you need, and the HAML views should stop complaining and parse correctly.

answered Sep 20 '08 at 00:23

Pete

1,517
11
19

2

Be mindful that for Rails 3, `haml --rails` is no longer needed. See my answer for Rails 3 howto. – kch May 23 '10 at 15:53
7

Please, avoid using `sudo` when you install gems. – David J. Jun 15 '12 at 13:45

score 3 · Answer 7 · answered May 05 '12 at 09:50

3

This may be an old question but I think the answer is using haml-rails at https://github.com/indirect/haml-rails

answered May 05 '12 at 09:50

thd

2,380
1
25
33

score 1 · Answer 8 · edited Jan 07 '12 at 09:13

1

if for some reason you installed haml, but you haml doesn't start. try

sudo ln haml /usr/bin/

in the bin directory of your haml gem

for some reason this didn't happen automatically on my ubuntu 9.04 Jaunty.

edited Jan 07 '12 at 09:13

sra

23,820
7
55
89

answered Oct 22 '09 at 21:16

railsuser1984

11
1

score 0 · Answer 9 · answered May 09 '12 at 03:53

0

If you are using Pow you will need to restart it also. Ideally you are using powder (gem install powder), because then you can just run this at the terminal

$ powder restart

answered May 09 '12 at 03:53

chris raethke

425
3
8

score 0 · Answer 10 · answered Jun 09 '20 at 14:13

0

make sure to add haml gem into your Gemfile

answered Jun 09 '20 at 14:13

hsul4n

491
7
15

How do I get Haml to work with Rails?

10 Answers10

Haml with Rails 3

Linked