A HAML to ERB translator, written in Haskell.
This program converts HAML templates to ERB.
If you are familiar with Docker, You can build the image using the dockerfile on this repository. And then you can use it without installing Cabal like :
docker run --rm -i herbalizer < test.hamlSee also : danchoi#9 (comment)
A lot of people prefer HAML to ERB. But not everyone, and not for every circumstance. ERB is simpler, easier to remember the rules for, and more accessible to anyone familiar with HTML. ERB templates are easier to teach to beginners and easier to collaborate on with a wider range of people, like designers. And for some people ERB is easier on the eyes.
As far as I know, there is no other good tool to convert HAML to ERB. To quote HAML maintainer Nathan Weizenbaum:
No, no such tool exists. In fact, it's not possible to make without parsing Ruby code - Haml supports several constructs, such as = with a block and comments within Ruby code, that ERB doesn't. It might be possible to modify the Haml engine to convert a fairly large subset of Haml to ERB, but it would take considerable work to even get to an imperfect implementation. source
However, with Haskell, it is possible to write a pretty good parser-translator for HAML markup without incorporating a full-blown Ruby parser.
The GHC Platform, unless you're using a precompiled binary.
cabal update
cabal install herbalizer
I've precompiled the executable for OS X (10.8). You can download it and chmod +x it:
wget http://openmbta.org/herbalizer
chmod +x herbalizer
And then put it on your PATH.
sudo /etc/paths
You will need to reload your terminal for path to update. Verify the new path with...
echo $PATH | grep Haskell
You can also compile programs using cabal. If you are programming in Haskell with your development system setup with cabal....
Add this to your ~/.bash_profile
export PATH="$HOME/Library/Haskell/bin:$PATH"
source ~/.bash_profile
herbalizer < test.haml
herbalizer < test.haml > outputfile.html.erb
You can also pass filenames as arguments:
herbalizer test.haml
herbalizer can deal with the most commonly used features of HAML's
syntax. Mainly, it will handle the widely used HAML syntax features for tags,
classes, ids, attributes, Ruby blocks and expressions, and inline <script>
content.
I wrote it so that I could automate at least 90% of work I need to do to translate HAML templates to ERB. YMMV.
herbalizer can't yet recognize some less commonly used HAML constructs such as
- HTML-style () attributes e.g.
%a(title=@title href=ahref) - :class and :id attributes specified as a Ruby array, e.g.
%div{:id => [@item.type, @item.number], :class => [@item.type, @item.urgency]} - Filters besides
:javascriptand:erb; these are just rendered inside pseudo-tags named after the filter - Whitespace removal sytnax
- Object reference syntax
- Escaping HTML &= syntax
- Multiline | syntax
- Ruby Interpolation #{} within plain body text; passed through
- Conditional /[] comments; passed through; normal / comments OK
- HAML Comments (#-) not processed
- XML Doctype (!!! XML) declarations; HTML Doctype declarations are supported
- Ternary Ruby expressions in attribute values are not handled robustly; surround these with parentheses
- Nested attribute hash expressions e.g.
{:data => {:send => false, :width => 100}}are not processable
Maybe herbalizer will cover more of these edge cases over time. Let me know in a GitHub issue if you have a particular need. I'll try to write a patch.