Skip to content

a static site generator (yet another...) - constructed around pandoc, shake, twich

License

Notifications You must be signed in to change notification settings

andrewufrank/daino

Repository files navigation

Daino: A Static Site Generator

A static site generator designed by an academic to allow:

  • web pages written as (Pandoc) markdown (with YAML header for title etc.),
  • use a page layout inspired by Tufte,
  • create publication list to download copies from bibtex database,
  • offer printable pdf files for all content,
  • web site using multiple languages with tools to facilitate text input,
  • content and appearances (theme) separated,
  • a single yaml file for setup, and
  • a self-contained result which can be hosted on any web server.

Software reuse:

Daino is focused on software reuse. It uses pandoc and other available packages on Hackage (e.g. shake, twitch, scotty),

It was influenced by Chris Penner's slick, newer, and seemingly simpler is Ema by Sridhar Ratnakumar, but the documentation did not detail its features neither how it is built.

Relies on git for version management.

Installation

The code can be installed with cabal or stack from hackage.

Compilation and linking brings in a large number of packages, e.g. Pandoc, and may take a while; on a typically AMD computer 30..60 Minutes, on a ARM64 (e.g. RaspberryPi4) four times as long for the initial installation. Rebuilding, however, is quick.

Example site

The example site shown here can be downloaded or cloned from github with git clone https://github.com/andrewufrank/dainoSite.git".

Running your own site

Copying the folder dainoSite to a suitable directory and edit the settinsNN.yaml file found there is enough to start your own site with running daino -qs in this directory. The ReadMe shown in a browser with localhost:3000 includes detailed instructions!

About

a static site generator (yet another...) - constructed around pandoc, shake, twich

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published