# Actions

The document processing tools are set up as launch configurations of the category External Tools. Therefore all common actions for External Tools can be used to edit and launch the configurations.

In addition, there are the following context sensitive ways to access and run the document processing tools for a document.

## Actions for document in active editor

If a document editor is active, the document processing configurations suitable for the content type of the editor are also accessible via the main menu Document and the main toolbar. It is also possible to run the currently active tool by commands and their keyboard shortcuts.

When using these actions, the source document is always the document in the active editor, even if another view in the window has the focus.

### Menu

The Document menu offers a sub menu for each configured document processing tool with:

- Run Tool and Process Document runs the tool, that is all steps enabled in the tool configuration inclusive or exclusive the Preview step.

- Actions to run a single step of the tool, e.g. Weave R chunks, Produce Output and Preview Output.

- Set as Active Tool makes the tool configuration explicitly to the active configuration for the current document content type. The active tool is used by the toolbar items and commands described below.

- Edit configuration... opens the configuration dialog for the tool.

### Toolbar

The main toolbar provides access to the commands 'Process Document', 'Preview Output' and their combination 'Process Document and Preview Output' (see below).

The drop-down option offers the possibility to process the document using an other tool than the currently active. Furthermore the selected tool configuration becomes the new active configuration for the current document content type.

### Commands

| Name | Description | Availability
--- | --- | --- | ---
This commands use always the currently active tool configuration.
| Process Document and Preview Output | Runs the tool, that is all steps enabled in the tool configuration | Main toolbar Global command `Ctrl+T, 0`
| Process Document | Runs all processing steps of the tool, that is all steps enabled in the tool configuration except the Preview step | Main toolbar Global command `Ctrl+T, 9`
| Run Preprocessing/Weave | Runs the Preprocessing/Weave step, e.g. weaves the R chunks in Sweave documents | Global command `Ctrl+T, 2`
| Produce Output | Runs the Produce Output step, e.g. compiles the LaTeX sources to final PDF file | Global command `Ctrl+T, 3`
| Preview Output | Opens preview for the produced output | Main toolbar Global command `Ctrl+T, 4`

## Actions for selected document file

Also all common actions for External Tools use the currently selected file as source document.

### Context menu

If a supported document file is selected in the Project Explorer or another view, the context menu provides a sub menu Document which offers direct access to the configured document processing tools suitable for the content type of the file. It provides the same actions as the Document menu described above, except that the source document is the selected file.