doc: Prebundle docs on RHEL & CentOS

With this we can get rid of asciidoc-py dependency altogether and
instead rely on the docs being prebundled before installation.

Signed-off-by: Freya Gustavsson <[email protected]>

Author: Venefilyn

doc/guide/Makefile-guide.am

@@ -142,6 +142,9 @@ GUIDE_PAGES_INST = \
 
 noinst_DATA += $(GUIDE_PAGES_INST)
 
+# Some distros don't have asciidoctor and we need to prebundle the docs, e.g. RHEL & CentOS
+EXTRA_DIST += $(GUIDE_PAGES_INST)
+
 GUIDE_ASCIIDOC_ARGS = \
 	-a cockpit-version=$(VERSION) \
 	-a toc=left \

tools/cockpit.spec

@@ -116,11 +116,9 @@ BuildRequires: nodejs
 BuildRequires: nodejs-esbuild
 %endif
 
-# For documentation
-%if 0%{?rhel} || 0%{?centos}
-# Only has legacy asciidoc-py and not asciidoctor.
-# asciidoc-py includes a2x package which can generate man-pages.
-BuildRequires: asciidoc
+# to avoid using asciidoc-py in RHEL and CentOS we use the prebuilt docs
+%if 0%{?rhel}
+%define bundle_docs 1
 %else
 BuildRequires: asciidoctor
 %endif
@@ -187,6 +185,9 @@ NODE_ENV=production NODE_PATH=/usr/lib/node_modules:$(echo /usr/lib/node_modules
 %if %{enable_multihost}
     --enable-multihost \
 %endif
+%if %{defined bundle_docs}
+    --disable-doc \
+%endif
 
 %make_build
 
@@ -210,6 +211,12 @@ install -p -m 644 %{pamconfig} $RPM_BUILD_ROOT%{pamconfdir}/cockpit
 rm -f %{buildroot}/%{_libdir}/cockpit/*.so
 install -D -p -m 644 AUTHORS COPYING README.md %{buildroot}%{_docdir}/cockpit/
 
+# We install the upstream pre-built docs as we can't build them
+%if %{defined bundle_docs}
+%define docbundledir doc/output/html
+install -D -p -m 644 %{docbundledir} %{buildroot}%{_docdir}/cockpit/
+%endif
+
 # Build the package lists for resource packages
 # cockpit-bridge is the basic dependency for all cockpit-* packages, so centrally own the page directory
 echo '%dir %{_datadir}/cockpit' > base.list