From d1e0acddcc613a6fd8492e2c9b3d9fec837d4a7c Mon Sep 17 00:00:00 2001 From: Jirka Kosek Date: Thu, 1 May 2003 22:04:44 +0000 Subject: [PATCH] Added skeleton for PI documentation --- xsl/doc/Makefile | 2 +- xsl/doc/pi/Makefile | 17 +++++ xsl/docsrc/Makefile | 2 +- xsl/docsrc/pi/Makefile | 16 +++++ xsl/docsrc/pi/pi.xml | 140 ++++++++++++++++++++++++++++++++++++++ xsl/docsrc/pirefentry.xsl | 15 ++++ 6 files changed, 190 insertions(+), 2 deletions(-) create mode 100644 xsl/doc/pi/Makefile create mode 100644 xsl/docsrc/pi/Makefile create mode 100644 xsl/docsrc/pi/pi.xml create mode 100644 xsl/docsrc/pirefentry.xsl diff --git a/xsl/doc/Makefile b/xsl/doc/Makefile index 0e3bdc293..81597ca13 100644 --- a/xsl/doc/Makefile +++ b/xsl/doc/Makefile @@ -9,7 +9,7 @@ CRSTYLE=creference.xsl BSTYLE=book.xsl VPATH=../docsrc -DIRS=common lib html fo tools template +DIRS=common lib html fo tools template pi all: copyright.html warranty.html reference.html index.html for i in $(DIRS) __bogus__; do \ diff --git a/xsl/doc/pi/Makefile b/xsl/doc/pi/Makefile new file mode 100644 index 000000000..7726fcb0d --- /dev/null +++ b/xsl/doc/pi/Makefile @@ -0,0 +1,17 @@ +include ../../../cvstools/Makefile.incl + +STYLE=../jrefhtml.xsl +VPATH=../../docsrc/pi + +HTMLFILES = pi.html + +all: $(HTMLFILES) + +%.html : %.xml $(STYLE) + $(XSLT) $< $(STYLE) $@ + +pi.html: pi.xml + $(XSLT) $< ../../docsrc/pirefentry.xsl + +clean: + rm -f *.html diff --git a/xsl/docsrc/Makefile b/xsl/docsrc/Makefile index b4e7e3f6d..6e5a41020 100644 --- a/xsl/docsrc/Makefile +++ b/xsl/docsrc/Makefile @@ -1,4 +1,4 @@ -DIRS=common html fo template tools +DIRS=common html fo template tools pi all: xsl-params.xsl for i in $(DIRS) __bogus__; do \ diff --git a/xsl/docsrc/pi/Makefile b/xsl/docsrc/pi/Makefile new file mode 100644 index 000000000..a2d258030 --- /dev/null +++ b/xsl/docsrc/pi/Makefile @@ -0,0 +1,16 @@ +XSLT=../../../cvstools/saxon +XJPARSE=../../../cvstools/xjparse + +JSTYLE=../../docsrc/xsl2jref.xsl +VPATH=../../pi + +XMLFILES = pi.xml + +all: $(XMLFILES) + +clean: + -echo nop + +%.xml : %.xsl $(JSTYLE) ../../docsrc/legalnotice.xml + $(XSLT) $< $(JSTYLE) /dev/null output-file=$@ + $(XJPARSE) $@ diff --git a/xsl/docsrc/pi/pi.xml b/xsl/docsrc/pi/pi.xml new file mode 100644 index 000000000..2bfe53fef --- /dev/null +++ b/xsl/docsrc/pi/pi.xml @@ -0,0 +1,140 @@ + + +]> + + +Processing Instruction Reference + +$Id$ + + + Kosek + Jiří + + + 2003 + Jiří Kosek + + + + +Introduction + +This is technical reference documentation for the DocBook XSL +Stylesheets. It documents processing instructions (PIs) recognized by +the stylesheets. + +These PIs can be usually used to change behaviour of stylesheets +in a particular place. If you want to change some setting globally it +is better to do it via setting appropriate stylesheet +parameter if there is such one. + + + + +HTML PIs + + +Following PIs are processed only if you are generating HTML +output. This means that you are using HTML, XHTML, HTML Help or +JavaHelp output format. + +Name of this PI is dbhtml and its behaviour +is controlled with following attributes. + + + + +<?dbhtml filename="..."?> +string + + +filename +Filename for chunk + + + +Description + +Sets the name for chunked file. PI must be child of element +which goes into chunk (e.g. chapter, section). You can also set directory for chunk. + +Another way to control filename of chunk is enabling use.id.as.filename parameter. + + + + +Example + + +Configuring pencil + + +... + +]]> + + + + + + + +<?dbhtml dir="..."?> +string + + +dir +Directory for chunk + + + +Description + +Sets the directory for chunked file. PI must be child of element +which goes into chunk (e.g. chapter, section). Resulting directory is +inherited from ancestor elements if they also contain this PI. You can +also set filename for +chunk. + +PI can specify both filename and directory at the same time. + + + + +Example + + +Configuring pencil + + +... + +]]> + + + + + + + + +Common PIs + + +Following PIs are recognized in all output formats. + + + + + + + + + + + \ No newline at end of file diff --git a/xsl/docsrc/pirefentry.xsl b/xsl/docsrc/pirefentry.xsl new file mode 100644 index 000000000..1a57a5943 --- /dev/null +++ b/xsl/docsrc/pirefentry.xsl @@ -0,0 +1,15 @@ + + + + + + + + + + + + + + \ No newline at end of file -- 2.40.0