Documentation: improve the look of landing page (#4625)

* Documentation: improve the look of landing page by showing a more-compact list
This commit is contained in:
Francesco Montorsi 2023-11-10 12:42:46 +01:00 committed by GitHub
parent 3e08ecc012
commit 481d536713
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 18 additions and 2 deletions

View File

@ -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)

16
doc/asciidoctor.css Normal file
View File

@ -0,0 +1,16 @@
/* SPDX-License-Identifier: MPL-2.0 */
/*
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;
}