An utterly simple and fast Static Site Generator built using C
- [✅] Simple and fast
- [✅] HTML-first approach
- [✅] Crossplatform (Tested on
Windows 11 v21H2andDebian GNU/Linux 11 x86_64) - [❌] JS-first SPA experience
- [❌] Frameworks and external build tools
- [❌] Plugins and lifecycle hooks
To get kevlar, you can either get a binary from releases or build from scratch; instructions for which are given here.
To get start with kevlar, you need GCC and make which are the primary build tools used by kevlar
build
git clone https://github.com/aadv1k/kevlar
cd kevlar && make all
./bin/kevlar helpYou may need something like mingw32-make, and gcc for windows for this to work
git clone https://github.com/aadv1k/kevlar
cd kevlar && make kevlar_win32
"bin/kevlar.exe" helpKevlar has it's own markdown loader if you would like to build it as it's own executable you can run make md2html
You can build the loader kevlar uses to parse .md files as their own executables by running.
You will get the respective CLI
$ kevlar
kevlar <cmd> <opt>
help -- print this help message
new -- create a new site skeleton
new-post -- create a new post with defaults
build -- build if in a kevlar projectSets up a basic skeleton for a site and a basic config.ini
theme=listing-kevlar-themetheme=: looks for the given theme within the./templates/dir.
Generates a .md file in the current folder with the following archetype
Title=This is a title
Date=2023-01-24 17:44:10
Order=1
- Title: the name of the link that will show up with
--TITLE-- - Date: current date, put AS-IS with
--DATE-- - Order: the order in which the post will show up in
--LISTING--
the only required config is the theme option in the config.ini files.
| Tags | Description |
|---|---|
--HEADER-- |
Reads and parses header.html in your theme |
--FOOTER-- |
Reads and parses footer.html in your theme |
--SCRIPT ./script.js-- |
Finds the provided file within yout theme and inserts an inline script |
--STYLE ./style.css-- |
Finds the provided file within yout theme and inserts an inline style |
--CUSTOM_TAG-- |
will look up the tag (lowercase) in config.ini, where you can provide the option for this tag |
Defines the layout of a post
| Tags | Description |
|---|---|
--CONTENT-- |
The parsed markdown content |
Defines to how a singular list item within --LISTING-- will look like
| Tags | Description |
|---|---|
--DATE-- |
The Date= option in the post file |
--PATH-- |
Html link of the parsed post |
--CONTENT-- |
parsed html content |
| Tags | Description |
|---|---|
--LISTING-- |
provides a list of all posts based on entry.html |
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent