From: chas williams - CONTRACTOR Date: Wed, 8 Jun 2011 14:44:21 +0000 (-0400) Subject: doc: epub and mobi support X-Git-Tag: upstream/1.8.0_pre1^2~3589 X-Git-Url: https://git.michaelhowe.org/gitweb/?a=commitdiff_plain;h=9929d1c6fcd63a2a1d250cc36f4858b0fbba02af;p=packages%2Fo%2Fopenafs.git doc: epub and mobi support .epub is generated using dbtoepub which is still considered alpha software apparently and installed in a non-standard place. for now, use the docbook stylesheet location to find it. .mobi is generated using kindlegen from the .epub in order to have a real toc. there is some preprocessing with a custom stylesheet to make things "look right". see mobi-fixup.xsl.in Change-Id: Ice92e701e2f921e70c0f98683b5e9ab44a347e3b Reviewed-on: http://gerrit.openafs.org/4887 Tested-by: BuildBot Reviewed-by: Derrick Brashear --- diff --git a/configure.ac b/configure.ac index 0aa3dba5f..764165ea6 100644 --- a/configure.ac +++ b/configure.ac @@ -105,6 +105,11 @@ if test -f 'doc/xml/UserGuide/Makefile.in' ; then else USERGUIDE_MAKEFILE= fi +if test -f 'doc/xml/mobi-fixup.xsl.in' ; then + MOBI_FIXUP_XSL="doc/xml/mobi-fixup.xsl" +else + MOBI_FIXUP_XSL= +fi AC_OUTPUT( \ Makefile \ @@ -112,6 +117,7 @@ ${MAN_MAKEFILE} \ ${ADMINGUIDE_MAKEFILE} \ ${QSUNIX_MAKEFILE} \ ${USERGUIDE_MAKEFILE} \ +${MOBI_FIXUP_XSL} \ src/afs/Makefile \ src/afsd/Makefile \ src/afsmonitor/Makefile \ diff --git a/doc/xml/AdminGuide/Makefile.in b/doc/xml/AdminGuide/Makefile.in index cbbba59a9..33d0dc86b 100644 --- a/doc/xml/AdminGuide/Makefile.in +++ b/doc/xml/AdminGuide/Makefile.in @@ -15,7 +15,7 @@ BOOK = auagd000 -all: $(BOOK).pdf index.html +all: $(BOOK).pdf index.html $(BOOK).epub $(BOOK).mobi include @TOP_OBJDIR@/src/config/Makefile.config VERSION=version @@ -30,6 +30,7 @@ HTML_XSL = @HTML_XSL@ DOCBOOK_STYLESHEETS = @DOCBOOK_STYLESHEETS@ XSLTPROC = @XSLTPROC@ DOCBOOK2PDF = @DOCBOOK2PDF@ +DBTOEPUB = $(DOCBOOK_STYLESHEETS)/epub/bin/dbtoepub index.html: $(SRCS) $(XSLTPROC) --param navig.graphics 1 \ @@ -43,6 +44,14 @@ $(BOOK).pdf: $(SRCS) $(DOCBOOK2PDF) $(BOOK).xml; \ fi +$(BOOK).epub: $(SRCS) + if test -x "$(DBTOEPUB)" ; then \ + $(DBTOEPUB) -s $(TOP_SRCDIR)/../doc/xml/mobi-fixup.xsl $(BOOK).xml; \ + fi + +$(BOOK).mobi: $(BOOK).epub + kindlegen $(BOOK).epub -o $(BOOK).mobi + check: xmllint --noout --valid $(BOOK).xml diff --git a/doc/xml/AdminGuide/auagd000.png b/doc/xml/AdminGuide/auagd000.png new file mode 100644 index 000000000..344ab25e3 Binary files /dev/null and b/doc/xml/AdminGuide/auagd000.png differ diff --git a/doc/xml/AdminGuide/auagd000.xml b/doc/xml/AdminGuide/auagd000.xml index 92c1441e2..5946bb0c6 100644 --- a/doc/xml/AdminGuide/auagd000.xml +++ b/doc/xml/AdminGuide/auagd000.xml @@ -28,6 +28,12 @@ OpenAFS Administration Guide + + + + + + 2000 diff --git a/doc/xml/QuickStartUnix/Makefile.in b/doc/xml/QuickStartUnix/Makefile.in index 229e2642c..73516453f 100644 --- a/doc/xml/QuickStartUnix/Makefile.in +++ b/doc/xml/QuickStartUnix/Makefile.in @@ -15,7 +15,7 @@ BOOK = auqbg000 -all: $(BOOK).pdf index.html +all: $(BOOK).pdf index.html $(BOOK).epub $(BOOK).mobi include @TOP_OBJDIR@/src/config/Makefile.config VERSION=version @@ -28,6 +28,7 @@ HTML_XSL = @HTML_XSL@ DOCBOOK_STYLESHEETS = @DOCBOOK_STYLESHEETS@ XSLTPROC = @XSLTPROC@ DOCBOOK2PDF = @DOCBOOK2PDF@ +DBTOEPUB = $(DOCBOOK_STYLESHEETS)/epub/bin/dbtoepub index.html: $(SRCS) $(XSLTPROC) --param navig.graphics 1 \ @@ -41,6 +42,14 @@ $(BOOK).pdf: $(SRCS) $(DOCBOOK2PDF) $(BOOK).xml; \ fi +$(BOOK).epub: $(SRCS) + if test -x "$(DBTOEPUB)" ; then \ + $(DBTOEPUB) -s $(TOP_SRCDIR)/../doc/xml/mobi-fixup.xsl $(BOOK).xml; \ + fi + +$(BOOK).mobi: $(BOOK).epub + kindlegen $(BOOK).epub -o $(BOOK).mobi + check: xmllint --noout --valid $(BOOK).xml diff --git a/doc/xml/QuickStartUnix/auqbg000.png b/doc/xml/QuickStartUnix/auqbg000.png new file mode 100644 index 000000000..941cd3e2c Binary files /dev/null and b/doc/xml/QuickStartUnix/auqbg000.png differ diff --git a/doc/xml/QuickStartUnix/auqbg000.xml b/doc/xml/QuickStartUnix/auqbg000.xml index a7993c22b..13b376ed3 100644 --- a/doc/xml/QuickStartUnix/auqbg000.xml +++ b/doc/xml/QuickStartUnix/auqbg000.xml @@ -16,6 +16,12 @@ OpenAFS Quick Start Guide for UNIX + + + + + + 2000-2009 IBM Corporation and other contributors. All Rights Reserved diff --git a/doc/xml/UserGuide/Makefile.in b/doc/xml/UserGuide/Makefile.in index 725959c98..4757ccd92 100644 --- a/doc/xml/UserGuide/Makefile.in +++ b/doc/xml/UserGuide/Makefile.in @@ -15,7 +15,7 @@ BOOK = auusg000 -all: $(BOOK).pdf index.html +all: $(BOOK).pdf index.html $(BOOK).epub $(BOOK).mobi include @TOP_OBJDIR@/src/config/Makefile.config VERSION=version @@ -41,6 +41,14 @@ $(BOOK).pdf: $(SRCS) $(DOCBOOK2PDF) $(BOOK).xml; \ fi +$(BOOK).epub: $(SRCS) + if test -x "$(DBTOEPUB)" ; then \ + $(DBTOEPUB) -s $(TOP_SRCDIR)/../doc/xml/mobi-fixup.xsl $(BOOK).xml; \ + fi + +$(BOOK).mobi: $(BOOK).epub + kindlegen $(BOOK).epub -o $(BOOK).mobi + check: xmllint --noout --valid $(BOOK).xml diff --git a/doc/xml/UserGuide/auusg000.png b/doc/xml/UserGuide/auusg000.png new file mode 100644 index 000000000..c9b17cc71 Binary files /dev/null and b/doc/xml/UserGuide/auusg000.png differ diff --git a/doc/xml/UserGuide/auusg000.xml b/doc/xml/UserGuide/auusg000.xml index cbd0fd822..ffb965045 100644 --- a/doc/xml/UserGuide/auusg000.xml +++ b/doc/xml/UserGuide/auusg000.xml @@ -18,6 +18,12 @@ OpenAFS User Guide + + + + + + 2000 diff --git a/doc/xml/mobi-fixup.xsl.in b/doc/xml/mobi-fixup.xsl.in new file mode 100644 index 000000000..8e3352148 --- /dev/null +++ b/doc/xml/mobi-fixup.xsl.in @@ -0,0 +1,36 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +