Documentation: improve the look of landing page by showing a more-com…

…pact list
zeromq · Nov 10, 2023 · 32319e2 · 32319e2
1 parent 3e08ecc
commit 32319e2
Show file tree

Hide file tree

Showing 2 changed files with 17 additions and 2 deletions.
diff --git a/doc/Makefile.am b/doc/Makefile.am
@@ -52,7 +52,7 @@ MAINTAINERCLEANFILES += $(HTML_DOC) $(MAN_DOC)
 SUFFIXES=.html .adoc .3 .7
 
 .adoc.html:
-	asciidoctor --backend html --attribute zmq_version=@PACKAGE_VERSION@  $<
+	asciidoctor --backend html  --attribute stylesheet=asciidoctor.css --attribute zmq_version=@PACKAGE_VERSION@  $<
 .adoc.3:
 	asciidoctor --backend manpage --attribute zmq_version=@PACKAGE_VERSION@  $<
 .adoc.7:
@@ -72,7 +72,7 @@ $(builddir)/__pagelist:
 index.html:
 	$(MAKE) $(builddir)/__pagelist
 	asciidoctor --backend html \
-        --attribute zmq_version=@PACKAGE_VERSION@ --attribute zmq_pagelist_dir=$(abs_builddir) \
+        --attribute zmq_version=@PACKAGE_VERSION@ --attribute zmq_pagelist_dir=$(abs_builddir) --attribute stylesheet=asciidoctor.css \
             $(srcdir)/index.adoc
 
 all-local : $(MAN_DOC) $(HTML_DOC)

diff --git a/doc/asciidoctor.css b/doc/asciidoctor.css
@@ -0,0 +1,15 @@
+/* 
+  CSS file for Asciidoctor HTML documentation
+  See https://docs.asciidoctor.org/asciidoctor/latest/html-backend/default-stylesheet/#customize-extend
+  See also https://github.com/darshandsoni/asciidoctor-skins/ for custom "skins"
+*/
+
+/* import the default Asciidoctor CSS file */
+@import "https://cdn.jsdelivr.net/gh/asciidoctor/asciidoctor@2.0/data/stylesheets/asciidoctor-default.css";
+
+/* just make the default HTML list more compact: */
+.ulist p {
+    padding: 0;
+    margin-right: -4px;
+    margin-bottom: -4px;
+}