Skip to content

gesker/gesker.github.io

Repository files navigation

gesker.github.io

About Dennis R. Gesker

MdBook

mdbook project to create an about page. mdbook build to create html

A git action has been created to build and deploy the git pages

MdBook Local Development

To watch and server on localhost port 3000 as you are editing md files:

mdbook serve --open

Extra Plugins Used

DNS

dennis.gesker.com is CNAME to gesker.github.io <www.gesker.com> is a server side redirect to dennis.gesker.com

Flake

Added flake.nix to project so that this repository can be consumed as a Nix/NixOS flake module. The flake in this project make use of flake-parts.

  • nix build to build the project using nix package system
  • nix developto enter a development shell and work on the project

mdbook-pdf Issues

The book-with-pdf.toml configuration file does NOT yet work using nix build does not seem to allow network access and the mdbook-pdf does seem to need network access even though it does not actually reach out to an external network but needs IO to process the website into a pdf. I don't currently have a clean workaround. Perhaps but the build into a container?

Current workaround to generate the pdf manually via nix develop and temporarily pointing the [book.toml]./(book.toml) symlink at the book-with-pdf.toml configuration that includes the mdbook-pdf directives.

The flake.nix makes use of the Oxalica rust-overlay in order to be sure to use the most recent stable version of the rust sdk and related build tools.

Zalag Logo

Zalag Logo is a registered trademark. All right reserved. Zalag Logo Copyright Dennis Gesker