Output the HTML documentation truly in the fashion of manual pages

This commit is contained in:
Pierre Pronchery 2014-07-10 22:38:10 +02:00
parent bee3d8028d
commit 1827ff60bd
6 changed files with 55 additions and 5 deletions

View File

@ -49,10 +49,13 @@ dist:
$(PACKAGE)-$(VERSION)/data/48x48/mailer-sent.png \
$(PACKAGE)-$(VERSION)/data/48x48/project.conf \
$(PACKAGE)-$(VERSION)/doc/Makefile \
$(PACKAGE)-$(VERSION)/doc/compose.css.xml \
$(PACKAGE)-$(VERSION)/doc/compose.xml \
$(PACKAGE)-$(VERSION)/doc/docbook.sh \
$(PACKAGE)-$(VERSION)/doc/gtkdoc.sh \
$(PACKAGE)-$(VERSION)/doc/mailer.css.xml \
$(PACKAGE)-$(VERSION)/doc/mailer.xml \
$(PACKAGE)-$(VERSION)/doc/manual.css.xml \
$(PACKAGE)-$(VERSION)/doc/project.conf \
$(PACKAGE)-$(VERSION)/doc/gtkdoc/Makefile \
$(PACKAGE)-$(VERSION)/doc/gtkdoc/Mailer-docs.xml \

View File

@ -16,7 +16,7 @@ subdirs:
compose.1: compose.xml
./docbook.sh -P "$(PREFIX)" -- "compose.1"
compose.html: compose.xml
compose.html: compose.css.xml compose.xml manual.css.xml
./docbook.sh -P "$(PREFIX)" -- "compose.html"
gtkdoc/Mailer.types: ../config.sh
@ -34,7 +34,7 @@ gtkdoc/html.stamp: gtkdoc/Mailer-docs.xml gtkdoc/sgml.stamp
mailer.1: mailer.xml
./docbook.sh -P "$(PREFIX)" -- "mailer.1"
mailer.html: mailer.xml
mailer.html: mailer.css.xml mailer.xml manual.css.xml
./docbook.sh -P "$(PREFIX)" -- "mailer.html"
clean:

7
doc/compose.css.xml Normal file
View File

@ -0,0 +1,7 @@
<?xml version="1.0"?>
<!-- $Id$ -->
<!DOCTYPE style [
<!ENTITY manual "manual.css.xml">
]>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="&manual;"/>
<!-- vim: set noet ts=1 sw=1 sts=1 tw=80: -->

7
doc/mailer.css.xml Normal file
View File

@ -0,0 +1,7 @@
<?xml version="1.0"?>
<!-- $Id$ -->
<!DOCTYPE style [
<!ENTITY manual "manual.css.xml">
]>
<xi:include xmlns:xi="http://www.w3.org/2001/XInclude" href="&manual;"/>
<!-- vim: set noet ts=1 sw=1 sts=1 tw=80: -->

33
doc/manual.css.xml Normal file
View File

@ -0,0 +1,33 @@
<?xml version="1.0"?>
<style><![CDATA[/* $Id$ */
div.refentry {
font-family: monospace;
margin-left: 5ex;
min-width: 102ex;
width: 102ex;
}
div.refentry h1, div.refentry h2, div.refentry h3 {
font-size: inherit;
margin-bottom: 0;
}
div.refentry h1, div.refentry h2 {
margin-left: -4ex;
text-transform: uppercase;
}
div.refentry h3 {
margin-left: -2ex;
}
div.refentry p {
margin-top: 0;
padding-top: 0;
}
div.refentry blockquote, div.refentry pre {
margin-left: 5ex;
}
]]></style>

View File

@ -1,6 +1,6 @@
subdirs=gtkdoc
targets=compose.1,compose.html,gtkdoc/Mailer.types,gtkdoc/tmpl.stamp,gtkdoc/sgml.stamp,gtkdoc/html.stamp,mailer.1,mailer.html
dist=Makefile,compose.xml,docbook.sh,gtkdoc.sh,mailer.xml
dist=Makefile,compose.css.xml,compose.xml,docbook.sh,gtkdoc.sh,mailer.css.xml,mailer.xml,manual.css.xml
[compose.1]
type=script
@ -11,7 +11,7 @@ install=
[compose.html]
type=script
script=./docbook.sh
depends=compose.xml
depends=compose.css.xml,compose.xml,manual.css.xml
install=
[gtkdoc/Mailer.types]
@ -44,5 +44,5 @@ install=
[mailer.html]
type=script
script=./docbook.sh
depends=mailer.xml
depends=mailer.css.xml,mailer.xml,manual.css.xml
install=