Compare commits

..

No commits in common. "a0d3a5fca243058fb13ae77be873a7d1cf28eda2" and "1772b80ab30752713ecd8ce749f0c7a261839daf" have entirely different histories.

2 changed files with 39 additions and 21 deletions

View File

@ -1,10 +1,6 @@
# 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?
@ -14,19 +10,30 @@ It's an in-joke.
seal-blog/
- `flake.nix`
- The specification for everything is repo can do.
- 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`.
- Creates a shell with the same ghc installed, as well as other haskell tools.
- For use with `nix develop .` or [direnv](https://direnv.net)
- `site.hs`
- The hakyll blog is defined here.
- Pulls in the rest of the files in this repo and creates a static site at `_site`.
- `config.dhall`
- The config file for the blog generation, run with `nix run .#generateSealPosts`.
- 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.
- I've tried putting it in it's own `src` or `website` folder but
- it feels like needless refactoring
- I can't get the flake operations to work :(
- devops/
- build.sh
- Uses a [nix-shell](https://nixos.wiki/wiki/Development_environment_with_nix-shell) expression to build the Hakyll executable
- configuration.nix
- 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.
- newSealPost.sh
- Script to be called daily by a cron job on the server. Generates the post for the day, builds and commits.
- website/
- 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.
## Work to be done
- The blog post generation and the hosting of the website are currently intertwined when they should be separated
- 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

11
website.cabal Normal file
View File

@ -0,0 +1,11 @@
name: website
version: 0.1.0.0
build-type: Simple
cabal-version: >= 1.10
executable site
main-is: site.hs
build-depends: base == 4.*
, hakyll == 4.13.*
ghc-options: -threaded
default-language: Haskell2010