imported>SamitheSammy：/* growthexperiments-addlink-summary-summary:2|0|0 */

2026-05-06T13:20:22Z

growthexperiments-addlink-summary-summary:2|0|0

新页面

{{NoteTA
|G1=IT
|G2=FL
}}
{{校对翻译}}
{{Refimprove|time=2017-05-24T09:43:44+00:00}}
{{Infobox programming language
| name = Haml
| logo =
| alumni = [https://github.com/nex3 Natalie Weizenbaum]、{{tsl|en|Hampton Catlin}}
| designer = [http://nick-walsh.com/ Nick Walsh]
| developer = {{plainlist|
* [https://github.com/norman Norman Clarke]
* [https://github.com/mattwildig Matt Wildig]
* [https://github.com/amatsuda Akira Matsuda]
* [https://github.com/teeparham Tee Parham]
* [https://github.com/nex3 Natalie Weizenbaum] }}
| programming_language = [[Ruby]]
| latest_release_version = 5.2.1
| latest_release_date = {{Start date|2020|11|30}}<ref name="Change Log">{{cite web|title=Change Log|url=https://github.com/haml/haml/blob/master/CHANGELOG.md|accessdate=2020-11-30|archive-date=2015-01-05|archive-url=https://web.archive.org/web/20150105090805/https://github.com/haml/haml/blob/master/CHANGELOG.md|dead-url=no}}</ref>
| operating_system = [[跨平台]]
| paradigm = {{tsl|en|Template engine (web)||模板引擎}}
| license = {{plainlist|
* [https://github.com/haml/haml/blob/master/MIT-LICENSE MIT许可证]
* [https://unspace.ca/ Unspace Interactive]<ref name="Haml GitHub" />}}
| website = {{URL|http://haml.info/}}
| file_ext = .haml
}}
'''Haml'''（[[HTML|'''H'''TML]] '''A'''bstraction '''M'''arkup '''L'''anguage，HTML抽象标记语言）是一种模板系统，它可以避免在Web文档中内嵌代码，使[[HTML]]更简易和干净。Haml为[[HTML]]中提供了一些动态内容的灵活性。类似其他[[万维网|Web]]语言（如[[PHP]]、[[Active Server Pages|ASP]]、[[JSP]]）和模板系统（如[[Eruby|eRuby]]），Haml也嵌入一些在运行时执行的代码并生成[[HTML]]代码，从而提供一些动态内容。为运行Haml代码，文件需要采用.haml扩展名。这些文件类似.erb或eRuby文件，这有助于在开发[[网络应用程序]]时嵌入[[Ruby]]代码。在解析代码注释时，Haml采用与Ruby 1.9或之后版本相同的规则。Haml只能理解兼容[[ASCII]]的编码（例如[[UTF-8]]），而不能理解不兼容ASCII的[[UTF-16]]与[[UTF-32]]。<ref name="Encoding">{{Cite web|url=http://haml.info/docs/yardoc/file.REFERENCE.html|title=Encoding|accessdate=29 January 2016|archive-date=2017-05-29|archive-url=https://web.archive.org/web/20170529075227/http://haml.info/docs/yardoc/file.REFERENCE.html|dead-url=no}}</ref><ref name="UTF Encodings">{{Cite web|url=https://github.com/haml/haml/blob/88110b0607efca433c13bb1e339dcb1131edf010/lib/haml/util.rb|title=UTF encodings|accessdate=7 February 2016|archive-date=2019-02-16|archive-url=https://web.archive.org/web/20190216133231/https://github.com/haml/haml/blob/88110b0607efca433c13bb1e339dcb1131edf010/lib/haml/util.rb|dead-url=no}}</ref>Haml可以在[[命令行界面]]中使用，也可以作为一个单独的Ruby模块或在一个[[Ruby on Rails]]应用程序中使用，这使Haml可用于广泛的应用程序。

== 历史 ==
Haml最早由{{tsl|en|Hampton Catlin}}于2006年发布，它的成果领先于其他几个人。他的动机是使[[HTML]]更简单、清晰和易于使用。自2006年以来，它已随新版本发布而多次修订。2012年4月，Haml的维护由Norman Clarke接手。<ref name="History">{{Cite web|url=http://haml.info/about.html|title=History|accessdate=29 January 2016|archive-date=2017-05-27|archive-url=https://web.archive.org/web/20170527063202/http://haml.info/about.html|dead-url=no}}</ref>[[Natalie (網站)|Natalie]] Weizenbaum致力于使Haml可以在[[Ruby]]应用程序中使用，而品牌与设计则由Nick Walsh完成。目前的维护团队中还有Matt Wildig、Akira Matsuda和Tee Parham。<ref name="Haml GitHub">{{Cite web|url=https://github.com/haml/haml|title=GitHub|accessdate=30 January 2016|archive-date=2017-04-27|archive-url=https://web.archive.org/web/20170427062452/https://github.com/haml/haml|dead-url=no}}</ref>

=== 版本历史 ===

== 特性 ==
Haml的发展有四项原则。

=== 用户友好的标记 ===
[[置标语言]]如果遵循下列特征，那么它则用户友好：
* 语言能轻松理解
* 使用便捷（其实现）

=== DRY ===
标记语言应坚持不重复自身（[[一次且仅一次|DRY]]）原则。它应该：
* 避免不必要的重复
* 专注于干净的代码

=== 精巧缩进 ===
有良好[[缩进]]的标记语言可以改善外观、使阅读器易于读取，并有助确定元素的开始与结束位置。

=== 清晰结构 ===
有清晰结构的标记语言有助于代码维护和理解最终结果的逻辑。Haml在这方面是否提供了有差异的优势，这点尚不清晰。

== 例子 ==
Haml标记在语法上类似[[层叠样式表|CSS]]。例如，Haml同样使用<code>.</code>（点）表示CSS的类，使开发人员可以轻松使用这种标记。

=== Hello, World例子 ===
Haml的最简单的[[Hello World]]实现像是这样：

==== Haml作为[[命令行界面|命令行工具]] ====
<syntaxhighlight lang="haml">
%p{:class => "sample", :id => "welcome"} Hello, World!
</syntaxhighlight>得到这样的[[HTML]]代码：<syntaxhighlight lang="html">
<p class="sample" id="welcome">Hello, World!</p>
</syntaxhighlight>为运行Haml代码，必须已安装，如使用下列命令 <code>Haml</code>以[[RubyGems|gem]]安装：<ref name="Using Haml">{{Cite web|url=http://haml.info/docs/yardoc/file.REFERENCE.html#using_haml|title=Using Haml|accessdate=7 February 2016|archive-date=2017-05-29|archive-url=https://web.archive.org/web/20170529075227/http://haml.info/docs/yardoc/file.REFERENCE.html#using_haml|dead-url=no}}</ref>
gem install haml
Haml代码若以<code>Hello.haml</code>为文件名保存，则可以这样运行：
haml Hello.haml

==== Haml作为[[Ruby on Rails]]附加项 ====
要用[[Ruby]]使用Haml，Ruby的<code>Gemfile</code>应该包含此行：
gem 'haml'
类似[[Eruby|eRuby]]，Haml也可以访问局部变量（在同一个文件中以Ruby代码声明）。此例子使用一个Ruby控制器文件为例。
* file: app/controllers/messages_controller.rb<syntaxhighlight lang="ruby">
class MessagesController < ApplicationController
def index
@message = "Hello, World!"
end
end</syntaxhighlight>
* file: app/views/messages/index.html.haml<syntaxhighlight lang="haml">
#welcome
%p= @message
</syntaxhighlight>
将得到：<syntaxhighlight lang="html">
<div id="welcome">
<p>Hello, World!</p>
</div>
</syntaxhighlight>

==== Haml作为Ruby模块 ====
要独立于[[Ruby on Rails|Rails]]和[http://guides.rubyonrails.org/action_view_overview.html ActionView]{{Wayback|url=http://guides.rubyonrails.org/action_view_overview.html |date=20170528044224 }}使用Haml，安装<code>haml</code> [[RubyGems|gem]]，在<code>Gemfile</code>中包含它，然后简单的在Ruby脚本中导入<code>[Usage: require 'haml']</code>，或者以<code>-rubygems</code>标志调用Ruby[[直譯器]]。<syntaxhighlight lang="ruby">
welcome = Haml::Engine.new("%p Hello, World!")
welcome.render
</syntaxhighlight>输出：<syntaxhighlight lang="html">
<p>Hello, World!</p>
</syntaxhighlight>[http://haml.info/docs/yardoc/Haml/Engine.html Haml::Engine]{{Wayback|url=http://haml.info/docs/yardoc/Haml/Engine.html |date=20170602094319 }}是一个Haml类。

=== 基本例子 ===
Haml使用空格缩进（两个空格）来表示标签的嵌套和识别给定标签的范围。这取代打开、闭合的标签对系统，从而符合[[一次且仅一次|DRY]]并使其看上去更清晰（容易阅读）。下列例子展示了Haml与[[Eruby|eRuby]]（嵌入式Ruby）的差异。
{| style="margin-bottom: 10px;"
! Haml
! ERB
|- valign="top"
| <syntaxhighlight lang="Haml">
%div.category
%div.recipes
%h1= recipe.name
%h3= recipe.category
%div
%h4= recipe.description
</syntaxhighlight>
| <syntaxhighlight lang="HTML+ERB">
<div class="category">
<div class="recipes">
<h1><%= recipe.name %></h1>
<h3><%= recipe.category %></h3>
</div>
<div>
<h4><%= recipe.description %></h4>
</div>
</div>
</syntaxhighlight>
|}
由上述代码示例呈现的[[HTML]]代码如下所示：<syntaxhighlight lang="HTML">
<div class="category">
<div class="recipes">
<h1>Cookie</h1>
<h3>Desserts</h3>
</div>
<div>
<h4>Made from dough and sugar. Usually circular in shape and has about 400 calories.</h4>
</div>
</div>
</syntaxhighlight>两者的关键差异是：
* Haml不像[[Eruby|eRuby]]那样，每个元素都有开始与结束
* eRuby语法看上去很像、更像[[HTML]]，而Haml更像[[层叠样式表|CSS]]。
* Haml使用[[缩进]]来嵌套标签元素，而eRuby使用与HTML相同的表示法
* 在Haml属性中，<code>class</code>、<code>id</code>可以用<code>.</code>和<code>#</code>表示<code>class</code>和<code>id</code>关键字。Haml使用<code>%</code>标示一个HTML元素，而eRuby中使用<code><></code>。

=== 嵌入Ruby代码的例子 ===
注意：这是一个简单的预览示例，可能不能体现此语言的目前版本。<syntaxhighlight lang="haml">
!!!
%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"}
%link{"rel" => "stylesheet", "href" => "main.css", "type" => "text/css"}
%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
</syntaxhighlight>上述Haml产生这个[[XHTML]]：<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>

== 实现 ==
Haml的官方实现已经以[[Ruby]][[插件]]形式内置在[[Ruby on Rails]]和{{tsl|en|Merb}}中，该Ruby实现也能够独立使用。Haml可以轻松配合其他语言使用。下列是各种语言对Haml的实现：
* [https://github.com/k0kubun/hamlit hamlit (Ruby)]{{Wayback|url=https://github.com/k0kubun/hamlit |date=20170421232751 }}
* [https://github.com/jessemiller/HamlPy HamlPy (Python)]{{Wayback|url=https://github.com/jessemiller/HamlPy |date=20180611022049 }}
* [https://github.com/norman/lua-haml LuaHaml (Lua)]{{Wayback|url=https://github.com/norman/lua-haml |date=20180610232412 }}
* [https://web.archive.org/web/20080608081951/http://weblogs.asp.net/mirvodasergey/archive/2008/06/02/introducing-monorail-nhaml.aspx MonoRail NHaml (ASP.NET)]
* [https://code.google.com/p/nhaml/ NHaml (.NET)]{{Wayback|url=https://code.google.com/p/nhaml/ |date=20160316090641 }}
* [https://web.archive.org/web/20100303124319/http://wiki.github.com/dxw/Fammel/ Fammel (PHP)]
* [https://web.archive.org/web/20110417115303/http://haml-to-php.com/ HAML-TO-PHP (PHP5)]
* [http://phaml.sourceforge.net/ pHAML (PHP)]{{Wayback|url=http://phaml.sourceforge.net/ |date=20170610115013 }}
* [https://code.google.com/p/phamlp/ phamlp (PHP)]{{Wayback|url=https://code.google.com/p/phamlp/ |date=20160821080435 }}
* [http://phphaml.sourceforge.net phpHaml (PHP5)]{{Wayback|url=http://phphaml.sourceforge.net/ |date=20170619012015 }}
* [https://github.com/arnaud-lb/MtHaml Multi target HAML (PHP5.3)]{{Wayback|url=https://github.com/arnaud-lb/MtHaml |date=20180611022532 }}
* [https://github.com/creationix/haml-js haml-js (JavaScript)]{{Wayback|url=https://github.com/creationix/haml-js |date=20161004160128 }}
* [https://metacpan.org/module/Text::Haml Text::Haml (Perl)]{{Wayback|url=https://metacpan.org/module/Text::Haml |date=20191017071318 }}
* [https://web.archive.org/web/20100216131951/http://scalate.fusesource.org/index.html Scalate (Scala)]
* [https://github.com/raymyers/JHaml JHaml (Java)]{{Wayback|url=https://github.com/raymyers/JHaml |date=20180611031908 }}
* [https://github.com/lvivski/hart Hart (Dart)]{{Wayback|url=https://github.com/lvivski/hart |date=20180610234115 }}
* [https://github.com/Unspeakable/cl-haml cl-haml (Common Lisp)]{{Wayback|url=https://github.com/Unspeakable/cl-haml |date=20180611002643 }}

== 参见 ==
* [[BBCode]]
* [[Eruby|eRuby]]
* {{tsl|en|Markaby}}
* [[Ruby]]
* [[Ruby on Rails]]
* [[YAML]]
* [[Sass]] – 一种类似的面向[[层叠样式表|CSS]]的系统，也是由Catlin设计。
* {{tsl|en|Website Meta Language|网站元语言}} – 另一种有类似功能的模板语言
* {{tsl|en|Web template|Web模板}}

== 参考资料 ==
{{Reflist}}

== 外部链接 ==
* {{Official website}}
** [http://haml.info/tutorial.html Haml tutorial]{{Wayback|url=http://haml.info/tutorial.html |date=20170529062037 }}
* [https://learnxinyminutes.com/docs/haml/ Learn Haml (basic)]{{Wayback|url=https://learnxinyminutes.com/docs/haml/ |date=20170423221617 }}
* {{GitHub|haml/haml|Haml}}
* [http://phphaml.sourceforge.net/ phpHaml]{{Wayback|url=http://phphaml.sourceforge.net/ |date=20170619012015 }}，面向[[PHP]]的Haml实现
* [https://groups.google.com/forum/?hl=en#!forum/haml Haml Google讨论组]{{Wayback|url=https://groups.google.com/forum/?hl=en#!forum/haml |date=20180130014044 }}
* [http://weblog.rubyonrails.org/2007/1/19/haml-1-0 Haml 1.0]{{Wayback|url=http://weblog.rubyonrails.org/2007/1/19/haml-1-0 |date=20170519062131 }}，Ruby on Rails博客上的公告

[[Category:Ruby]]
[[Category:網頁模板引擎]]
[[Category:轻量级标记语言]]
[[Category:自由發展元件與函式庫]]
[[Category:使用MIT许可证的软件]]

Haml - 版本历史

imported>SamitheSammy：​/* growthexperiments-addlink-summary-summary:2|0|0 */

imported>SamitheSammy：/* growthexperiments-addlink-summary-summary:2|0|0 */