# rtml __**description**__ (r)ust macros for h(tml) expansion => rtml (r)ust type safe (css) => rcss __**usage**__ ```rust fn main() { use rtml::*; // Use the macros to generate some HTML let document = html! { .lang = "en", head!{ title!{ "Title of the document" } }, body!{ div!{ "text", h1!{ "This is a heading" }, p!{ "This is a paragraph" } } } }.render(); println!("{}", document); } ``` the output html will be in non pretty form. But equivalent to: ```html Page Title

text

This is a Heading

This is a paragraph.

``` When there are attributes, they go first, before adding any inner nested html. ```rust div!{ .style="background-color: red;" } ``` call `render()` when the html needs to be built. __**Getting Started**__ Install the latest version of the rtml crate into your project use either specific tags you plan to use or reference all tags by adding this `use` statement. ```rust use rtml::p; // or use rtml::*; ``` __**CSS**__ Rtml also supports type safe css. ```rust fn main() { use rtml::*; // Use the macros to generate some CSS let css = css! { p { background: "yellow", color: "red" } }.render(); println!("{}", css); } ``` The major difference between real inline css and rcss is that values are in strings. Another difference is that properties are split on commas `,` instead of semicolons `;` At-rules and Functions are not yet implemented. __**Type Safe HTML Attributes**__ rtml allows an additional layer of type safety with tag use. For example, ```rust a! { .href="/documents", My Documents } ``` ```html My Documents ``` Is the correct attribute allowed on the `a` tag. If you were not familiar, you might try to use the `src` attribute which is invalid. Most other website building projects would not prevent incompatible attribute use. In rtml, there is a helpful error. ```rust a! { .src="/documents", My Documents } ``` ```html My Documents ``` ``` the trait bound `src: ACompat` is not satisified the following other types implement the trait `ACompat`: accesskey class contenteditable dir download draggable hidden href and 13 others ``` Breaking this error down, `the trait bound src: ACompat...` - `src` : is the name of the attribute attempting to be used - `ACompat` : is the trait that would need to be implemented, every tag has their own version. Such as `DivCompat` and `StyleCompat` - `accesskey class contenteditable` : are a few of the attributes supported, Rust lists them in alphabetical order and therefore will not show all __**Special Characters**__ rtml and rcss use structs and traits behind the scene, to ensure maximum type safety. Because of that, there are some special caveats due to rust having a few shared keywords between itself and rtml. The `-` character is not allowed in identifiers. So replace all `-` with an underscore `_`. Example: `-webkit-line-clamp` use `_webkit_line_clamp` |keyword|rtml| |---|---| |as|_as| |type|_type| |kind|_kind| |for|_for| |loop|_loop| |where|_where| |async|_async| __**Components**__ not implemented yet