Vimwiki HTML pipeline

Github actions pipeline to build and deploy a static HTML page generated from my personal vimwiki notes.

This pipeline is triggered when I make a commit to my notes repo, which then deploys the latest version to my raspberry Pi running a self-hosted github runner.

Docker build image

The repo includes an alpine based image ready to convert vimwiki markdown files to HTML.

Usage

1. Pull the image:

    docker pull docker.io/lexvar/vimwiki-build:latest
   

2. Run the container with the vimwiki volume mounted to /root/vimwiki:

    docker run -it -v $PWD/vimwiki:/root/vimwiki docker.io/lexvar/vimwiki-build:latest
   

The output html files will be inside the vimwiki/site_html directory.

Tools

• ansible v2.9+
• docker
• vimwiki_markdown