# Processing Instruction Reference

$Id: pi.xml,v 1.1 2003/06/09 18:40:47 blackburst Exp $
Kosek
Ji&rcaron;í
2003
Ji&rcaron;í 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

    <section>
    <title>Configuring pencil</title>
    <?dbhtml filename="configuration.html"?>

    ...

    </section>

<?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

    <section>
    <title>Configuring pencil</title>
    <?dbhtml dir="config" filename="pencil.html"?>

    ...

    </section>

## Common PIs

Following PIs are recognized in all output formats.

##