From 5574d14658535b22e8f6141b92d8af1e4df037c0 Mon Sep 17 00:00:00 2001 From: "Richard W.M. Jones" Date: Tue, 7 Dec 2010 18:56:45 +0000 Subject: [PATCH] Add HTML documentation to the public website. --- .gitignore | 3 ++ Makefile.am | 24 +++++++++ helper/Makefile.am | 11 ++++ html/pod.css | 155 +++++++++++++++++++++++++++++++++++++++++++++++++++++ 4 files changed, 193 insertions(+) create mode 100644 html/pod.css diff --git a/.gitignore b/.gitignore index a2707fb..66161c7 100644 --- a/.gitignore +++ b/.gitignore @@ -28,6 +28,8 @@ febootstrap*.txt febootstrap-*.tar.gz helper/febootstrap-supermin-helper helper/init +html/febootstrap-supermin-helper.8.html +html/febootstrap.8.html lib/alloca.h lib/arg-nonnull.h lib/c++defs.h @@ -45,6 +47,7 @@ lib/wchar.h INSTALL install-sh missing +pod2htm?.tmp stamp-h1 /warn-on-use.h examples/guestfs diff --git a/Makefile.am b/Makefile.am index d04412c..168bb47 100644 --- a/Makefile.am +++ b/Makefile.am @@ -94,4 +94,28 @@ febootstrap.8: febootstrap.pod -c "Virtualization Support" \ --release "$(PACKAGE_NAME)-$(PACKAGE_VERSION)" \ $< > $@ + +noinst_DATA = \ + html/febootstrap.8.html + +html/febootstrap.8.html: febootstrap.pod + mkdir -p html + pod2html \ + --css 'pod.css' \ + --htmldir html \ + --outfile html/febootstrap.8.html \ + febootstrap.pod + endif + +# Maintainer website update. +HTMLFILES = \ + html/febootstrap.8.html \ + html/febootstrap-supermin-helper.8.html + +WEBSITEDIR = $(HOME)/d/redhat/websites/libguestfs + +website: $(HTMLFILES) + cp $(HTMLFILES) $(WEBSITEDIR) + +CLEANFILES += $(HTMLFILES) pod2*.tmp diff --git a/helper/Makefile.am b/helper/Makefile.am index fb356a4..c747269 100644 --- a/helper/Makefile.am +++ b/helper/Makefile.am @@ -63,6 +63,17 @@ febootstrap-supermin-helper.8: febootstrap-supermin-helper.pod --release "$(PACKAGE_NAME)-$(PACKAGE_VERSION)" \ $< > $@ +noinst_DATA = \ + $(top_builddir)/html/febootstrap-supermin-helper.8.html + +$(top_builddir)/html/febootstrap-supermin-helper.8.html: febootstrap-supermin-helper.pod + mkdir -p $(top_builddir)/html + cd $(top_builddir) && pod2html \ + --css 'pod.css' \ + --htmldir html \ + --outfile html/febootstrap-supermin-helper.8.html \ + helper/febootstrap-supermin-helper.pod + endif EXTRA_DIST = \ diff --git a/html/pod.css b/html/pod.css new file mode 100644 index 0000000..d90ebb5 --- /dev/null +++ b/html/pod.css @@ -0,0 +1,155 @@ +/* CSS to make pod2html files look a little bit better. */ + +body { + margin-left: 4em; +} + +body p, body ul, ol, body dl { + margin-left: 2em; + width: 31em; +} + +pre { + width: 31em; +} + +li { + padding-bottom: 0.5em; +} + +/* Code sections. */ + +pre { + background-color: #f8f8f8; + color: rgb(204,0,0); + font-weight: 550; + border-left: 6px solid rgb(204,64,64); + padding: 6px; + margin-left: 1em; + font-size: 120%; +} + +/* Bold, italic in man pages. */ +b, strong { + color: rgb(204,0,0); +} + +i, em { + color: rgb(204,0,0); +} + +/* Name heading. */ + +body > h1:first-of-type { + display: none; +} + +body > h1:first-of-type + p { + font-size: 125%; + font-weight: bold; + color: rgb(204,0,0); + margin-left: -32px; +} + +/* Warning heading in man pages. */ +a[name="warning"] { + -moz-border-radius-topleft: 5px; + -moz-border-radius-topright: 5px; + border-radius-topleft: 5px; + border-radius-topright: 5px; + + color: white; + background-color: rgb(204,0,0); +} +a[name="warning"]:before { + content: "\00a0\00a0\00a0"; +} +a[name="warning"]:after { + content: "\00a0\00a0\00a0"; +} + +/* Put the index on the right hand side in a floating box. */ +div[name="index"] { + float: right; + width: 18em; + border-left: 3em solid white; + background-color: #fcfcfc; + margin-top: 32px; + padding-top: 0px; + margin-left: 1em; + padding-left: 1em; + padding-right: 1em; + font-size: 90%; +} + +div[name="index"] a[href] { + text-decoration: none; +} + +div[name="index"] a[href]:hover { + text-decoration: underline; +} + +div[name="index"] a[href]:before { + content: '#\00a0'; + color: rgb(204,0,0); + font-size: x-small; +} + +div[name="index"] > ul { + width: 17em; + list-style: none; + margin-left: 0px; + margin-right: 0px; + padding-left: 0px; + padding-right: 0px; +} + +div[name="index"] > ul > li { + margin-bottom: 0.5em; +} + +div[name="index"] > ul ul { + width: 16em; + list-style: none; + margin-left: 0px; + margin-right: 0px; + padding-left: 0px; + padding-right: 0px; + margin-bottom: 0.5em; +} + +div[name="index"] > ul > ul li { + display: inline; + margin-right: 1em; +} + +/* +div[name="index"] > ul > ul li:after { + color: #ccc; + content: '\2014'; +} +*/ + +/* Get rid of those horrible
's :-( */ +hr { display: none; } + +/* Demote

's and set rest of headers relative. */ +h1 { + font-size: 100%; + color: black; + border-bottom: solid 1px rgb(204,0,0); +} + +h2 { + font-size: 95%; + border-bottom: none; +} + +h3 { + font-size: 90%; +} + +h4 { + font-size: 85%; +} -- 1.8.3.1