Update README

main
Bill Ewanick 2023-09-22 13:57:54 -04:00
parent cacde649a2
commit a0d3a5fca2
1 changed files with 21 additions and 28 deletions

View File

@ -1,6 +1,10 @@
# Cute Seal Fanpage # Cute Seal Fanpage
> An experiment using [Nix](https://nixos.org/), [Hakyll](https://jaspervdj.be/hakyll/), [Haskell](https://www.haskell.org/), and [shell scripts](https://en.wikipedia.org/wiki/Bourne_shell) to automate a simple website deployment pipeline. > An experiment using [Nix](https://nixos.org/),
> [Hakyll](https://jaspervdj.be/hakyll/),
> [Haskell](https://www.haskell.org/),
> and [shell scripts](https://en.wikipedia.org/wiki/Bourne_shell)
> to automate a simple website deployment pipeline.
## Why Seals? ## Why Seals?
@ -10,30 +14,19 @@ It's an in-joke.
seal-blog/ seal-blog/
- devops/ - `flake.nix`
- build.sh - The specification for everything is repo can do.
- Uses a [nix-shell](https://nixos.wiki/wiki/Development_environment_with_nix-shell) expression to build the Hakyll executable - Defines the hakyll site build instructions, as well as sets it as an app to be run with `nix run .#hakyll-site`.
- Defines the blog generation command as an app to be run with `nix run .#generateSealPosts`.
- configuration.nix - Creates a shell with the same ghc installed, as well as other haskell tools.
- The [configuration file for the NixOS](https://nixos.org/manual/nixos/stable/index.html#ch-configuration) production server. This takes care of installing all the necessary software, setup [Nginx](https://www.nginx.com/), and get [ACME certs](https://en.wikipedia.org/wiki/Automated_Certificate_Management_Environment) for verification. - For use with `nix develop .` or [direnv](https://direnv.net)
- `site.hs`
- newSealPost.sh - The hakyll blog is defined here.
- Script to be called daily by a cron job on the server. Generates the post for the day, builds and commits. - Pulls in the rest of the files in this repo and creates a static site at `_site`.
- `config.dhall`
- website/ - The config file for the blog generation, run with `nix run .#generateSealPosts`.
- A basic Hakyll site, slightly modified to serve seals. Most of the site is generated from the `site.hs` file. Check the [Hakyll](https://jaspervdj.be/hakyll/) documentation for more info. - Uses a pseudo random number generator, change the seed to see different outputs in the `postsOutputPath` (default `./posts/`).
- The rest of the code is related to the static hakyll site itself.
## Work to be done - I've tried putting it in it's own `src` or `website` folder but
- it feels like needless refactoring
- The blog post generation and the hosting of the website are currently intertwined when they should be separated - I can't get the flake operations to work :(
- Seal post generator just makes posts
- Hakyll blog imports or calls the post generator
- The deployed server/nix config file has a cron job for adding a new blog and committing every day
- Need to move the blog and post generation inside nixos-apps on my beefier server
- The configuration file here is for it's own Linode, the current small one running, but I have a better setup for that now
- Pull out the useful parts for my deployed server, remove anything not necessary for a small config file
- Also switch to using caddy if not already
- Experiment with `*` A records
- For the seal blog
- Instead of having `www` and `git` and `...` subdomains spelled out in Namecheap
- Just have a `*` record and have caddy do the filtering