pantheontech / stonework Goto Github PK

The release process currently tags and then publishes images for tags as following:

=> new tag v21.06.0 is pushed and release process starts:

1. image is built with tag :21.06.0 for this specific tag
2. then rolling release image is tagged :21.06
3. and finally the :latest tag is updated to this release

This process is okay for the actual releases, but it should be fixed to skip step 2 and 3 for pre-releases: e.g. v21.06.1-rc1, or simply any version with suffix -*. This is because we do not want to update rolling release image or latest image tags for these pre-releases.

Add a list of required packages to documentation?

All text in docs/config/STONEWORK-CONFIG.md after line 3403:

The internal links in the PDF generated from docs/config/STONEWORK-CONFIG.md are broken. The .md file uses <a name=""/> HTML tags for internal links which are supported by Github markdown viewer, but not by pandocs (program used to generate PDFs) default PDF engine pdflatex. Implicit internal links (https://pandoc.org/MANUAL.html#internal-links) can't be used because resulting headers would be too long + add unnecessary noise and header attributes (https://pandoc.org/MANUAL.html#extension-header_attributes) don't seem to be supported by Github markdown.

Currently, the solution is to use a PDF engine that can interpret HTML tags e.g. weasyprint:

pandoc STONEWORK-CONFIG.md -o STONEWORK-CONFIG.pdf --pdf-engine=weasyprint -c style.css

style.css for proper table rendering:

body {
        font-size: 12px;
}

a {
        text-decoration: none;
}

table, th, td {
        border: 1px solid;
        border-collapse: collapse;
}

th, td {
        padding: 3px;
}

The problem is that weasyprint and the pandoc version supporting it aren't included in the Ubuntu 18.04 repositories. 18.04 is currently used for the Docker image responsible for STONEWORK-CONFIG.pdf generation. 20.04 does include all required packages by default. On 18.04 direct download and installation of pandoc and weasyprint binaries is required.

Further information and reference: #12

While building StoneWork as per docs/BUILD.md, the make dev-image fails with "manifest unknown".