Markaby 开源项目教程

项目介绍

Markaby（Markup as Ruby）是一个用于在纯Ruby中编写HTML页面的简洁代码库。它是ERb的替代品，允许开发者将Ruby代码和HTML结构无缝结合。Markaby提供了一种更直观、更简洁的方式来生成HTML内容，适用于各种Ruby框架和应用。

项目快速启动

安装Markaby

首先，通过Bundler安装Markaby：

# 在Gemfile中添加
gem 'markaby'

# 然后运行
bundle install

基本使用示例

以下是一个简单的Markaby使用示例：

require 'markaby'

mab = Markaby::Builder.new
html = mab.html do
  head { title "Hello, Markaby!" }
  body do
    h1 "Welcome to Markaby"
    p "This is a simple example of using Markaby to generate HTML."
  end
end

puts html

应用案例和最佳实践

在Sinatra中使用Markaby

Markaby可以与Sinatra框架无缝集成。以下是一个简单的Sinatra应用示例：

require 'sinatra'
require 'markaby'

get '/foo' do
  mab :my_template  # my_template.mab 在Sinatra视图路径中
end

在Rails中使用Markaby

在Rails应用中使用Markaby也非常简单。首先，安装Markaby gem，然后在配置文件中注册Markaby模板处理器：

# 在config/initializers/markaby.rb中
require 'markaby/rails'
Markaby::Rails::TemplateHandler.register(tagset: Markaby::HTML5, indent: 2)

然后，创建以.html.mab为扩展名的模板文件，例如：

# app/views/layouts/application.html.mab
html do
  head do
    title action_name
    stylesheet_link_tag 'scaffold'
  end
  body do
    p flash[:notice], style: "color: green"
    self << @content_for_layout
  end
end

典型生态项目

Tilt

Tilt是一个通用的模板加载器，支持多种模板引擎，包括Markaby。通过Tilt，Markaby可以与任何支持Tilt的Web框架集成。详细文档可以参考Tilt的GitHub页面。

Sinatra-Markaby

Sinatra-Markaby是一个专门为Sinatra框架设计的Markaby插件，提供了更便捷的集成方式。详细信息可以参考Sinatra-Markaby的GitHub页面。

通过这些集成和扩展，Markaby可以广泛应用于各种Ruby Web开发场景，提供高效、简洁的HTML生成解决方案。