imported>Invisigoth67: form

2025-07-13T12:00:43Z

form

Neue Seite

{{Infobox Dateiformat
| Name = Haml
| Icon =
| Logo = [[Datei:Haml 1-5 logo.png|Logo]]
| Screenshot = 
| Beschreibung =
| Dateiendung = .haml
| MIME =
| MIME-Anm =
| MagischeZahl =
| MagischeZahlNotation =
| MagischeZahlHex =
| Entwickler = Nathan Weizenbaum, Hampton Catlin
| Veröffentlicht =
| LetzteVersion = 
| LetzteVersionDatum = 
| Art = [[Auszeichnungssprache]]
| Container für =
| Enthalten in =
| Erweitert von =
| Erweitert zu =
| Standard =
| Website = 
}}

'''Haml''' (''[[Hypertext Markup Language|HTML]] Abstraction Markup Language'') ist eine unter der [[MIT-Lizenz]] veröffentlichte [[vereinfachte Auszeichnungssprache]], die benutzt wird, um auf klare und einfache Art das [[Extensible Hypertext Markup Language|XHTML]] eines Web-Dokuments zu beschreiben, ohne dabei mittels Inline-Codierung ausführbaren Programmcode hineinmischen zu müssen. Es wurde entwickelt, um viele der Schwächen traditioneller Template-Mechanismen zu vermeiden und um Markup-Sprache möglichst elegant zu machen. Haml fungiert als Ersatz für Inline-Template-Mechanismen, wie sie bei [[PHP]], [[JavaServer Pages|JSP]], [[eRuby|RHTML]] oder [[Active Server Pages|ASP]] üblich sind. Haml vermeidet die Notwendigkeit, XHTML explizit in Templates zu codieren, weil es selbst eine Beschreibung für XHTML mit einigem Code für dynamischen Inhalt ist.

Zum Umfang von Haml gehörte mit [[Sass (Stylesheet-Sprache)|Sass]] auch ein Analogon zu [[Cascading Style Sheets|CSS]]. Heute werden aber Sass und Haml getrennt entwickelt, versioniert und ausgeliefert.<ref>{{Internetquelle |url=http://nex-3.com/posts/dates/2010/9 |werk=Posts about Haml |titel=Haml and Sass are Split |zugriff=2012-01-07 |archiv-bot=2019-04-15 18:02:38 InternetArchiveBot |offline=ja |archiv-url=https://web.archive.org/web/20111227101502/http://nex-3.com/posts/dates/2010/9 |archiv-datum=2011-12-27 }}</ref>

== Prinzipien ==
; Auszeichnungssprachen sollten schön sein
: Auszeichnungssprachen sollten nicht nur einfach als Werkzeug benutzt werden, um [[Webbrowser]] dazu zu bringen, eine Seite in der Art darzustellen, wie der Autor sie dargestellt haben möchte. Diese Darstellung ist nicht das einzige, was die Leute sehen müssen. Sie müssen die Auszeichnungssprache sehen, ändern und verstehen. Deshalb sollte die Auszeichnungssprache genauso benutzerfreundlichen und angenehm wie das im Webbrowser dargestellte Ergebnis sein.
; Auszeichnungssprachen sollten [[Don’t repeat yourself|DRY]] sein
: XHTML enthält viele Wiederholungen. Die meisten Elemente müssen zweimal angegeben werden, einmal vor und einmal nach ihrem Inhalt. [[eRuby|ERB]] fügt sogar noch mehr Wiederholung und unnötige Zeichen hinzu. Haml vermeidet dies alles, indem es sich auf die Einrückung und nicht auf den Text verlässt, um zu bestimmen, wo Elemente und Codeblöcke beginnen und enden. Die führt nicht nur zu kleineren Templates, es macht den Code auch lesbarer und „sauberer“.
; Auszeichnungssprachen sollten korrekt eingerückt werden
: Eine der großen Schwierigkeiten mit traditionellen Template-Sprachen ist, dass sie nicht nur darauf verzichten, die Verwendung einer konsequenten und konsistenten Einrückung zu ermutigen, sondern dass sie dieser sogar oft im Wege stehen. Es ist oft schwierig oder unmöglich, eine brauchbare Einrückung anzuwenden. Dies führt oft zu verwirrendem und unlesbarem XHTML. Haml formatiert die [[Tag (Informatik)|Tags]] so, dass sie immer sauber eingerückt sind und die darunter liegende Struktur des Dokuments wiedergeben.
; Die XHTML-Struktur sollte klar sein
: XML und XHTML sind Formate, die für die Idee des strukturierten Dokuments ins Leben gerufen wurden. Diese Struktur ist in diesen Auszeichnungssprachen wiedergegeben und sollte auch in gleicher Weise in einer Meta-Auszeichnungssprache wie Haml zu sehen sein. Weil Hamls Logik auf der Einrückung der Unterelemente basiert, wird diese Struktur auf natürliche Weise bewahrt, wobei sie für menschliche Leser viel einfacher und logischer zu erfassen ist.

== Nachteile ==
* In Haml hat [[Leerraum]] eine essentielle Bedeutung. Haml verlässt sich auf konsistente Einrückungen. Tabulator- und Leerzeichen müssen über das ganze Dokument hinweg konsistent eingesetzt werden.
* Es gibt (noch) keine [[WYSIWYG]]-Editoren für Haml, während solche in großer Zahl für XHTML und HTML verfügbar sind. Aber die wachsende Gemeinschaft der Haml-Anwender hat ein Bündel von Zusätzen zu vielen gängigen [[Integrierte Entwicklungsumgebung|integrierten Entwicklungsumgebungen]], wie zum Beispiel [[Eclipse (IDE)|Eclipse]] (einschließlich populärer davon abgeleiteter Werkzeuge wie [[RadRails]] oder [[Aptana]]), [[jEdit]], [[NetBeans IDE|NetBeans]] und Editoren wie [[TextMate]], [[Emacs]] oder [[Vim]], hervorgebracht. Diese erlauben es Entwicklern, Haml in einer Umgebung zu editieren, die die Einrückungen und die Syntax berücksichtigt.


== Beispiel ==
<small>Anmerkung: ''Man beachte bitte, dass dieses Beispiel nicht zwingend den heutigen Entwicklungsstand von Haml wiedergibt.''</small>

<pre>
!!!
%html{ :xmlns => "http://www.w3.org/1999/xhtml", :lang => "en", "xml:lang" => "en"}
%head
%title BoBlog
%meta{"http-equiv" => "Content-Type", :content => "text/html; charset=utf-8"}
= stylesheet_link_tag 'main'
%body
#header
%h1 BoBlog
%h2 Bob's Blog
#content
- @entries.each do |entry|
.entry
%h3.title= entry.title
%p.date= entry.posted.strftime("%A, %B %d, %Y")
%p.body= entry.body
#footer
%p
All content copyright © Bob
</pre>

Der obige Haml-Text sollte das folgende XHTML ergeben:
<syntaxhighlight lang="html">
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang='en' xml:lang='en' xmlns='http://www.w3.org/1999/xhtml'>
<head>
<title>BoBlog</title>
<meta content='text/html; charset=utf-8' http-equiv='Content-Type' />
<link href="/stylesheets/main.css" media="screen" rel="Stylesheet" type="text/css" />
</head>
<body>
<div id='header'>
<h1>BoBlog</h1>
<h2>Bob's Blog</h2>
</div>
<div id='content'>
<div class='entry'>
<h3 class='title'>Halloween</h3>
<p class='date'>Tuesday, October 31, 2006</p>
<p class='body'>
Happy Halloween, glorious readers! I'm going to a party this evening... I'm very excited.
</p>
</div>
<div class='entry'>
<h3 class='title'>New Rails Templating Engine</h3>
<p class='date'>Friday, August 11, 2006</p>
<p class='body'>
There's a very cool new Templating Engine out for Ruby on Rails. It's called Haml.
</p>
</div>
</div>
<div id='footer'>
<p>
All content copyright © Bob
</p>
</div>
</body>
</html>
</syntaxhighlight>

== Implementierungen ==
Die offizielle Haml-Implementierung wurde für [[Ruby (Programmiersprache)|Ruby]] mit Plugins für [[Ruby on Rails]] und Merb entwickelt, aber die Ruby-Implementierung funktioniert auch unabhängig (ohne Rails und ohne Merb).

Es existieren auch Implementierungen in anderen Programmiersprachen:
* [https://github.com/derdon/ghrml GHRML (Python)]
* [https://github.com/jessemiller/HamlPy HamlPy (Python)]
* [https://github.com/norman/lua-haml LuaHaml (Lua)]
* [https://weblogs.asp.net/mirvodasergey/archive/2008/06/02/introducing-monorail-nhaml.aspx MonoRail NHaml (ASP.NET)]
* [http://code.google.com/p/nhaml/ NHaml (.NET)]
* [https://github.com/dxw/Fammel/wiki Fammel (PHP)]
* [https://phaml.sourceforge.net/ pHAML] (PHP)
* [http://code.google.com/p/phamlp/ phamlp (PHP)]
* [https://phphaml.sourceforge.net/ phpHaml (PHP5)]
* [https://github.com/creationix/haml-js haml-js (JavaScript)]
* [http://search.cpan.org/dist/Text-Haml/ Text::Haml (Perl)]
* [http://scalate.fusesource.org/index.html Scalate (Scala)]
* [https://github.com/raymyers/JHaml JHaml (Java)]

== Entwicklung ==
Haml wurde im Mai 2006 von Hampton Catlin erfunden. Er entwickelt zusammen mit Nathan Weizenbaum die [[Codebasis]] weiter.

== Siehe auch ==
* [[BBCode]]
* [[eRuby]]
* [[Less (Stylesheet-Sprache)]]
* [[Markaby]]
* [[Ruby (Programmiersprache)|Ruby]]
* [[Ruby on Rails]]
* [[Webtemplate]]

* [[YAML]]
* [[Sass (Stylesheet-Sprache)|Sass]]

== Weblinks ==
* [https://haml.info/ Offizielle Haml-WWW-Seite] (englisch)
* [https://github.com/nex3/haml/tree/master Haml Quelltext-Repository (Git)]
* [https://phphaml.sourceforge.net/ phpHaml Haml Implementierung für PHP 5] (englisch)
* [http://unspace.ca/discover/haml Einführender Artikel für Haml] auf [http://unspace.ca/ unspace.ca] (englisch)
* [http://groups-beta.google.com/group/haml?hl=en Haml-Google-Gruppe] (englisch)
* [https://weblog.rubyonrails.org/2007/1/19/haml-1-0 Haml 1.0 Ankündigung im offiziellen Ruby on Rails weblog] (englisch)
* [http://nex-3.com/posts/76-haml-2-0 Haml 2.0 Ankündigung auf Nathan Weizenbaums Blog] (englisch)
* [http://podcast.rubyonrails.org/programs/1/episodes/hampton_catlin Interview mit dem Haml-Erfinder auf einem offiziellen Rails-Podcast] (englisch)
* [http://thechangelog.com/post/254788034/episode-0-0-1-haml-sass-and-compass Interview mit Nathan Weizenbaum und Chris Eppstein, den Haml, Sass und Compass Maintainern, auf ''The Changelog podcast''] (englisch)
* [http://wiki.rubyonrails.org/howtos/templates/haml Rails Wiki: Verwendung von Haml mit Ruby on Rails] (englisch)

== Einzelnachweise ==
<references />

[[Kategorie:Ruby (Programmiersprache)]]
[[Kategorie:Templatesprache]]
[[Kategorie:Freies Programmierwerkzeug]]
[[Kategorie:Vereinfachte Auszeichnungssprache]]
[[Kategorie:HTML]]
[[Kategorie:Cascading Style Sheets]]

Haml - Versionsgeschichte

imported>Invisigoth67: form