Output the HTML documentation truly in the fashion of manual pages

This commit is contained in:
Pierre Pronchery 2014-07-10 22:46:46 +02:00
parent 71c9544234
commit 3b5bf30add
6 changed files with 55 additions and 5 deletions

View File

@ -28,8 +28,11 @@ dist:
$(PACKAGE)-$(VERSION)/doc/docbook.sh \
$(PACKAGE)-$(VERSION)/doc/index.xml \
$(PACKAGE)-$(VERSION)/doc/index.xsl \
$(PACKAGE)-$(VERSION)/doc/locker.css.xml \
$(PACKAGE)-$(VERSION)/doc/locker.xml \
$(PACKAGE)-$(VERSION)/doc/lockerctl.css.xml \
$(PACKAGE)-$(VERSION)/doc/lockerctl.xml \
$(PACKAGE)-$(VERSION)/doc/manual.css.xml \
$(PACKAGE)-$(VERSION)/doc/project.conf \
$(PACKAGE)-$(VERSION)/include/Locker.h \
$(PACKAGE)-$(VERSION)/include/Makefile \

View File

@ -15,13 +15,13 @@ index.html: index.xml index.xsl locker.xml lockerctl.xml
locker.1: locker.xml
./docbook.sh -P "$(PREFIX)" -- "locker.1"
locker.html: locker.xml
locker.html: locker.css.xml locker.xml manual.css.xml
./docbook.sh -P "$(PREFIX)" -- "locker.html"
lockerctl.1: lockerctl.xml
./docbook.sh -P "$(PREFIX)" -- "lockerctl.1"
lockerctl.html: lockerctl.xml
lockerctl.html: lockerctl.css.xml lockerctl.xml manual.css.xml
./docbook.sh -P "$(PREFIX)" -- "lockerctl.html"
clean:

7
doc/locker.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/lockerctl.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,5 +1,5 @@
targets=index.html,locker.1,locker.html,lockerctl.1,lockerctl.html
dist=Makefile,docbook.sh,index.xml,index.xsl,locker.xml,lockerctl.xml
dist=Makefile,docbook.sh,index.xml,index.xsl,locker.css.xml,locker.xml,lockerctl.css.xml,lockerctl.xml,manual.css.xml
[index.html]
type=script
@ -16,7 +16,7 @@ depends=locker.xml
type=script
script=./docbook.sh
install=
depends=locker.xml
depends=locker.css.xml,locker.xml,manual.css.xml
[lockerctl.1]
type=script
@ -28,4 +28,4 @@ depends=lockerctl.xml
type=script
script=./docbook.sh
install=
depends=lockerctl.xml
depends=lockerctl.css.xml,lockerctl.xml,manual.css.xml