DeforaOS/Surfer
DeforaOS/Surfer
2
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Output the HTML documentation truly in the fashion of manual pages

Browse Source
This commit is contained in:
Pierre Pronchery 2014-07-08 01:12:34 +02:00
parent 711c37c205
commit d91f5e6801
7 changed files with 65 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
Makefile
View File

@ -33,8 +33,12 @@ dist:
$(PACKAGE)-$(VERSION)/data/24x24/project.conf \ $(PACKAGE)-$(VERSION)/data/24x24/project.conf \
$(PACKAGE)-$(VERSION)/doc/Makefile \ $(PACKAGE)-$(VERSION)/doc/Makefile \
$(PACKAGE)-$(VERSION)/doc/docbook.sh \ $(PACKAGE)-$(VERSION)/doc/docbook.sh \
$(PACKAGE)-$(VERSION)/doc/download.css.xml \
$(PACKAGE)-$(VERSION)/doc/download.xml \ $(PACKAGE)-$(VERSION)/doc/download.xml \
$(PACKAGE)-$(VERSION)/doc/helper.css.xml \
$(PACKAGE)-$(VERSION)/doc/helper.xml \ $(PACKAGE)-$(VERSION)/doc/helper.xml \
$(PACKAGE)-$(VERSION)/doc/manual.css.xml \
$(PACKAGE)-$(VERSION)/doc/surfer.css.xml \
$(PACKAGE)-$(VERSION)/doc/surfer.xml \ $(PACKAGE)-$(VERSION)/doc/surfer.xml \
$(PACKAGE)-$(VERSION)/doc/project.conf \ $(PACKAGE)-$(VERSION)/doc/project.conf \
$(PACKAGE)-$(VERSION)/po/Makefile \ $(PACKAGE)-$(VERSION)/po/Makefile \

6
doc/Makefile
View File

@ -12,19 +12,19 @@ all: $(TARGETS)
download.1: download.xml download.1: download.xml
./docbook.sh -P "$(PREFIX)" -- "download.1" ./docbook.sh -P "$(PREFIX)" -- "download.1"
download.html: download.xml download.html: download.css.xml download.xml manual.css.xml
./docbook.sh -P "$(PREFIX)" -- "download.html" ./docbook.sh -P "$(PREFIX)" -- "download.html"
helper.1: helper.xml helper.1: helper.xml
./docbook.sh -P "$(PREFIX)" -- "helper.1" ./docbook.sh -P "$(PREFIX)" -- "helper.1"
helper.html: helper.xml helper.html: helper.css.xml helper.xml manual.css.xml
./docbook.sh -P "$(PREFIX)" -- "helper.html" ./docbook.sh -P "$(PREFIX)" -- "helper.html"
surfer.1: surfer.xml surfer.1: surfer.xml
./docbook.sh -P "$(PREFIX)" -- "surfer.1" ./docbook.sh -P "$(PREFIX)" -- "surfer.1"
surfer.html: surfer.xml surfer.html: manual.css.xml surfer.css.xml surfer.xml
./docbook.sh -P "$(PREFIX)" -- "surfer.html" ./docbook.sh -P "$(PREFIX)" -- "surfer.html"
clean: clean:

7
doc/download.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/helper.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>

8
doc/project.conf
View File

@ -1,5 +1,5 @@
targets=download.1,download.html,helper.1,helper.html,surfer.1,surfer.html targets=download.1,download.html,helper.1,helper.html,surfer.1,surfer.html
dist=Makefile,docbook.sh,download.xml,helper.xml,surfer.xml dist=Makefile,docbook.sh,download.css.xml,download.xml,helper.css.xml,helper.xml,manual.css.xml,surfer.css.xml,surfer.xml
[download.1] [download.1]
type=script type=script
@ -11,7 +11,7 @@ depends=download.xml
type=script type=script
script=./docbook.sh script=./docbook.sh
install= install=
depends=download.xml depends=download.css.xml,download.xml,manual.css.xml
[helper.1] [helper.1]
type=script type=script
@ -23,7 +23,7 @@ depends=helper.xml
type=script type=script
script=./docbook.sh script=./docbook.sh
install= install=
depends=helper.xml depends=helper.css.xml,helper.xml,manual.css.xml
[surfer.1] [surfer.1]
type=script type=script
@ -35,4 +35,4 @@ depends=surfer.xml
type=script type=script
script=./docbook.sh script=./docbook.sh
install= install=
depends=surfer.xml depends=manual.css.xml,surfer.css.xml,surfer.xml

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