mirror of
https://github.com/NotAShelf/Basix.git
synced 2024-11-01 08:41:14 +00:00
clean up readme
This commit is contained in:
parent
798488b399
commit
dabb8c4d8e
1 changed files with 18 additions and 4 deletions
22
README.md
22
README.md
|
@ -7,16 +7,16 @@ one convenient library.
|
||||||
## How does it work?
|
## How does it work?
|
||||||
|
|
||||||
For some obscure reason[^1] all schemes provided by tinted-theming is in YAML
|
For some obscure reason[^1] all schemes provided by tinted-theming is in YAML
|
||||||
under one unified repository. We convert each YAML scheme to JSON to ensure the
|
and under one unified repository. We convert each YAML scheme to JSON to ensure
|
||||||
schemes are in a format Nix can read, then read them and expose them under a
|
the schemes are in a format Nix can read, then read them and expose them under a
|
||||||
flake output.
|
flake output.
|
||||||
|
|
||||||
## How do I use this?
|
## How do I use this?
|
||||||
|
|
||||||
Basix be used as a flake input, or imported from a tarball.
|
Basix be used as a flake input, or imported from a tarball.
|
||||||
|
|
||||||
To get a colorscheme, import either `schemeData.base16` or `schemeData.base24`
|
To get a color scheme, import either `schemeData.base16` or `schemeData.base24`
|
||||||
from the outputs from this flake to import the colorschemes for yourself.
|
from the outputs from this flake to import the color schemes for yourself.
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
nix-repl> :p schemeData.base16.decaf
|
nix-repl> :p schemeData.base16.decaf
|
||||||
|
@ -46,6 +46,20 @@ nix-repl> :p schemeData.base16.decaf
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
|
## Why?
|
||||||
|
|
||||||
|
There are not many theming solutions for Nix. Those that already exist are
|
||||||
|
either too convoluted, or straight up bad in terms of code quality or/and
|
||||||
|
execution. This leads me to use (and recommend) home-baked theming modules for
|
||||||
|
in-home usage, but there was not a good Base16 solution on Nix. Basix aims to
|
||||||
|
solve this issue by providing you an auto-updated collection of Base16 and
|
||||||
|
Base24 color palettes. As opposed to traditional hacks needed to convert YAML to
|
||||||
|
JSON and then read it, you can simply consume attribute sets derived from JSON
|
||||||
|
schemes while Basix does the heavy lifting for you.
|
||||||
|
|
||||||
|
Basix might come in handy in scenarios you wish to theme individual applications
|
||||||
|
from a pre-defined color palette.
|
||||||
|
|
||||||
## Credits
|
## Credits
|
||||||
|
|
||||||
- [@Gerg-l](https://github.com/gerg-l) for the clinically insane import
|
- [@Gerg-l](https://github.com/gerg-l) for the clinically insane import
|
||||||
|
|
Loading…
Reference in a new issue