diff --git a/Makefile b/Makefile new file mode 100644 index 0000000..11b0acc --- /dev/null +++ b/Makefile @@ -0,0 +1,54 @@ +pages := $(shell find . -type f -name '*.adoc') +web_dir := ./_public + +# Determine whether to use podman +# +# podman currently fails when executing in GitHub actions on Ubuntu LTS 20.04, +# so we never use podman if GITHUB_ACTIONS==true. +use_podman := $(shell command -v podman 2>&1 >/dev/null; p="$$?"; \ + if [ "$${GITHUB_ACTIONS}" != "true" ]; then echo "$$p"; else echo 1; fi) + +ifeq ($(use_podman),0) + engine_cmd ?= podman + engine_opts ?= --rm --tty --userns=keep-id +else + engine_cmd ?= docker + engine_opts ?= --rm --tty --user "$$(id -u)" +endif + +# renovate: datasource=github-releases depName=vshn/antora +antora_VERSION ?= 3.1.2.3 +antora_cmd ?= $(engine_cmd) run $(engine_opts) --volume "$${PWD}":/antora ghcr.io/vshn/antora:$(antora_VERSION) + +# renovate: datasource=github-releases depName=vshn/antora-preview +preview_VERSION ?= 3.1.2.3 +antora_opts ?= --cache-dir=.cache/antora +preview_cmd ?= $(engine_cmd) run --rm --publish 35729:35729 --publish 2020:2020 --volume "${PWD}":/preview/antora ghcr.io/vshn/antora-preview:$(preview_VERSION) --antora=docs --style=vshn + +UNAME := $(shell uname) +ifeq ($(UNAME), Linux) + OS = linux-x64 + OPEN = xdg-open +endif +ifeq ($(UNAME), Darwin) + OS = darwin-x64 + OPEN = open +endif + +.PHONY: docs-clean +clean: + rm -rf $(web_dir) .cache + +.PHONY: docs-open +docs-open: $(web_dir)/index.html + -$(OPEN) $< + +.PHONY: docs-html +docs-html: $(web_dir)/index.html + +.PHONY: docs-preview +docs-preview: + $(preview_cmd) + +$(web_dir)/index.html: playbook.yml $(pages) + $(antora_cmd) $(antora_opts) $< diff --git a/docs/antora.yml b/docs/antora.yml new file mode 100644 index 0000000..ba86364 --- /dev/null +++ b/docs/antora.yml @@ -0,0 +1,6 @@ +name: ROOT +title: Servala Documentation +version: ~ +start_page: ROOT:index.adoc +nav: + - modules/ROOT/nav.adoc diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc new file mode 100644 index 0000000..5d67faa --- /dev/null +++ b/docs/modules/ROOT/nav.adoc @@ -0,0 +1 @@ +* xref:index.adoc[Home] diff --git a/docs/modules/ROOT/pages/index.adoc b/docs/modules/ROOT/pages/index.adoc new file mode 100644 index 0000000..50e418f --- /dev/null +++ b/docs/modules/ROOT/pages/index.adoc @@ -0,0 +1,3 @@ += Servala + +Hello World diff --git a/playbook.yml b/playbook.yml new file mode 100644 index 0000000..5546979 --- /dev/null +++ b/playbook.yml @@ -0,0 +1,33 @@ +site: + title: Servala + url: https://docs.servala.com/ + start_page: servaka::index.adoc + robots: | + User-agent: * + Allow: * +content: + sources: + - url: https://servala-2nkgm.app.codey.ch/servala/servala-portal.git + branches: ["main"] + start_path: docs + edit_url: "https://servala-2nkgm.app.codey.ch/servala/servala-portal/_edit/main/{path}" +ui: + bundle: + url: https://github.com/vshn/antora-ui-default/releases/download/2.2.6/ui-bundle.zip + snapshot: true +asciidoc: + attributes: + page-pagination: "" + hide-uri-scheme: "" + experimental: "" + stem: "" + icons: font + kroki-server-url: https://kroki.vshn.net + kroki-fetch-diagram: "" + extensions: + - asciidoctor-kroki +output: + destinations: + - provider: fs + path: ./_public + clean: true