[beast: 4/17] DOCS: build and install beast.1.html from beast.1.md

[Tim Janik <timj src gnome org>]

commit 398be38cfddcc1e83d9b8df1028cabe229db3066
Author: Tim Janik <timj gnu org>
Date:   Sun Mar 19 01:59:16 2017 +0100

    DOCS: build and install beast.1.html from beast.1.md
    
    Signed-off-by: Tim Janik <timj gnu org>

 docs/Makefile.am          |   26 +++++--
 docs/imports/Makefile.am  |    2 +-
 docs/imports/beast.1.html |  195 ---------------------------------------------
 docs/manpage.css          |   15 ++++
 4 files changed, 36 insertions(+), 202 deletions(-)
---
diff --git a/docs/Makefile.am b/docs/Makefile.am
index abb352f..bcf3f31 100644
--- a/docs/Makefile.am
+++ b/docs/Makefile.am
@@ -17,8 +17,8 @@ plugs_doc_sources ::= $(shell make doc_sources.lst -C ../plugins >&2 && cat ../p
 gxk_doc_sources          ::= $(shell make doc_sources.lst -C ../beast-gtk/gxk >&2 && cat 
../beast-gtk/gxk/doc_sources.lst)
 bst_doc_sources          ::= $(shell make doc_sources.lst -C ../beast-gtk >&2 && cat 
../beast-gtk/doc_sources.lst)
 tools_doc_sources ::= $(shell make doc_sources.lst -C ../tools >&2 && cat ../tools/doc_sources.lst)
-man1_HTMLS          = docs/imports/beast.1.html docs/imports/bsescm.1.html docs/imports/bsewavetool.1.html 
docs/imports/sfidl.1.html
-man5_HTMLS          = docs/imports/bse.5.html
+man1_HTMLS          = imports/bsescm.1.html imports/bsewavetool.1.html imports/sfidl.1.html
+man5_HTMLS          = imports/bse.5.html
 
 # == Configure docs ==
 docs_project_link   = http://beast.testbit.eu
@@ -95,10 +95,10 @@ doxy/html: ../docs/doxygen.cfg ../docs/error.ign $(docs_doxy_auxfiles) | doxy/sr
 docs_sed_accesskey_f  = -e 's;(<input [^>]*id="MSearchField"[^>]*accesskey=")S";\1F";'
 docs_sed_project_link = -e 's;<div id="projectname">((\w|[+_/~*%^-])+);<div id="projectname"><a 
href="$(docs_project_link)">\1</a>;'
 CLEANFILES += ../docs/error.log
-doxy/html/doc-version: doxy/html $(patsubst %, ../%, $(man1_HTMLS) $(man5_HTMLS))
+doxy/html/doc-version: doxy/html $(man1_HTMLS) $(man5_HTMLS)
        $(AM_V_GEN)
-       $(Q) cd $(topdir) && test -z "$(man1_HTMLS)" || { $(MKDIR_P) docs/doxy/html/man1/ && cp $(man1_HTMLS) 
docs/doxy/html/man1/ ; }
-       $(Q) cd $(topdir) && test -z "$(man5_HTMLS)" || { $(MKDIR_P) docs/doxy/html/man5/ && cp $(man5_HTMLS) 
docs/doxy/html/man5/ ; }
+       $(Q) test -z "$(man1_HTMLS)" || { $(MKDIR_P) doxy/html/man1/ && cp $(man1_HTMLS) doxy/html/man1/ ; }
+       $(Q) test -z "$(man5_HTMLS)" || { $(MKDIR_P) doxy/html/man5/ && cp $(man5_HTMLS) doxy/html/man5/ ; }
        $(Q) echo "$(PACKAGE)-$(topbuildid)" > $@
 
 # == install docs/doxy/html ==
@@ -159,8 +159,22 @@ clean-local: clean-revisions.lst
        $(AM_V_GEN)
        $(Q) $(PANDOC) -s -t man $< -o $@
 
+# == man.1.html (markdown) ==
+manpage_header.html:
+       $(Q) echo $$'<a href="../index.html">Return to Index</a>\n<hr>\n' > $@
+.INTERMEDIATE: manpage_header.html
+MOSTLYCLEANFILES += manpage_header.html
+manpage_footer.html:
+       $(Q) echo $$'<hr>\n<a href="../index.html">Return to Index</a>\n' > $@
+.INTERMEDIATE: manpage_footer.html
+MOSTLYCLEANFILES += manpage_footer.html
+EXTRA_DIST += ../docs/manpage.css
+%.1.html: %.1.revd.md manpage_header.html manpage_footer.html ../docs/manpage.css
+       $(AM_V_GEN)
+       $(Q) $(PANDOC) -s -t html -S --toc -H $(topdir)/docs/manpage.css -B manpage_header.html -A 
manpage_footer.html $< -o $@
 
 # == beast.1 ==
 revisioned_files       += beast.1.md
 man1_MANS              += beast.1
-MOSTLYCLEANFILES       += beast.1
+man1_HTMLS             += beast.1.html
+MOSTLYCLEANFILES       += beast.1 beast.1.html
diff --git a/docs/imports/Makefile.am b/docs/imports/Makefile.am
index f7bc27b..e02deb6 100644
--- a/docs/imports/Makefile.am
+++ b/docs/imports/Makefile.am
@@ -2,7 +2,7 @@
 include $(top_srcdir)/Makefile.decl
 
 MANMANS            = bse.5 bsescm.1 bsewavetool.1 sfidl.1
-HTMLMANS    = beast.1.html bse.5.html bsescm.1.html bsewavetool.1.html sfidl.1.html
+HTMLMANS    = bse.5.html bsescm.1.html bsewavetool.1.html sfidl.1.html
 EXTRA_DIST += $(MANMANS)
 # HTMLMANS are packaged as part of the doxygen docs
 
diff --git a/docs/manpage.css b/docs/manpage.css
new file mode 100644
index 0000000..903c0ed
--- /dev/null
+++ b/docs/manpage.css
@@ -0,0 +1,15 @@
+<style type="text/css">
+  body { font-family: "DejaVu Serif", "Bitstream Vera Serif", Constantia, "Nimbus Roman No9 L", "Liberation 
Serif", Georgia, serif; }
+  p, dl, dd                    { margin-left: 5em; }
+  pre                          { margin-left: 7em; }
+  h6                           { font-size: 1.05em; }
+  h5                           { font-size: 1.10em; }
+  h4                           { font-size: 1.15em; }
+  h3                           { font-size: 1.20em; }
+  h2                           { font-size: 1.25em; }
+  h1                           { font-size: 1.30em; }
+  h1, h2, h3, h4, h5, h6       { font-style: italic; }
+  h1.title { font-style: normal; text-decoration: underline; }
+  #TOC ul                      { list-style-type: none; margin-left: 0; padding-left: 0; }
+  #TOC                         {  margin-bottom: 3p; border-bottom: 1px solid #555; }
+</style>