3 releases (breaking)

0.3.0	Aug 22, 2024
0.2.0	May 16, 2024
0.1.0	Apr 3, 2024

#31 in Template engine

51 downloads per month

MIT license

190KB
2K SLoC

It's as shrimple as that

The shrimple static site generator

Installation

cargo install shrimple

Features

1. Keep it shrimple

No external configuration needed: you have HTML, you have shrimple, you call it, and get a site ready to be deployed.

shrimple

This will build the website with index.html as its root and paste the root and all the files it references into dist

2. Compute anything anywhere with Lua

shrimple has Lua evaluation built-in and it can be utilised in any part of any file: in text nodes, in attributes, inside strings, you name it! Use $VAR to access a Lua variable, and $(code) or <$lua>code</$lua> to evaluate arbitrary Lua code and paste its return value

<$lua>
  SHRIMP = "shrimp.png"
  SHRIMP_SIZE = 100
</$lua>
<svg width=$SHRIMP_SIZE height=100%>
  <image
    href=$SHRIMP
    width=$SHRIMP_SIZE height=$SHRIMP_SIZE
    transform="rotate(-30 $(SHRIMP_SIZE / 2) $(SHRIMP_SIZE / 2))"
  />
</svg>

3. Don't list assets, just use them

No need to deliberately specify index.css, image.png, etc. as an asset: if you mention it in HTML, it'll be registered automatically. In the example above, the file shrimp.png is mentioned in image element's href attribuet, so it will automatically be searched in the same directory where index.html is, and will be copied to the output directory.

If the asset is somewhere out there on the vast plains of the Internet, and you wish to make sure it's always available to your users, you can cache it! just prefix the attribute containing the link with $cached, and you're all set.

4. Iterate quickly

The CLI comes with a very handy flag: call shrimple -w or shrimple --watch to spin up a lightweight local server that'll recompile your website as needed and show it to you right in the browser.

5. Utilise saner HTML

The subset of HTML accepted by shrimple is intended to smoothe out irregularities & verbosity of the standard HTML. The changes that make it shrimple are:

No syntactical difference between normal and void elements: all elements can be self-closing, and most can also end in a closing tag.
No need for top-level <html>: it's inserted automatically into the compiled HTML.
The encoding of the document is automatically set to UTF-8.

This snippet of standard HTML:

<html>
    <head>
        <title>Hello World</title>
        <meta charset="UTF-8">
    </head>
    <body>
        Hello World
    </body>
</html>

is equivalent to this snippet of shrimple HTML:

<head>
    <title>Hello World</title>
</head>
<body>
    Hello World
</body>

Dependencies

~5–13MB
~177K SLoC