8 releases

0.2.1 Jan 27, 2024
0.1.10 Jan 23, 2024

#38 in Template engine

Download history 8/week @ 2024-01-22 25/week @ 2024-02-26 1/week @ 2024-03-11 47/week @ 2024-04-01

73 downloads per month

Custom license

26KB
277 lines

KISMESIS

Kismesis is a static site generator with macros, plugins and spite, encouraging everybody to make static sites that are semantic and accessible.

Features

  • Only one language for your content: No need to use HTML for templates, Markdown for articles, and maybe something else for a third thing. The Kismesis markup language is designed to complement the static site generator while being concise and easier to type. You're still going to need CSS and Javascript, though.
  • Compile-time errors: Kismesis will give you a visual report of your errors, signaling where they happened, similar to what the Rust compiler does.
  • Macros: Custom HTML tags you can define in order to use them anywhere to make tasks less repetitive.
  • (UNSTABLE!) Plugins: A way for users to add new features to Kismesis.
  • (TO DO!) A Standard Library: Ever miss the <marquee> tag? In Kismesis, you're not allowed to use deprecated tags, however it will come with a <marquee?> plugin, which will aim to replicate the behavior using only widely supported featues.

How To Use

  • Download one of the builds from the releases and add it to your $PATH environment variable. I recommend that you rename the executable to kismesis instead of kismesis-ssg
  • To get started, run kismesis new [project_name]. This will create a new folder for your project.
  • Run kismesis build to build a project.

Compiling

Simply install the rust toolchain, clone this repository and do cargo build. It literally is that simple. This is Rust we're talking about.

You don't need to clone the repository - if you just wish to compile binaries locally, you can always run cargo install kismesis-ssg.

Roadmap

  • Make a TUI mode for the program
  • Make a manual that is visible from this TUI
  • Make a plugin manager
  • Allow plugins to create new subcommands for the CLI

Check the Kismesis Engine readme for a roadmap pertaining to the language and the generator's engine.

FAQ

FAQ stands for both Forwardly Anticipated Questions and Frequently-ish Asked Questions.

Why do you plan to error when using <div>?

  • The reason for this is that we often utilize divisions as a catch-all, instead of utilizing more semantic alternatives like header, footer, main, section, and even button. <container> will get compiled as <div> in case you really know there is no better alternative. Think of it the same way you think of Rust's unsafe.
    • No, <button> is not that much harder to style than a div.

For questions about the Kismesis Language or its Engine, check its respective readme.

Dependencies

~2–18MB
~222K SLoC