Output the HTML documentation truly in the fashion of manual pages

This commit is contained in:
Pierre Pronchery 2014-07-08 00:54:33 +02:00
parent 66140ee146
commit 0cb69ddc3b
10 changed files with 95 additions and 13 deletions

View File

@ -59,11 +59,18 @@ dist:
$(PACKAGE)-$(VERSION)/data/scalable/project.conf \
$(PACKAGE)-$(VERSION)/doc/Makefile \
$(PACKAGE)-$(VERSION)/doc/docbook.sh \
$(PACKAGE)-$(VERSION)/doc/manual.css.xml \
$(PACKAGE)-$(VERSION)/doc/panel.css.xml \
$(PACKAGE)-$(VERSION)/doc/panel.xml \
$(PACKAGE)-$(VERSION)/doc/panelctl.css.xml \
$(PACKAGE)-$(VERSION)/doc/panelctl.xml \
$(PACKAGE)-$(VERSION)/doc/panel-embed.css.xml \
$(PACKAGE)-$(VERSION)/doc/panel-embed.xml \
$(PACKAGE)-$(VERSION)/doc/panel-message.css.xml \
$(PACKAGE)-$(VERSION)/doc/panel-message.xml \
$(PACKAGE)-$(VERSION)/doc/panel-notify.css.xml \
$(PACKAGE)-$(VERSION)/doc/panel-notify.xml \
$(PACKAGE)-$(VERSION)/doc/wifibrowser.css.xml \
$(PACKAGE)-$(VERSION)/doc/wifibrowser.xml \
$(PACKAGE)-$(VERSION)/doc/project.conf \
$(PACKAGE)-$(VERSION)/include/Panel.h \

View File

@ -12,37 +12,37 @@ all: $(TARGETS)
panel.1: panel.xml
./docbook.sh -P "$(PREFIX)" -- "panel.1"
panel.html: panel.xml
panel.html: manual.css.xml panel.css.xml panel.xml
./docbook.sh -P "$(PREFIX)" -- "panel.html"
panelctl.1: panelctl.xml
./docbook.sh -P "$(PREFIX)" -- "panelctl.1"
panelctl.html: panelctl.xml
panelctl.html: manual.css.xml panelctl.css.xml panelctl.xml
./docbook.sh -P "$(PREFIX)" -- "panelctl.html"
panel-embed.1: panel-embed.xml
./docbook.sh -P "$(PREFIX)" -- "panel-embed.1"
panel-embed.html: panel-embed.xml
panel-embed.html: manual.css.xml panel-embed.css.xml panel-embed.xml
./docbook.sh -P "$(PREFIX)" -- "panel-embed.html"
panel-message.1: panel-message.xml
./docbook.sh -P "$(PREFIX)" -- "panel-message.1"
panel-message.html: panel-message.xml
panel-message.html: manual.css.xml panel-message.css.xml panel-message.xml
./docbook.sh -P "$(PREFIX)" -- "panel-message.html"
panel-notify.1: panel-notify.xml
./docbook.sh -P "$(PREFIX)" -- "panel-notify.1"
panel-notify.html: panel-notify.xml
panel-notify.html: manual.css.xml panel-notify.css.xml panel-notify.xml
./docbook.sh -P "$(PREFIX)" -- "panel-notify.html"
wifibrowser.1: wifibrowser.xml
./docbook.sh -P "$(PREFIX)" -- "wifibrowser.1"
wifibrowser.html: wifibrowser.xml
wifibrowser.html: manual.css.xml wifibrowser.css.xml wifibrowser.xml
./docbook.sh -P "$(PREFIX)" -- "wifibrowser.html"
clean:

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>

7
doc/panel-embed.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: -->

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/panel-notify.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/panel.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/panelctl.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: -->

View File

@ -1,5 +1,5 @@
targets=panel.1,panel.html,panelctl.1,panelctl.html,panel-embed.1,panel-embed.html,panel-message.1,panel-message.html,panel-notify.1,panel-notify.html,wifibrowser.1,wifibrowser.html
dist=Makefile,docbook.sh,panel.xml,panelctl.xml,panel-embed.xml,panel-message.xml,panel-notify.xml,wifibrowser.xml
dist=Makefile,docbook.sh,manual.css.xml,panel.css.xml,panel.xml,panelctl.css.xml,panelctl.xml,panel-embed.css.xml,panel-embed.xml,panel-message.css.xml,panel-message.xml,panel-notify.css.xml,panel-notify.xml,wifibrowser.css.xml,wifibrowser.xml
[panel.1]
type=script
@ -11,7 +11,7 @@ depends=panel.xml
type=script
script=./docbook.sh
install=
depends=panel.xml
depends=manual.css.xml,panel.css.xml,panel.xml
[panelctl.1]
type=script
@ -23,7 +23,7 @@ depends=panelctl.xml
type=script
script=./docbook.sh
install=
depends=panelctl.xml
depends=manual.css.xml,panelctl.css.xml,panelctl.xml
[panel-embed.1]
type=script
@ -35,7 +35,7 @@ depends=panel-embed.xml
type=script
script=./docbook.sh
install=
depends=panel-embed.xml
depends=manual.css.xml,panel-embed.css.xml,panel-embed.xml
[panel-message.1]
type=script
@ -47,7 +47,7 @@ depends=panel-message.xml
type=script
script=./docbook.sh
install=
depends=panel-message.xml
depends=manual.css.xml,panel-message.css.xml,panel-message.xml
[panel-notify.1]
type=script
@ -59,7 +59,7 @@ depends=panel-notify.xml
type=script
script=./docbook.sh
install=
depends=panel-notify.xml
depends=manual.css.xml,panel-notify.css.xml,panel-notify.xml
[wifibrowser.1]
type=script
@ -71,4 +71,4 @@ depends=wifibrowser.xml
type=script
script=./docbook.sh
install=
depends=wifibrowser.xml
depends=manual.css.xml,wifibrowser.css.xml,wifibrowser.xml

7
doc/wifibrowser.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: -->