Add files for building documentation into a Docker image for web serving. #186

witten · 2019-05-20T18:51:59Z

witten commented

2019-05-20 18:51:59 +00:00

Most of this was transplanted from a separate repository that contains the whole torsion.org site contents. My motivation for moving this is that, eventually, I'd like to put the building and deployment of borgmatic docs directly into CI so that it's a more automated process. This is a first step in that direction, in that it moves borgmatic-specific content into the borgmatic repository.

In terms of the Docker image itself, its content comes from a static site generator called Eleventy. The files in this PR are config, templates, and CSS necessary to make Eleventy work, plus a Dockerfile and a couple of bash scripts to tie it all together. In the future, some of this could be added to CI and run automatically.

Testing: Rejiggered the external torsion.org provisioning to make use of this new borgmatic docs image for everything in the https://torsion.org/borgmatic/ URL space. Ran provisioning (Ansible + Docker Compose), and observed that the borgmatic web site still works.

Most of this was transplanted from a separate repository that contains the whole torsion.org site contents. My motivation for moving this is that, eventually, I'd like to put the building and deployment of borgmatic docs directly into CI so that it's a more automated process. This is a first step in that direction, in that it moves borgmatic-specific content into the borgmatic repository. In terms of the Docker image itself, its content comes from a static site generator called [Eleventy](https://www.11ty.io/). The files in this PR are config, templates, and CSS necessary to make Eleventy work, plus a Dockerfile and a couple of bash scripts to tie it all together. In the future, some of this could be added to CI and run automatically. Testing: Rejiggered the external [torsion.org provisioning](https://projects.torsion.org/witten/provisioning/src/branch/master/roles/torsion.org/tasks/main.yml) to make use of this new borgmatic docs image for everything in the https://torsion.org/borgmatic/ URL space. Ran provisioning (Ansible + Docker Compose), and observed that the borgmatic web site still works.

witten closed this pull request

2019-05-21 03:16:32 +00:00

witten deleted branch docs-image

2019-05-21 03:16:39 +00:00

decentral1se commented

2019-05-21 09:44:57 +00:00

My motivation for moving this is that, eventually, I’d like to put the building and deployment of borgmatic docs directly into CI so that it’s a more automated process.

Grea idea.

> My motivation for moving this is that, eventually, I’d like to put the building and deployment of borgmatic docs directly into CI so that it’s a more automated process. Grea idea.

Sign in to join this conversation.

No reviewers