nixite/README.md

71 lines
1.3 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
- file paths
- global styles
- custom components with styles
- component extend / inheritance
- templating
### markdown
- [ ] frontmatter
- [X] headers
- [X] paragraphs
- [ ] tables
- [X] unordered lists
- [ ] ordered lists
- [ ] nested lists
- [X] checkboxes
- [X] [links](https://www.markdownguide.org/basic-syntax/#links)
- [ ] images
- [ ] block quotes
- [X] `codeblocks are pretty neat`
- [X] ~sub~script
- [X] ^super^script
- [X] ==mark== my words
- [X] *italics* _emphasis_ inside*of*the words_with_underscores
- [X] **bold** __strong__ even**in**words but__dont__break
- [X] ***bold italics!***
- [X] ~~strikethrough everything~~