[beast: 4/17] DOCS: build and install beast.1.html from beast.1.md
- From: Tim Janik <timj src gnome org>
- To: commits-list gnome org
- Cc:
- Subject: [beast: 4/17] DOCS: build and install beast.1.html from beast.1.md
- Date: Thu, 23 Mar 2017 16:22:00 +0000 (UTC)
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>
[
Date Prev][
Date Next] [
Thread Prev][
Thread Next]
[
Thread Index]
[
Date Index]
[
Author Index]