@benev/turtle

static site generator

0.1.0
Source
npm

Version published: 2 years ago

Weekly downloads: 69; decreased by-21.59%

Maintainers: 1

Weekly downloads

Created: 2 years ago

Source

🐢 `@benev/turtle`

slow and steady static site generator

turtle is a one-line command that generates a website
you write html templates in plain javascript
templates are just async functions, so you can do anything
you can kind of imagine it like some kind of static javascript "php"
turtle also copies other files like css and whatnot

turtle turtorial

run turtle to generate a website

npx @benev/turtle --in="s/demo:x/demo" --out="x/demo" --verbose="true"

image: turtle example output

ask turtle for help

npx @benev/turtle +help

image: turtle help page

write your first webpage template, like `index.html.js`

import {webpage, html} from "@benev/turtle"

export default webpage(async({v}) => html`
  <!doctype html>
  <html>
    <head>
      <title>@benev/turtle</title>
      <link rel="stylesheet" href="${v("/style.css")}"/>
    </head>
    <body>
      <h1>@benev/turtle</h1>
    </body>
  </html>
`)

you've gotta get into hash versioning!

that's what the above example is doing with that v function
you use v on your urls, and v will attach that file's hash as a suffix
so /style.css becomes /style.css?v=c252882f
now when you deploy your site, your users won't see old cached css files that break your website -- now the browser cache becomes version aware! 🤯

remember, the templates are just async js functions

so you can import other modules, read and write files, whatever you want
thanks to top-level await, you could have a module read yaml files or whatever, and then templates can import that data

i'm thinking of adding more turtle functionality later..

some smart way to add custom build scripts that can, like, build a whole directory of yamls or markdowns or whatever, and generate a ton of pages (as opposed to being limited to just one .html.js per generated page)

Keywords

FAQs

What is @benev/turtle?

Is @benev/turtle popular?

Is @benev/turtle well maintained?

Package last updated on 23 May 2023

Did you know?

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install