# Configure &kappname;

## General Configuration

In order to configure &ktikz; the user needs to access the &ktikz; Configuration dialog. This can be accessed via the menu bar, by selecting Settings Configure &ktikz;....

The &ktikz; Configuration dialog consists of three sections; General, Editor and Highlighting. Clicking one of these sections in the vertical list on the left side of the dialog will make those options available accordingly. The options available are displayed to the right of the dialog.

By means of buttons along the bottom of the box the user can control the configuration process. You may invoke the Help system, accept the current settings and close the dialog by means of the OK button, or Cancel the process.

The categories General, Editor and Highlighting are detailed in the following sections.

- General

- Editor

- Highlighting

## General

This section of the dialog lets you configure the interface and set the paths to the necessary executables and the documentation.

&ktikz; configuration dialog - General &ktikz; Configuration Window Showing The General Options

Interface
  Show TikZ commands in dock instead of menu

    If this option is checked, a dock widget is available with a list of TikZ commands which you can insert in your code by clicking on them. If this option is not checked, the TikZ commands will be available in a menu instead. You have to restart &ktikz; for this change to take effect.

Preview
  Preview generation

    Specify whether the preview should be generated automatically or manually.

    Automatically

      If this option is checked, the TikZ code in the editor is compiled while editing.

    Manually

      If this option is checked, a Build button is available and the TikZ code is only compiled when you press that button.

  Show mouse coordinates

    If this option is checked, the coordinates of the mouse cursor in the preview are shown.

    Use best precision

      If this option is checked, the mouse coordinates are shown with enough precision but without redundant decimals.

    Specify precision

      If this option is checked, the mouse coordinates are shown with the specified number of decimals.

Commands
  PDFLaTeX command

    Enter the path of the PDFLaTeX executable here. This executable is used to typeset a LaTeX file containing the TikZ code in order to generate the preview.

  Pdftops command

    Enter the path to the pdftops executable (part of poppler) here. This executable is used to export the image to EPS (Encapsulated PostScript).

Templates
  Replace text

    Enter the text which will be replaced by the TikZ code in the template here.

  Editor command

    Enter the path to the executable of the text editor for the template here.

Help
  TikZ documentation

    Enter the path to the file containing the TikZ documentation here. An URL to online documentation may also be given.

    Search

      Press this button to search the file containing the TikZ documentation in the TeX directory structure using kpsewhich.

## Editor

This section of the dialog lets you configure the look and feel of the text editor.

&ktikz; configuration dialog - Editor &ktikz; Configuration Window Showing The Editor Options

Editor
  Text font

    Select the font of the unhighlighted main text.

  Show white spaces

    Show white spaces in the text by replacing them with special symbols. These symbols will not be saved on disk.

    Use color

      Select the color in which the spaces will be shown.

  Show tabulators

    Show tabulators in the text by replacing them with special symbols. These symbols will not be saved on disk.

    Use color

      Select the color in which the tabulators will be shown.

  Show matching brackets

    If the cursor is on a bracket ({[]}), then the corresponding opening/closing bracket will be highlighted.

    Use color

      Select the color in which the highlighted brackets will be shown.

  Use command completion

    When the first letters of a TikZ command are typed in the text, a list of possible completions will be shown.

## Highlighting

This section of the dialog lets you configure the fonts and colors for the highlighted code in the text editor.

&ktikz; configuration dialog - Highlighting &ktikz; Configuration Window Showing The Highlighting Options

Highlighting
  Standard

    When this option is checked, the default fonts and colors are used in the output.

  Custom

    When this option is checked, the fonts and colors defined below will be used in the output instead of the default ones.

  Change style for

    Select in the table the structure appearing in the TikZ code for which you want to change the fonts and colors.

  Change font

    Select the font in which the structure that you selected in the table above should be displayed.

  Change color

    Select the text color in which the structure that you selected in the table above should be displayed.