Output the HTML documentation truly in the fashion of manual pages

This commit is contained in:
Pierre Pronchery 2014-06-06 01:16:03 +02:00
parent eb3aa73d21
commit 3c7aef553c
13 changed files with 126 additions and 20 deletions

View File

@ -33,16 +33,26 @@ dist:
$(PACKAGE)-$(VERSION)/data/16x16/browser-view-list.png \
$(PACKAGE)-$(VERSION)/data/16x16/project.conf \
$(PACKAGE)-$(VERSION)/doc/Makefile \
$(PACKAGE)-$(VERSION)/doc/docbook.sh \
$(PACKAGE)-$(VERSION)/doc/browser.css.xml \
$(PACKAGE)-$(VERSION)/doc/browser.xml \
$(PACKAGE)-$(VERSION)/doc/copy.css.xml \
$(PACKAGE)-$(VERSION)/doc/copy.xml \
$(PACKAGE)-$(VERSION)/doc/delete.css.xml \
$(PACKAGE)-$(VERSION)/doc/delete.xml \
$(PACKAGE)-$(VERSION)/doc/desktop.css.xml \
$(PACKAGE)-$(VERSION)/doc/desktop.xml \
$(PACKAGE)-$(VERSION)/doc/desktopctl.css.xml \
$(PACKAGE)-$(VERSION)/doc/desktopctl.xml \
$(PACKAGE)-$(VERSION)/doc/docbook.sh \
$(PACKAGE)-$(VERSION)/doc/manual.css.xml \
$(PACKAGE)-$(VERSION)/doc/mime.conf \
$(PACKAGE)-$(VERSION)/doc/move.css.xml \
$(PACKAGE)-$(VERSION)/doc/move.xml \
$(PACKAGE)-$(VERSION)/doc/open.css.xml \
$(PACKAGE)-$(VERSION)/doc/open.xml \
$(PACKAGE)-$(VERSION)/doc/properties.css.xml \
$(PACKAGE)-$(VERSION)/doc/properties.xml \
$(PACKAGE)-$(VERSION)/doc/view.css.xml \
$(PACKAGE)-$(VERSION)/doc/view.xml \
$(PACKAGE)-$(VERSION)/doc/project.conf \
$(PACKAGE)-$(VERSION)/include/Browser.h \

View File

@ -12,55 +12,55 @@ all: $(TARGETS)
browser.1: browser.xml
./docbook.sh -P "$(PREFIX)" -- "browser.1"
browser.html: browser.xml
browser.html: browser.css.xml browser.xml manual.css.xml
./docbook.sh -P "$(PREFIX)" -- "browser.html"
copy.1: copy.xml
./docbook.sh -P "$(PREFIX)" -- "copy.1"
copy.html: copy.xml
copy.html: copy.css.xml copy.xml manual.css.xml
./docbook.sh -P "$(PREFIX)" -- "copy.html"
delete.1: delete.xml
./docbook.sh -P "$(PREFIX)" -- "delete.1"
delete.html: delete.xml
delete.html: delete.css.xml delete.xml manual.css.xml
./docbook.sh -P "$(PREFIX)" -- "delete.html"
desktop.1: desktop.xml
./docbook.sh -P "$(PREFIX)" -- "desktop.1"
desktop.html: desktop.xml
desktop.html: desktop.css.xml desktop.xml manual.css.xml
./docbook.sh -P "$(PREFIX)" -- "desktop.html"
desktopctl.1: desktopctl.xml
./docbook.sh -P "$(PREFIX)" -- "desktopctl.1"
desktopctl.html: desktopctl.xml
desktopctl.html: desktopctl.css.xml desktopctl.xml manual.css.xml
./docbook.sh -P "$(PREFIX)" -- "desktopctl.html"
move.1: move.xml
./docbook.sh -P "$(PREFIX)" -- "move.1"
move.html: move.xml
move.html: manual.css.xml move.css.xml move.xml
./docbook.sh -P "$(PREFIX)" -- "move.html"
open.1: open.xml
./docbook.sh -P "$(PREFIX)" -- "open.1"
open.html: open.xml
open.html: manual.css.xml open.css.xml open.xml
./docbook.sh -P "$(PREFIX)" -- "open.html"
properties.1: properties.xml
./docbook.sh -P "$(PREFIX)" -- "properties.1"
properties.html: properties.xml
properties.html: manual.css.xml properties.css.xml properties.xml
./docbook.sh -P "$(PREFIX)" -- "properties.html"
view.1: view.xml
./docbook.sh -P "$(PREFIX)" -- "view.1"
view.html: view.xml
view.html: manual.css.xml view.css.xml view.xml
./docbook.sh -P "$(PREFIX)" -- "view.html"
clean:

7
doc/browser.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/copy.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/delete.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/desktop.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/desktopctl.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>

7
doc/move.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/open.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=browser.1,browser.html,copy.1,copy.html,delete.1,delete.html,desktop.1,desktop.html,desktopctl.1,desktopctl.html,move.1,move.html,open.1,open.html,properties.1,properties.html,view.1,view.html
dist=Makefile,docbook.sh,browser.xml,copy.xml,delete.xml,desktop.xml,desktopctl.xml,mime.conf,move.xml,open.xml,properties.xml,view.xml
dist=Makefile,browser.css.xml,browser.xml,copy.css.xml,copy.xml,delete.css.xml,delete.xml,desktop.css.xml,desktop.xml,desktopctl.css.xml,desktopctl.xml,docbook.sh,manual.css.xml,mime.conf,move.css.xml,move.xml,open.css.xml,open.xml,properties.css.xml,properties.xml,view.css.xml,view.xml
[browser.1]
type=script
@ -11,7 +11,7 @@ depends=browser.xml
type=script
script=./docbook.sh
install=
depends=browser.xml
depends=browser.css.xml,browser.xml,manual.css.xml
[copy.1]
type=script
@ -23,7 +23,7 @@ depends=copy.xml
type=script
script=./docbook.sh
install=
depends=copy.xml
depends=copy.css.xml,copy.xml,manual.css.xml
[delete.1]
type=script
@ -35,7 +35,7 @@ depends=delete.xml
type=script
script=./docbook.sh
install=
depends=delete.xml
depends=delete.css.xml,delete.xml,manual.css.xml
[desktop.1]
type=script
@ -47,7 +47,7 @@ depends=desktop.xml
type=script
script=./docbook.sh
install=
depends=desktop.xml
depends=desktop.css.xml,desktop.xml,manual.css.xml
[desktopctl.1]
type=script
@ -59,7 +59,7 @@ depends=desktopctl.xml
type=script
script=./docbook.sh
install=
depends=desktopctl.xml
depends=desktopctl.css.xml,desktopctl.xml,manual.css.xml
[move.1]
type=script
@ -71,7 +71,7 @@ depends=move.xml
type=script
script=./docbook.sh
install=
depends=move.xml
depends=manual.css.xml,move.css.xml,move.xml
[open.1]
type=script
@ -83,7 +83,7 @@ depends=open.xml
type=script
script=./docbook.sh
install=
depends=open.xml
depends=manual.css.xml,open.css.xml,open.xml
[properties.1]
type=script
@ -95,7 +95,7 @@ depends=properties.xml
type=script
script=./docbook.sh
install=
depends=properties.xml
depends=manual.css.xml,properties.css.xml,properties.xml
[view.1]
type=script
@ -107,4 +107,4 @@ depends=view.xml
type=script
script=./docbook.sh
install=
depends=view.xml
depends=manual.css.xml,view.css.xml,view.xml

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