docspell/website

Website

This is the docspell website and documentation.

Building

The website is created using zola static site generator. The (very minimal) dynamic parts are written in Elm.

Sbt is used to build the site.

Development

Install things by running yarn install.

Use a dev environment and open terminal for each script below:

1. Starting the server

   cd site && zola serve
   

2. Building the stylesheet

   ./scripts/run-styles.sh
   

3. Building some javascript files

   ./scripts/run-elm.sh
   

Open browser at localhost:1111.

Publishing

The above is great when editing, but doesn't fully reflect what will be finally deployed. To see this, start sbt and change into the website project.

$ sbt
sbt> project website

Build everything and check for dead links:

sbt> zolaBuildTest
sbt> zolaCheck

Testing

sbt> ghpagesSynchLocal

The final site is now generated and a simple http server can be used to see how it will look when deployed.

cd ~/.sbt/ghpages/<some-hash>/com.github.eikek/docspell-website
python -m http.server 1234

Open http://localhost:1234 in a browser.