Merge branch 'hotfix/0.9.1'

- pdftools: `mkpdfa` invocation
- pdftools: `PDFA_def.ps` location
- use sRGB by default for better compatibility

.drone.yml

@@ -3,12 +3,33 @@ kind: pipeline
 name: default
 
 steps:
-- name: docker
+- name: default
   image: plugins/docker
   settings:
     repo: ldericher/autodoc
-    auto_tag: true
     username:
       from_secret: DOCKER_USERNAME
     password:
       from_secret: DOCKER_PASSWORD
+    auto_tag: true
+    dockerfile: Dockerfile.alpine
+    target: stage-base
+
+- name: diagram
+  image: plugins/docker
+  settings:
+    repo: ldericher/autodoc
+    username:
+      from_secret: DOCKER_USERNAME
+    password:
+      from_secret: DOCKER_PASSWORD
+    auto_tag: true
+    auto_tag_suffix: diagram
+    dockerfile: Dockerfile.ubuntu
+    target: stage-diagram
+  
+- name: parallelism provider
+  image: alpine
+  depends_on:
+    - default
+    - diagram

.gitattributes

@@ -0,0 +1 @@
+*.icc filter=lfs diff=lfs merge=lfs -text

Dockerfile

@@ -1,15 +0,0 @@
-FROM pandoc/extra:latest
-
-RUN set -ex; \
-    \
-    apk add --no-cache \
-      bash \
-      inotify-tools \
-      make \
-    ;
-
-COPY src/usr /usr
-
-WORKDIR /docs
-ENTRYPOINT ["autodoc"]
-CMD ["-bw"]

Dockerfile.alpine

@@ -0,0 +1,57 @@
+FROM pandoc/extra:latest AS stage-base
+
+RUN set -ex; \
+    \
+    apk add --no-cache \
+      bash \
+      ghostscript \
+      inotify-tools \
+      make \
+      patch \
+    ; \
+    \
+    tlmgr update --self; \
+    \
+    tlmgr install \
+      kpfonts \
+      lastpage \
+      latexmk \
+      twemojis \
+    ;
+
+COPY src/usr /usr
+
+RUN set -ex; \
+    \
+    cp /usr/share/ghostscript/lib/PDFA_def.ps /usr/local/share/autodoc/; \
+    patch -d /usr/local/share/autodoc < /usr/local/share/autodoc/PDFA_def.ps.patch; \
+    rm /usr/local/share/autodoc/PDFA_def.ps.patch;
+
+WORKDIR /docs
+ENTRYPOINT ["autodoc"]
+CMD ["-bw"]
+
+FROM stage-base AS stage-diagram
+
+ENV PUPPETEER_CACHE_DIR="/usr/local/share/puppeteer/cache" \
+    PUPPETEER_EXECUTABLE_PATH="/usr/bin/chromium-browser" \
+    PUPPETEER_SKIP_CHROMIUM_DOWNLOAD="true"
+
+COPY src/diagram.lua.patch /usr/local/src/autodoc/diagram.lua.patch
+
+RUN set -ex; \
+    \
+    apk add --no-cache \
+      chromium \
+      npm \
+    ; \
+    \
+    npm install --global @mermaid-js/mermaid-cli; \
+    # rm -rf /root/.cache/puppeteer; \
+    \
+    wget \
+      --output-document='/usr/local/share/pandoc/filters/diagram.lua' \
+      'https://raw.githubusercontent.com/pandoc-ext/diagram/refs/heads/main/_extensions/diagram/diagram.lua' \
+    ; \
+    patch /usr/local/share/pandoc/filters/diagram.lua < /usr/local/src/autodoc/diagram.lua.patch; \
+    rm /usr/local/src/autodoc/diagram.lua.patch;

Dockerfile.ubuntu

@@ -0,0 +1,64 @@
+FROM pandoc/extra:latest-ubuntu AS stage-base
+
+RUN set -ex; \
+    \
+    deluser --remove-home ubuntu; \
+    \
+    apt-get update; apt-get install --no-install-recommends --yes \
+      ghostscript \
+      inotify-tools \
+      make \
+      patch \
+    ; rm -rf /var/lib/apt/lists/*; \
+    \
+    tlmgr update --self; \
+    \
+    tlmgr install \
+      kpfonts \
+      lastpage \
+      latexmk \
+      twemojis \
+    ;
+
+COPY src/usr /usr
+
+RUN set -ex; \
+    \
+    cp /usr/share/ghostscript/10.02.1/lib/PDFA_def.ps /usr/local/share/autodoc/; \
+    patch -d /usr/local/share/autodoc < /usr/local/share/autodoc/PDFA_def.ps.patch; \
+    rm /usr/local/share/autodoc/PDFA_def.ps.patch;
+
+WORKDIR /docs
+ENTRYPOINT ["autodoc"]
+CMD ["-bw"]
+
+FROM stage-base AS stage-diagram
+
+ENV PUPPETEER_CACHE_DIR="/usr/local/share/puppeteer/cache"
+
+COPY src/diagram.lua.patch /usr/local/src/autodoc/diagram.lua.patch
+
+RUN set -ex; \
+    \
+    apt-get update; apt-get install --no-install-recommends --yes \
+      libasound2t64 \
+      libatk1.0-0t64 \
+      libatk-bridge2.0-0t64 \
+      libgbm1 \
+      libnss3 \
+      libxcomposite1 \
+      libxdamage1 \
+      libxfixes3 \
+      libxkbcommon0 \
+      libxrandr2 \
+      npm \
+    ; rm -rf /var/lib/apt/lists/*; \
+    \
+    npm install --global @mermaid-js/mermaid-cli; \
+    \
+    wget \
+      --output-document='/usr/local/share/pandoc/filters/diagram.lua' \
+      'https://raw.githubusercontent.com/pandoc-ext/diagram/refs/heads/main/_extensions/diagram/diagram.lua' \
+    ; \
+    patch /usr/local/share/pandoc/filters/diagram.lua < /usr/local/src/autodoc/diagram.lua.patch; \
+    rm /usr/local/src/autodoc/diagram.lua.patch;

Makefile

@@ -1,28 +0,0 @@
-image_tag = ldericher/autodoc
-docker_build = docker build
-docker_run = docker run --rm -it
-examples_flags = -v "$(shell pwd)/examples:/docs" -u "$(shell id -u):$(shell id -g)"
-
-.PHONY: default
-default:
-	$(info use other targets: image build watch shell clean)
-
-.PHONY: image
-image:
-	$(docker_build) --tag $(image_tag) ./
-
-.PHONY: build
-build: image
-	$(docker_run) $(examples_flags) $(image_tag) -b
-
-.PHONY: watch
-watch: image
-	$(docker_run) $(examples_flags) $(image_tag)
-
-.PHONY: shell
-shell: image
-	$(docker_run) $(examples_flags) --entrypoint ash $(image_tag)
-
-.PHONY: clean
-clean:
-	git clean -xdf ./examples

src/diagram.lua.patch

@@ -0,0 +1,11 @@
+--- diagram.lua
++++ diagram.lua
+@@ -158,7 +158,7 @@
+         write_file(infile, code)
+         pipe(
+           self.execpath or 'mmdc',
+-          {"--pdfFit", "--input", infile, "--output", outfile},
++          {"--pdfFit", "--puppeteerConfigFile", "/usr/local/share/puppeteer/config.json", "--input", infile, "--output", outfile},
+           ''
+         )
+         return read_file(outfile), mime_type

src/usr/local/share/autodoc/PDFA_def.ps.patch

@@ -0,0 +1,11 @@
+--- PDFA_def.ps
++++ PDFA_def.ps
+@@ -9,7 +9,7 @@
+   /DOCINFO pdfmark
+ 
+ % Define an ICC profile :
+-/ICCProfile (srgb.icc) % Customise
++/ICCProfile (/usr/local/share/autodoc/sRGB.icc) % Customise
+ def
+ 
+ [/_objdef {icc_PDFA} /type /stream /OBJ pdfmark

src/usr/local/share/autodoc/pdftools.mk

@@ -0,0 +1,46 @@
+#############
+# FUNCTIONS #
+#############
+
+PDFTOOLS_GSFLAGS := \
+	-sDEVICE=pdfwrite \
+	-dNOOUTERSAVE \
+	-dNOPAUSE \
+	-dQUIET \
+	-dBATCH
+
+pdftools_pdfcat = gs \
+	$(PDFTOOLS_GSFLAGS) \
+	-sPAPERSIZE=a4 \
+	-dFIXEDMEDIA \
+	-dPDFFitPage \
+	-dCompatibilityLevel=1.7 \
+	-dPDFSETTINGS=/ebook \
+	-sOutputFile=$(2) \
+	$(1)
+
+pdftools_mkpdfa = gs \
+	$(PDFTOOLS_GSFLAGS) \
+	-dPDFA=$(1) \
+	-sColorConversionStrategy=RGB \
+	-dPDFACompatibilityPolicy=1 \
+	--permit-file-read=/usr/local/share/autodoc/ \
+	-sOutputFile=$(3) \
+	/usr/local/share/autodoc/PDFA_def.ps \
+	$(2)
+
+############
+# PATTERNS #
+############
+
+# convert PDF to PDF/A-2B
+%_pdfa2.pdf: %.pdf
+	$(call pdftools_mkpdfa,2,$<,$@)
+
+# convert PDF to PDF/A-3B
+%_pdfa3.pdf: %.pdf
+	$(call pdftools_mkpdfa,3,$<,$@)
+
+# convert PDF to PDF/A (default variant 3B)
+%_pdfa.pdf: %.pdf
+	$(call pdftools_mkpdfa,3,$<,$@)

src/usr/local/share/puppeteer/config.json

@@ -0,0 +1,3 @@
+{
+    "args": [ "--no-sandbox" ]
+}