daino: daino is a static site generator (SSG) using shake and pandoc

[ development-web, library, program ] [ Propose Tags ]

A static site generator using Pandoc and other available packages on Hackage (e.g. shake, twitch, scotty), influenced by Chris Penner's slick. It uses text files (in Markdown codes) to manage data and relies on version management with git. Page appearances are directed with YAML headers. For each page a PDF file is produced to allow regular print output. Index pages for navigation between pages are automatically created.


[Skip to Readme]

Downloads

Maintainer's Corner

Package maintainers

For package maintainers and hackage trustees

Candidates

  • No Candidates
Versions [RSS] 0.1.5.2
Change log changelog.md
Dependencies base (>4.7 && <5), daino, data-default-class, deepseq, dir-traverse, filepath, pandoc, pandoc-sidenote, path, path-io, ReplaceUmlaut, uniform-cmdLineArgs (>=0.1.5.1), uniform-http, uniform-json (>=0.1.5.2), uniform-latex2pdf (>=0.1.5.2), uniform-pandoc (>=0.1.5.2), uniform-shake, uniform-strings (>=0.1.5.1), uniform-watch, uniform-webserver, uniformBase (>=0.1.5.1), unix [details]
License LicenseRef-GPL
Copyright 2021 Andrew U. Frank
Author Andrew Frank
Maintainer Andrew U. Frank <frank@geoinfo.tuwien.ac.at>
Category Development Web
Home page https://github.com/andrewufrank/u4blog.git#readme
Bug tracker https://github.com/andrewufrank/u4blog.git/issues
Source repo head: git clone https://github.com/andrewufrank/u4blog.git(daino)
Uploaded by andrewufrank at 2023-04-06T20:56:51Z
Distributions
Executables daino
Downloads 50 total (6 in the last 30 days)
Rating (no votes yet) [estimated by Bayesian average]
Your Rating
  • λ
  • λ
  • λ
Status Docs available [build log]
Last success reported on 2023-04-06 [all 1 reports]

Readme for daino-0.1.5.2

[back to package description]

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 git@github.com:andrewufrank/dainoSite.

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!