This issue lists Renovate updates and detected dependencies. Read the Dependency Dashboard docs to learn more.

Open

These updates have all been created already. Click a checkbox below to force a retry/rebase of any.

• Update docker/setup-buildx-action action to v3
• Update docker/setup-qemu-action action to v3

Detected dependencies

• Check this box to trigger a request for Renovate to run again on this repository

I have a build directory within my Antora project's home, would it be possible to specify the location of both the UI bundle (zip file) and supplemental-ui folder at container start.

./build/ui-bundle.zip
./build/supplemental-ui

Using FF 80.0.1 (64-bit). Ubuntu 18.04 LTS app under WSL with Docker Desktop.

Summary

Using docker via lima on macOS breaks the livereload.

Context

Lima uses sshfs to map local folders to the docker VM and inotify doesn't seem to be working properly in that case.

To Reproduce

• Start lima VM
• Configure Docker to use lima
• Start the antora-preview container
• Edit .adoc files
• The docker container doesn't register the changes and doesn't trigger a rebuild

Workaround

Using guard locally with this configuraton:

group :documentation do
    # Rebuild documentation when modifying files
    guard :shell do
        watch(/(.*).adoc/) do
            `docker exec -it antora antora --cache-dir=/preview/public/.cache/antora /preview/playbook.yml`
        end
    end

    # Refresh browser when folder with HTML files changes
    guard :livereload do
        watch(/(.*).adoc/)
    end
end

Then run it:

cd project
guard &
docker run --name antora --rm --publish 35729:35729 --publish 2020:2020 --volume "${pwd}":/preview/antora -d vshn/antora-preview:2.3.12 --antora=docs --style=vshn

Not really sure how this could be solved though. Maybe just document this workaround somewhere? Also most people probably use Docker Desktop on Macs.

Running:

docker run --rm --publish 35729:35729 --publish 2020:2020 --volume "${PWD}":/preview/antora vshn/antora-preview:2.3.4 --antora=docs --style=appuio

It returns:

Cannot find Antora file '/preview/antora/docs/antora.yml'

Currently the Docker image requires two ports exposed:

• Web server port (Caddy) configured as 2020;
• LiveReload port, configured as 35729 by default.

Make these two configurable via environment variables, following this suggestion by @corvus-ch in this PR comment.

Does your preview setup serve a custom 404 html page?

I'm new to Caddyfile format, but shouldn't you also have something like:

handle_errors {
	rewrite * /{err.status_code}.html
	file_server
}

For some reason this was not working with 2.6.4-alpine version and I downgraded to 2.6.3-alpine and it works, partially.
If the request is nested (e.g. localhost:port/some-path/somefile), then the CSS and js files are not found.

Do you think this is an issue with Caddy or Antora 404.html generated file?

EDIT: It looks like the issue was with the 404.html file. The file generated from the Default-UI preview src outputs:

<script id="site-script" src="_/js/site.js" data-ui-root-path="_"></script>
<script async src="_/js/vendor/highlight.js"></script>

And it should be absolute path: src="/_/js/site.js"

Currently it's a pain to use make preview in the docs repos on an Apple Silicon Mac.

Although docker can be run through rosetta, it's very unstable and unreliable. The only option is to use qemu emulation which is slow. Most docs take over 1minute to build this way.