# Command Reference

## The File Menu

&Ctrl;N File New

- This starts a new document in a new and independent editor window.

&Ctrl;O File Open...

- Displays a standard &kde; Open File dialog. Use the file view to select the file you want to open, and click on Open to open it. You can find more information about the &kde; Open File dialog in the &kde; User Guide.

File Open Recent

- This is a shortcut to open recently saved documents. Clicking on this item opens a list to the side of the menu with several of the most recently saved files. Clicking on a specific file will open it in &kappname; - if the file still resides at the same location.

&Ctrl;S File Save

- This saves the current document. If there has already been a save of the document then this will overwrite the previously saved file without asking for the user's consent. If it is the first save of a new document the save as dialog (described below) will be invoked.

File Save As...

- This allows a document to be saved with a new file name. This is done by means of the file dialog box described above in the Open section of this help file.

File Export

- Exports the current document to different formats, so that the document can be viewed as an image. Currently the document can be exported as Encapsulated PostScript (EPS), Portable Document Format (PDF) and Portable Network Graphics (PNG).

F5 File Reload

- Reload the current document from disk. If you have made unsaved changes, you will be prompted to save the file before &kappname; reloads it.

&Ctrl;W File Close

- Close the active file with this command. If you have made unsaved changes, you will be prompted to save the file before &kappname; closes it.

&Ctrl;Q File Quit

- This will close the editor window, if you have more than one instance of &kappname; running, through the New or Open menu items, those instances will not be closed.

## The Edit Menu

&Ctrl;Z Edit Undo

- This is used to eliminate or reverse the most recent user action or operation.

&Ctrl;&Shift;Z Edit Redo

- This will reverse the most recent change (if any) made using Undo.

&Ctrl;X Edit Cut

- This command deletes the current selection and places it on the clipboard. The clipboard is a feature of &kde; that works invisibly to provide a way to transfer data between applications.

&Ctrl;C Edit Copy

- This copies the currently selected text to the clipboard so that it may be pasted elsewhere. The clipboard is a feature of &kde; that works invisibly to provide a way to transfer data between applications.

&Ctrl;V Edit Paste

- This will insert the contents of the clipboard at the cursor position. The clipboard is feature of &kde; that works invisibly to provide a way to transfer data between applications.

&Ctrl;A Edit Select All

- This will select the entire document. This could be very useful for copying the entire file to another application.

&Ctrl;I Tools Indent

- This increases the paragraph's indentation by one step. The size of the step can be selected in the dialog that appears when triggering this action.

&Ctrl;D Tools Comment

- This adds the LaTeX comment character % and one space to the beginning of the line where the text cursor is located or to the beginning of any selected lines.

&Ctrl;&Shift;D Tools Uncomment

- This removes the LaTeX comment character % and one space (if any exist) from the beginning of the line where the text cursor is located or from the beginning of any selected lines.

&Ctrl;F Edit Find...

- This opens the search bar at the bottom of the editor window. On the left side of the bar is an icon to close the bar, followed by a small text box for entering the search pattern.

  You have to enter the characters of your search pattern and press the Find button. If there is a match in the text, this is highlighted. Continue to press the Find button to find the next matches. If the search pattern does not match any string in the subsequent text anymore, a dialog asking to start searching from the beginning is shown.

  Use the Search Backwards or Search Forward button to direct the search to proceed in an upwardly or downwardly direction.

  You can modify the search behaviour by selecting different Options: Checking Whole Words Only prevents the search from stopping on words that contain the searched for pattern. Selecting Case Sensitive will limit finds to entries that match the case (upper or lower) of each of the characters in the search pattern.

F3 Edit Find Next

- This repeats the last find operation, if any, otherwise starts a new find operation.

&Shift;F3 Edit Find Previous

- This repeats the last find operation, if any, searching backwards instead of forwards through the document.

&Ctrl;R Edit Replace...

- This opens the search and replace bar at the bottom of the editor window. On the left side of the bar is an icon to close the bar, followed by a small text box for entering the search pattern.

  Use the Search Backwards or Search Forward button to direct the search to proceed in an upwardly or downwardly direction.

  You can modify the search behaviour by selecting different Options: Checking Whole Words Only prevents the search from stopping on words that contain the searched for pattern. Selecting Case Sensitive will limit finds to entries that match the case (upper or lower) of each of the characters in the search pattern.

  Enter the text to be replaced in the text box labeled Find and the text to replace with in the text box labeled Replace, then click the Replace button. The replace bar is replaced by a set of buttons. If there is a match in the text, this is highlighted. Press Replace to replace the currently highlighted text. Continue to press the Replace button to find and replace the next matches. If the search pattern does not match any string in the subsequent text anymore, a dialog asking to start searching from the beginning is shown. Press the Replace All button to replace the search text in the whole document. Press the Don't Replace button to skip the currently highlighted text and find the next match. Press the Cancel button to cancel the replacing.

## The View menu

The View menu allows you to manage settings specific to the preview.

&Ctrl;+ View Zoom In

- Increase the magnification of the document view.

&Ctrl;- View Zoom Out

- Decrease the magnification of the document view.

&Alt;Left View Previous Image

- Show the preview of the previous TikZ picture in the code. This item is only shown when there are multiple TikZ pictures in the code (delimited by \begin{tikzpicture} and \end{tikzpicture}).

&Alt;Right View Next Image

- Show the preview of the next TikZ picture in the code. This item is only shown when there are multiple TikZ pictures in the code (delimited by \begin{tikzpicture} and \end{tikzpicture}).

## The Go Menu

&Ctrl;G Go Go to Line...

- This opens the goto line bar at the bottom of the window which is used to have the cursor jump to a particular line (specified by number) in the document. The line number may be entered directly into the text box or graphically by clicking on the up or down arrow spin controls at the side of the text box. The little up arrow will increase the line number and the down arrow decrease it. Close the bar with a click on the icon on the left side of the bar.

## The Process Menu

Esc Process Stop Process

- Abort the execution of the currently running process.

Process View Log

- Show the LaTeX log file in the Messages panel.

Process Shell Escape

- Enable LaTeX to run shell commands, this is needed when you want to plot functions using `gnuplot` within TikZ.

  Enabling this may cause malicious software to be run on your computer! Check the LaTeX code to see which commands are executed.

## The Insert Menu

This menu contains a (currently non-exhaustive) list of TikZ commands. By selecting them, you can insert them in the text at the cursor's current position.

## The Settings Menu

Settings Toolbars

- This submenu lists the available toolbars, each item toggles the display of the associated toolbar. When checked, each item displays a movable toolbar containing buttons used to initiate frequently used commands. When unchecked the toolbar is hidden.

Settings Sidebars

- This submenu lists the available sidebars, each item toggles the display of the associated sidebar.

Settings Show Statusbar

- When checked, this displays a small bar at the bottom of the editor containing information about the status of the current document. When unchecked the status bar is hidden.

Settings Configure Shortcuts...

- This command opens a dialog box whereby the shortcuts may be changed. A display window shows the list of commands (actions) and their assigned shortcuts, alternates and global shortcuts. The Search line above the list window is used to filter the shortcut list. Selecting an action with a &LMB; click (either on the action name or shortcut cell for the default shortcut or on the alternate cell for an alternative) displays the Default and Custom radio buttons below the selected action.

  To assign or change a shortcut click on the None button. Its label changes then to Input, now press the new key combination for the action.

  For example, with the About &kde; action selected in the display window, press the &Ctrl;, &Alt; and the K key on the keyboard. This would mean that anytime you hold down the &Ctrl; and &Alt; buttons and pressed K (while using &kappname;) the About &kde; display box would be called.

  Use the buttons at the bottom of the dialog to set all shortcuts back to their defaults, print the shortcut list or cancel all changes. Click the OK button to close the dialog and accept all changes.

Settings Configure Toolbars...

- This will open the dialog whereby the toolbar configuration may be changed. The user can choose which shortcut buttons should appear on the toolbar. A display window on the left lists the commands available to placed on the toolbar. A display on the right lists those commands already on the toolbar. A set of four arrow buttons between the two displays manipulates the selections. The right pointing arrow places any command selected in the left pane onto the right pane, i.e., it is added to the toolbar. The left arrow does just the opposite, removing any action selected in the right window from the toolbar. The up and down pointing arrows change the position of an action selected in the right window which changes the position of its button in the toolbar.

Settings Configure &kappname;...

- This menu item opens a dialog whereby several different settings may be adjusted.

## The Help Menu

&ktikz; has a standard &kde; Help as described below, with one addition:

Help TikZ Manual

- Opens the TikZ Manual. This is the full TikZ Manual bundled with the LaTeX PGF package, it contains a tutorial on how to use TikZ and a reference guide of all PGF and TikZ commands.

The standard &kde; Help entries are:

&help.menu.documentation;