84 lines
1.5 KiB
Markdown
84 lines
1.5 KiB
Markdown
# Nomo, a simple templating library
|
|
|
|
|
|
Nomo is pure Rust templating library meant to be unopinionated in which target
|
|
language it is embedded.
|
|
|
|
Here is an example `nomo` HTML snippet:
|
|
|
|
```nomo
|
|
<div id="notifications">
|
|
<ul>
|
|
{{ for notif in notifications }}
|
|
<li class="notification-{{= notif.level }}">{{= notif.text }}</li>
|
|
{{ end }}
|
|
</ul>
|
|
</div>
|
|
```
|
|
|
|
It supports the following features:
|
|
|
|
**If/Else Conditionals**
|
|
|
|
```nomo
|
|
{{ if user.level > 3 }}
|
|
...
|
|
{{ else if value == 1 }}
|
|
...
|
|
{{ else }}
|
|
...
|
|
{{ end }}
|
|
```
|
|
|
|
**For Loops**
|
|
|
|
```nomo
|
|
{{ for user in users }}
|
|
{{= user.name }}
|
|
{{ end }}
|
|
```
|
|
|
|
**Whitespace Supression**
|
|
|
|
```nomo
|
|
Hello
|
|
{{- if world == 2 -}}
|
|
Hi
|
|
{{- end }}
|
|
```
|
|
|
|
will print `Hello Hi`.
|
|
|
|
**Function Calls**
|
|
|
|
```nomo
|
|
{{= uppercase(user_name) }}
|
|
```
|
|
|
|
One can use function chaining for less nesting:
|
|
|
|
```nomo
|
|
{{= user_name | uppercase }}
|
|
```
|
|
|
|
The `|` operator has the lowest precedence of the operators.
|
|
Functions can still be given arguments. It is always the last argument that is
|
|
'applied' by the operator.
|
|
|
|
```nomo
|
|
{{= username? | or_default("Unknown") }}
|
|
```
|
|
|
|
**Undefined Chaining**
|
|
|
|
Per default, trying to access a value that is not defined will cause an error.
|
|
|
|
This can be changed with the `?` operator. This can be applied at any level:
|
|
|
|
```nomo
|
|
{{= user?.profile.description? }}
|
|
```
|
|
|
|
This will give an error if `user.profile` is not defined. If either `user` or
|
|
`description` is missing, it simply does not render anything (akin to an empty
|
|
string). However if there _is_ an user, it must have a profile value.
|