# Undies
A pure-Ruby DSL for streaming templated HTML, XML, or plain text. Named for its gratuitous use of the underscore.
## Installation
Add this line to your application's Gemfile:
gem 'undies'
And then execute:
$ bundle
Or install it yourself as:
$ gem install undies
## Usage
```ruby
_html {
_head {
_title "Hello World"
}
body {
_h1.main!.big "Hi There!"
_p "this is an ", em("Undies"), " usage example."
}
}
```
Will stream out
```
Hello World
Hi There!
this is an Undies usage example.
```
## DSL
### Plain text
All text is escaped by default.
```ruby
Undies::Template.escape_html("ab&<>'\"/yz")
# => "ab&<>'"/yz"
```
Capture raw (un-escaped) text using the `raw` method
```ruby
raw "this will not be escaped"
# => "this will not be escaped"
```
### XML
Capture an empty element:
```ruby
element(:thing) # => ""
tag('ns:thing') # => ""
```
Capture an element with content:
```ruby
# basic content
element(:thing, "some content")
# => "some content"
# all content is escaped by default
element(:thing, "&<>")
# => "&<>"
# you can force raw content using the `raw` method
element(:thing, raw("text"))
# => "text"
# you can pass in as many pieces of content as you like
element(:thing, "1 < 2", raw("text"), " & 4 > 3")
# => "1 < 2text& 4 > 3"
```
Capture an element with attributes:
```ruby
element(:thing, "some content", :one => 1, 'a' => "Aye")
# => "some content"
```
Capture nested elements:
```ruby
element(:thing) {
element('Something', "Some Content")
element('AnotherThing', "more content")
} # => "Some Contentmore content"
```
### HTML
In general, all the same stuff applies. However, you can call specific methods for all non-deprecated elements from the HTML 4.0.1 spec.
```ruby
br
# => "
"
span "something"
# => "something"
div "something", :style => "color: red"
# => "somthing "
Hello WorldHi There!