nixite/README.md

68 lines
1.1 KiB
Markdown

# Nixite
A static site generator made in Nix.
This is currently very experimental / subject to change.
## Why
Clearly there aren't already enough web frameworks out there.
I thought it would be fun.
I wanted to get better at Nix.
Importing other people's styles / component libs could actually be a decent experience.
You can process your site with the power of nixpkgs - eg you could process images using imagemagick.
## How
Read `flake.nix` for basic usage.
The default package will serve the site locally (using caddy)
```sh
nix run .
```
Or you can build it raw (dumps the produced site into ./result)
```sh
nix build .#raw
```
Run the tests and watch for changes
```sh
nix run .#watch
```
## features
- [X] file paths
- [X] global styles
- [X] custom components with styles
- [X] component extend / inheritance
- [ ] templating
### markdown
- [ ] frontmatter
- [X] headers
- [X] paragraphs
- [ ] tables
- [X] lists
- [ ] embedded lists
- [X] checkboxes
- [ ] images
- [ ] links
- [X] `codeblocks`
- [X] ~superscript~
- [X] ^subscript^
- [X] ==highlight==
- [X] *italics*
- [X] **bold**
- [X] ~~strikethrough~~