2 unstable releases

0.3.0 Oct 6, 2024
0.1.0 Aug 10, 2024

#5 in #kdl

Download history 87/week @ 2024-08-05 26/week @ 2024-08-12 10/week @ 2024-09-16 5/week @ 2024-09-23 95/week @ 2024-09-30 70/week @ 2024-10-07 10/week @ 2024-10-14

180 downloads per month

MIT license

17KB
274 lines

This crates implements a (simple) flavour of KDL called htmeta. This dialect's purpose is to allow a straightforward representation of HTML.

Format

As KDL is already very similar to HTML semantically, htmeta only adds 2 things:

  • A way to differentiate true text content to be shown in HTML.
  • Variables to reduce repetition.

Text nodes

Text nodes are creatively named text and they can only have one positional argument, which is the text to be directly pasted into the resulting HTML.

Example:

html {
    body {
        h1 {
            text "Title"
        }
    }
}

Results in:

<html>
    <body>
        <h1>
            Title
        </h1>
    </body>
</html>

Variables

If you ever used CSS-based frameworks like TailwindCSS or Bootstrap, you know how tedious it is to type the same classes over and over again. Hence, htmeta implements a simple variable mechanism that reduces duplication.

Example:

html {
    head {
        meta charset="utf-8"
        // Includes tailwindcss
        script src="https://cdn.tailwindcss.com"
    }
    body {
        // creates a variable called `$btn_class`
        $btn_class "border-1 rounded-lg"

        // Value of `$btn_class` is reused inside these buttons:
        button class="$btn_class ml-4"
        bttton class="$btn_class mr-4"
    }
}

Results in:

<html>
    <head>
        <meta charset="utf-8"/>
        <script src="https://cdn.tailwindcss.com"></script>
    </head>
    <body>
        <button class="border-1 rounded-lg ml-4"></button>
        <bttton class="border-1 rounded-lg mr-4"></bttton>
    </body>
</html>

Dependencies

~5–7MB
~125K SLoC