Separate content and presentation (aka theme)
The content of the web pages should be indpendent of the presentation. (pdf)
2020-06-18
Presentation can be changed
A change in the presentation style should not affect the content. It must bepossible to move from fixed-width presentation to a presentation which adapts to different screen sized and later to use a Tufte-inspired style without touching the web page content.
Markdown allows to structure the content with hints for the presentation (e.g. title, footnote) but not fixing how these are rendered.
Theme directory
The instructions for presentation, the so called theme
is in a separate directory (here `dainoSite/theme). It is linked
automatically into the baked site.
The theme consists of
- fonts, preferably in the
woff
format, - images
- cascading style sheets (CSS) in
static
folder.
The elements are brought together with the content using the Pandoc
templates and a template to construct a LaTeX
input
file to produce the PDF.Currently master7tufte.dtpl
for HTML
output and latex7.dtpl
for PDF output.