pub.solar/README.md
teutat3s 53c0b69d32
All checks were successful
continuous-integration/drone/push Build is passing
continuous-integration/drone/pr Build is passing
docs: add steps to recreate deno lock file
2023-12-29 18:35:23 +01:00

1.5 KiB

pub.solar homepage

This is the repository containing the code for https://pub.solar.

It is built using lume with JSX. To get started, make sure you have the nix package manager installed. Then you can start developing with:

Quick start

nix develop

This will use a nix devshell to create an environment that has deno and lume available.

An alternative approach for loading all dependencies is direnv. It basically runs nix develop for you, once you enter a directory which contains a .envrc file and allow it by running direnv allow. Once installed globally, run:

direnv allow

To get a live development server, run

deno task serve

Unfortunately, hot module reloading is currently broken for JSX modules, so you'll need to restart this process regularly during development.

Updating Open Sans

To update the font files and CSS, run google-font-downloader $FONT_CSS_URL. As "documentation" flake.nix shows the internals, and _includes/styles/typography.css has a comment at the top that shows which command was used to generate it.

Troubleshooting

An common error is:

22.31 error: The source code is invalid, as it does not match the expected hash in the lock file.

To recreate the deno lock file, run

deno cache --lock=deno.lock --lock-write _config.ts