Collapse AllExpand All

12.1. The "Parameter Set Chooser" dialog box

The "Change Document Conversion Parameters" dialog box has a Parameter Set menu which allows to load and save named parameter sets. A parameter set is the set of all the XSL style sheets parameters specified by a user using the "Change Document Conversion Parameters" dialog box. This facility is almost indispensable to deal with the DocBook profiling XSL style sheets. Using such style sheets requires the user to quickly switch from one parameter set (e.g. containing profile.condition=newbie) to another (e.g. containing profile.condition=expert).

Figure 9.9. The "Parameter Set Chooser" dialog box

The "Parameter Set Chooser" dialog box

Reset

Removes all the parameters currently specified by the user in the "Change Document Conversion Parameters" dialog box. The effect of Reset is thus to restore the stock configuration by removing all the user's customizations.

Example: parameter paper.type=USLetter is specified in both the docb.toPS.transformParameters and docb.toRTF.transformParameters groups. Selecting Reset from the Parameter Set menu means removing these two occurrences of the paper.type parameter.

Load

Displays the "Parameter Set Chooser" dialog box to let the user specify an existing parameter set. The contents of this parameter set is then used to overwrite all the parameters currently specified by the user in the "Change Document Conversion Parameters" dialog box.

Example: the user loads a parameter set called "USLetter" containing just paper.type=USLetter in both the docb.toPS.transformParameters and docb.toRTF.transformParameters groups. Selecting Load from the Parameter Set menu means removing all the currently specified parameters from all the parameter groups and then adding paper.type=USLetter to both the docb.toPS.transformParameters and docb.toRTF.transformParameters groups.

Save

Displays the "Parameter Set Chooser" dialog box to let the user specify the name of a parameter set. The integral contents of the "Change Document Conversion Parameters" dialog box at the save time is then copied to this parameter set.