docs: nicer code blocks

diff --git a/doc/Makefile b/doc/Makefile
index 780b0cefafe902cd1afd284cfa84e0dfca5ca322..4fa52432c9634a6aaa90440d4fb81f489eca804f 100644 (file)
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -23,6 +23,9 @@ COMMON = common.switches.txt common.config.txt common.logutriga.txt
 
 GETATTRS = python ./getattrs.py
 
+#AFLAGS = -a linkcss
+#AFLAGS = -a stylesheet=extra.css
+
 all: man $(HTMLS)
 
 man: londiste.1 londiste.5 pgqadm.1 $(SCRIPT_MANS)
@@ -111,17 +114,22 @@ endif
 %.html: %.txt $(COMMON)
        LANG=C cat $< \
        | sed -e '/^include/b;s,\([A-Za-z.0-9]*\)[.]txt,link:\1.html[],g' \
-       | $(ASCIIDOC) -a toc `$(GETATTRS) $<` -o $@ -
-       #$(ASCIIDOC) -a toc `$(GETATTRS) $<` $<
+       | $(ASCIIDOC) $(AFLAGS) -a toc `$(GETATTRS) $<` -o - - \
+       | sed -e "/^[/][*] Workarounds/r extra.css" \
+       > $@
 
 README.html: ../README
        cat $< \
        | sed -e 's,doc/\([!-~]*\)[.]txt,link:\1.html[],g' \
              -e 's,http:[!-~]*,&[],g' \
-       | $(ASCIIDOC) -o $@ -
+       | $(ASCIIDOC) $(AFLAGS) -o - - \
+       | sed -e "/^[/][*] Workarounds/r extra.css" \
+       > $@
 
 INSTALL.html: ../INSTALL
-       $(ASCIIDOC) -o $@ $<
+       $(ASCIIDOC) $(AFLAGS) -o - $< \
+       | sed -e "/^[/][*] Workarounds/r extra.css" \
+       > $@
 endif
 
 web: $(HTMLS)

diff --git a/doc/extra.css b/doc/extra.css
new file mode 100644 (file)
index 0000000..eb44f10
--- /dev/null
+++ b/doc/extra.css
@@ -0,0 +1,9 @@
+\r
+/* extra.css: make code blocks more different */\r
+div.literalblock {\r
+  border: 1px solid silver;\r
+  background: #f4f4f4;\r
+  padding: 0.5em;\r
+}\r
+/* eof extra.css */\r
+\r