2023-12-17 14:05:38 +00:00
|
|
|
# Jekyll Flake Template
|
2023-12-13 22:32:55 +00:00
|
|
|
|
2023-12-17 14:05:38 +00:00
|
|
|
This is a template for bootstrapping a [Jekyll](https://jekyllrb.com/)-based
|
2023-12-25 19:00:55 +00:00
|
|
|
project (version 4.3.2) with the [lagrange](https://github.com/LeNPaul/Lagrange)
|
|
|
|
|
theme (version 4.0). [direnv](https://direnv.net/) can be used to launch a dev
|
|
|
|
|
shell upon entering this directory (refer to `.envrc`). Otherwise run via:
|
2023-12-13 22:32:55 +00:00
|
|
|
```bash
|
|
|
|
|
$ nix develop
|
|
|
|
|
```
|
2023-12-17 14:05:38 +00:00
|
|
|
Start the server by running:
|
|
|
|
|
```
|
|
|
|
|
$ jekyll serve [--watch]
|
|
|
|
|
```
|
2023-12-13 22:32:55 +00:00
|
|
|
|
2023-12-17 14:05:38 +00:00
|
|
|
## Building
|
2023-12-13 22:32:55 +00:00
|
|
|
|
2023-12-17 14:05:38 +00:00
|
|
|
Dependencies are managed using [bundix](https://github.com/nix-community/bundix).
|
|
|
|
|
If you make any changes to the `Gemfile`, run the following:
|
|
|
|
|
```bash
|
|
|
|
|
$ bundix -l
|
|
|
|
|
```
|
|
|
|
|
This will update the `Gemfile.lock` and `gemset.nix` files. Afterward you can
|
|
|
|
|
run:
|
2023-12-13 22:32:55 +00:00
|
|
|
```bash
|
2023-12-17 14:05:38 +00:00
|
|
|
$ nix build
|
2023-12-13 22:32:55 +00:00
|
|
|
```
|
2023-12-17 14:05:38 +00:00
|
|
|
Note that we need the `.bundle/config` file to workaround issues bundix has with
|
|
|
|
|
pre-built, platform-specific gems. Refer to
|
|
|
|
|
[PR #68](https://github.com/nix-community/bundix/pull/68) for more details.
|
