Menu EntriesThe File Menu&Ctrl;NFileNew
This command starts a new document in the editing
window. In the Documents list on the left the new file
is named Untitled.
&Ctrl;OFileOpen...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.FileOpen 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.
FileOpen With
This submenu presents a list of applications known to handle the mime type
of your current document. Activating an entry will open the current document
with that application.In addition, a entry Other... command launches
the open with dialog box that allows you to select another application
to open the active file. Your file will still be open in &kate;.
&Ctrl;SFileSave
This command saves your file. Use it often. If the file is
Untitled then
Save becomes
Save As.
FileSave As...Name and rename files with this command.
It launches the save file dialog box. This dialog works just as
the open file dialog box does. You can use it to navigate through
your file system, preview existing files, or filter your file
view with file masks.
Type the name you want to give the file you are saving in the
Location combo box and press the
OK button.
&Ctrl;LFileSave All
This command saves all modified open files.
F5FileReloadReloads the active file. This command is
useful if another program or process has changed the file while you have
it open in &kate;
FileReload AllReloads all opened files..
FileClose OrphanedClose all documents in the file list, which could
not be reopened during startup, because they are not accessible anymore.
&Ctrl;PFilePrint...Print the active file.
&Ctrl;WFileClose
Close the active file with this command. If you have made unsaved changes, you
will be prompted to save the file before &kate; closes it.
FileClose Other
Close other open documents.
FileClose All
This command closes all the files you have open
in &kate;.
&Ctrl;QFileQuit
This command closes &kate; and any files you were
editing. If you have made unsaved changes to any of the files you were
editing, you will be prompted to save them.
The Edit MenuThe Edit menu contains a host of commands,
all to work with the currently active document.Menu Entries&Ctrl;ZEditUndoUndo the last editing command (typing, copying, cutting etc.)If grouped undo is enabled, this may undo several editing commands of the same type, like typing in characters.&Ctrl;&Shift;ZEditRedoRedo the last undo step.&Ctrl;XEditCutRemoves selected text if any, and places a copy of the removed text in the clipboard.&Ctrl;CEditCopyCopies selected text, if any, to the clipboard.&Ctrl;VEditPasteCopies the first item in the clipboard into the editor at cursor position.If Overwrite Selection is enabled, the pasted text will overwrite the selection, if any.&Ctrl;AEditSelect AllSelects all text in the editor.&Ctrl;&Shift;AEditDeselectDeselects the selected text in the editor if any.&Ctrl;&Shift;
BEditBlock Selection ModeToggles Selection Mode. When the Selection Mode is BLOCK, you can make vertical selections,
⪚ select column 5 to 10 in lines 9 to 15.The status bar shows the current state of the Selection Mode, either LINE or BLOCK.Meta&Ctrl;VEditVI input
ModeSwitch to a vi-like, modal editing mode. This mode supports the most used commands
and motions from vim's normal and visual mode and has an optional vi mode statusbar.
This status bar shows commands while they are being entered, output from commands and
the current mode.The behavior of this mode can be configured in the
Vi Input Mode section of the
Editing page in &kappname;'s settings dialog.InsEditOverwrite
ModeToggles the Insert/Overwrite modes. When the mode is INS, you
insert characters where the cursor is. When the mode is OVR, writing
characters will replace the current characters if your cursor is positioned
before any character. The status bar shows the current state of the Overwrite
Mode, either INS or OVR.&Ctrl;FEditFind...Launch the incremental search bar to allow you to search for text in the edited document.F3EditFind NextGo to the nearest downwards match of the last text or regular expression searched for, starting from cursor position&Shift;F3EditFind PreviousGo to the nearest upwards match of the last text or regular expression searched for, starting from cursor position&Ctrl;REditReplace...Launch the power search and replace bar to replace one or more instances of a defined text with something else.&Ctrl;HEditFind SelectedFinds next occurrence of selected text.&Ctrl;&Shift;HEditFind Selected BackwardsFinds previous occurrence of selected text.&Ctrl;GEditGo to Line...Launches the Go To Line bar, allowing you to enter the number of a line to find in
the documentThe View MenuThe View menu allows you to manage settings
specific to the active editor, and to manage frames.Menu ItemsViewNew WindowOpens another instance of &kate;.
The new instance will be identical to your previous instance.
&Alt;LeftViewBackOpens the document displayed above the currently open document in the Documents list.&Alt;RightViewForwardOpens the document displayed below the currently open document in the Documents list.&Alt;AViewShow ActiveDisplays the currently open document in the Documents list.&Shift;F8ViewSplit ViewPrevious Split ViewFocus the previous document view, if you have split the editor
area in more views.F8ViewSplit ViewNext Split ViewFocus the next document view, if you have split the editor
area in more views.&Ctrl;&Shift;LViewSplit ViewSplit VerticalThis will split the frame (which may be the main editing area) in two equally sized frames,
the new one to the left of the current one. The new frame gets the focus, and will display the
same document as the old one.See also Working with the &kate; MDI&Ctrl;&Shift;TViewSplit ViewSplit HorizontalSplits the current frame (which may be the main editing area) in two equally sized frames,
the new one at the bottom half. The new frame gets the focus, and displays the same document as
the old one.See also Working with the &kate; MDI&Ctrl;&Shift;RViewSplit ViewClose Current ViewCloses the active frame. This is disabled, if there is only one frame
(the main editing area).No documents get closed by closing a
frame – they will still be available in the View Menu as well as in
the File List.See also Working with the
&kate; MDIViewTool Views&Ctrl;&Alt;&Shift;FViewTool ViewsShow SidebarsToggles the display of the sidebar button rows. This command
does not affect the display of the sidebar content widgets, any sidebar that
is visible will stay visible, and if you assigned shortcuts to the below
commands those will of course continue to work.ViewTool ViewsShow DocumentsToggle the display of &kate;'s Documents listViewTool ViewsShow TerminalToggles the display of the built in terminal emulator.When activated the first time, the terminal will be created.When the terminal emulator is displayed, it will get the focus, so that
you can start typing in commands immediately. If the Automatically synchronize the terminal
with the current document when possible option is enabled in the
Terminal page of the Main configuration dialog the shell session will
change to the directory of the active document, if it is a local file.This menu item is displayed by the Terminal Tool View plugin, which is
enabled by default.F7ViewSwitch to Command LineThis command will toggle the display of the
built in command line.
ViewShow the Javascript ConsoleThis opens a tool view that allows you to run Javascript code
interactively. For more information, see
Extending &kate; with Scripts.
ViewSchemaThis menu lists the available schemas. You can change the schema
for the current view here, to change the default schema you need to
use the Fonts & Colors page
of the config dialog.F10ViewDynamic Word WrapToggles dynamic word wrap in the current view. Dynamic word
wrap makes all the text in a view visible without the need for horizontal
scrolling by rendering one actual line on more visual lines as needed.ViewDynamic Word Wrap IndicatorsChoose when and how the dynamic word wrap indicators should be
displayed. This is only available if the Dynamic Word
Wrap option is checked.ViewShow Static Word
Wrap MarkerToggles the display of a vertical line indicating the position
of the wrap width as configured in the config dialog. This
feature requires that you use a true fixed-width font.F6ViewShow Icon BorderThis is a toggle item. Setting it on checked will make the Icon Border
visible in the left side of the active editor, and vice versa.F11ViewShow Line NumbersThis is a toggle Item. Setting it on checked will make a pane displaying
the line numbers of the document visible in the left border of the active editor,
and vice versa.ViewShow Scrollbar
MarksToggles the visualization of bookmarks (and other marks) on the
vertical scrollbar. When enabled, marks are represented by a thin line in the
mark color at the scrollbar, middleclicking on the lines will scroll the view
to a position near the mark.F9ViewShow Folding MarkersToggles the display of the folding marker pane in the left
side of the view. See Using
Code Folding.ViewCode FoldingThese options pertain to
code folding:&Ctrl;
-Fold Current NodeCollapse the region that contains the cursor.&Ctrl;
+Unfold current nodeExpand the region that contains the cursor.Unfold All NodesExpand all regions in the document.&Ctrl;
&Shift;-Fold Toplevel NodesCollapse all toplevel regions in the document.Fold Nodes in Level 2Collapse all level 2 nodes in the document.Fold Nodes in Level 3Collapse all level 3 nodes in the document.Fold Nodes in Level 4Collapse all level 4 nodes in the document.&Ctrl;
&Shift;+Unfold Toplevel NodesExpand all toplevel regions in the document.Unfold Nodes in Level 2Expand all level 2 nodes in the document.Unfold Nodes in Level 3Expand all level 3 nodes in the document.Unfold Nodes in Level 4Expand all level 4 nodes in the document.Enlarge FontThis increases the display font size.Shrink FontThis decreases the display font size.The Bookmarks MenuThe Bookmarks menu allows you to work with
the bookmarks in the currently active document.Below the entries described here, one entry for each bookmark in
the active document will be available. The text will be the first few
words of the marked line. Choose an item to move the cursor to the
start of that line. The editor will scroll as necessary to make that
line visible.Menu Items&Ctrl;BBookmarksSet BookmarkSets or removes a bookmark in the current line of the active document.
(If it's there, it is removed, otherwise one is set.)BookmarksClear All BookmarksClears (removes) all bookmarks in the active document.&Alt;
PgUpBookmarksPreviousThis will move the cursor to beginning of the first above line
with a bookmark. The menuitem text will include the line number and the first
piece of text on the line. This item is only available when there is a bookmark
in a line above the cursor.&Alt;
PgDownBookmarksNextThis will move the cursor to beginning of the next line with a
bookmark. The menuitem text will include the line number and the first piece of
text on the line. This item is only available when there is a bookmark in a line
below the cursor.The Sessions MenuThis menu contains entries for using and managing &kate; sessions.
For more information, read Using Sessions.SessionsNewCreates a new empty session. All currently open files will
be closed.SessionsOpen Session...Open an existing session. The Session Chooser dialog is
displayed to let you choose one.SessionsQuick Open SessionThis submenu lets you open an existing session.SessionsSave SessionSave the current session. If the session is anonymous, you will
be prompted for a session name.SessionsSave Session
As...Save the current session under a new name. You are prompted for
a name to use.SessionsManage Sessions...Displays the Session Manager dialog which allows you to rename
and delete sessions.The Tools MenuToolsPipe to
TerminalFeed the currently selected text into the built in terminal
emulator. No newline is added after the text. This menu item is displayed by the
Terminal Tool View plugin, which is enabled by default.ToolsSynchronize Terminal with Current DocumentThis will cause the built-in Terminal to cd into the
directory of the active document. This menu item is also displayed
by the Terminal Tool View plugin.Alternatively, you can configure &kappname; to always keep the terminal in
sync with the current document. See
for more information.ToolsFocus/Defocus TerminalSwitch the focus from the current document to the terminal and vice versa.
This menu item is also displayed by the Terminal Tool View plugin.ToolsRead Only ModeSet the current document to Read Only mode. This prevents any text
addition and any changes in the document formatting.ToolsModeChoose the filetype scheme you prefer for the active document. This
overwrites the global filetype
mode set in SettingsConfigure
&kate;... in the Filetypes tab for your current
document only.ToolsHighlightingChoose the Highlighting scheme you prefer for the active document. This
overwrites the global highlighting mode set in SettingsConfigure Editor... for your current document only.ToolsIndentationChoose the style of
indentation you want for your active document.
This overwrites the global indentation mode set in SettingsConfigure Editor... for your current document only.ToolsEncodingYou can overwrite the default encoding set in SettingsConfigure
Editor... in the Open/Save page
to set a different encoding for your current document. The encoding you
set here will be only valid for your current document.
ToolsEnd of LineChoose your preferred end of line mode for your active
document. This overwrites the global end of line mode set in SettingsConfigure Editor... for your current document only.ToolsAdd Byte Mark Order (BOM)Checking this action you can explicitly add a byte order mark for unicode
encoded documents. The byte order mark (BOM) is a Unicode character used to signal
the endianness (byte order) of a text file or stream, for more information see
Byte Order Mark.ToolsScriptsThis submenu contains a list of all scripted actions. The list can easily be
modified by writing
own scripts. This way, &kate; can be extended with user-defined tools.
The following scripts are included by default:ToolsScriptsSort Selected Text
Sorts the selected text or whole document in ascending order.
&Ctrl;&Shift;DownToolsScriptsMove Lines Down
Move selected lines down.
&Ctrl;&Shift;UpToolsScriptsMove Lines Up
Move selected lines up.
&Ctrl;&Alt;DownToolsScriptsDuplicate Selected Lines Down
Duplicates the selected lines down.
&Ctrl;&Alt;UpToolsScriptsDuplicate Selected Lines Up
Duplicates the selected lines up.
&Ctrl;SpaceToolsInvoke Code CompletionManually invoke command completion, usually by using a shortcut bound to this action.ToolsWord CompletionReuse Word Below (&Ctrl;
9) and Reuse Word Above
(&Ctrl; 8) complete
the currently typed text by searching for similar
words backward or forward from the current cursor position. Shell
Completion pops up a completion box with matching entries.&Ctrl;&Shift;OToolsAutomatic Spell CheckingWhen Automatic Spell Checking is enabled, wrong text
is underlined in the document on-the-fly.ToolsSpelling...This initiates the spellchecking program - a program
designed to help the user catch and correct any spelling errors.
Clicking on this entry will start the checker and bring up the speller dialog
box through which the user can control the process. There are four settings
lined up vertically in the center of the dialog with their corresponding labels
just to the left. Starting at the top they are:Unknown word:Here, the spellchecker indicates the word currently under
consideration. This happens when the checker encounters a word not in its
dictionary - a file containing a list of correctly spelled words against which
it compares each word in the editor.Replace with: If the checker has any similar words in its dictionary the
first one will be listed here. The user can accept the suggestion, type in his
or her own correction, or choose a different suggestion from the next
box.Language: If you have installed multiple dictionaries, here you can
select which dictionary/language should be used.On the right side of the dialog box are 6 buttons that allow the user to
control the spellcheck process. They are:Add to DictionaryPressing this button adds the Unknown word
to the checker's dictionary. This means that in the future
the checker will always consider this word to be correctly
spelled.Suggest The checker may list here a number of possible replacements for
the word under consideration. Clicking on any one of the suggestions will cause
that word to be entered in the Replace with box,
above.Replace This button has the checker replace the word under
consideration in the document with the word in the
Replace with box.Replace All This button causes the checker to replace not only the current
Unknown word: but to automatically make the same
substitution for any other occurrences of this Unknown word
in the document.IgnoreActivating this button will have the checker move on without
making any changes.Ignore All This button tells the checker to do nothing with the current
Unknown word: and to pass over any other instances of
the same word.This only applies to the current spellcheck
run. If the checker is run again later it will stop on this same
word.Three more buttons are located horizontally along the bottom of the
spellcheck dialog. They are:Help This invokes the &kde; help system with the help page
for this dialog.Finished This button ends the spellcheck process, and returns to the
document.Cancel This button cancels the spellcheck process, all modifications
are reverted, and you will return to your document.ToolsSpelling (from cursor)...This initiates the spellchecking program but it starts where your cursor
is instead of at the beginning of the document.ToolsSpellcheck Selection...Spellchecks the current selection.ToolsChange DictionaryDisplays a drop down box with all available dictionaries for spellchecking
at the bottom of the editor window. This allows easy switching of the spellcheck
dictionary ⪚ for automatic spellcheck of text in different languages.ToolsClean
IndentationThis cleans the indentation for the current selection or for the
line the cursor is currently in. Cleaning the indentation ensures that
all your selected text follows the indentation mode you choose.ToolsAlignCauses a realign of the current line or selected lines using the
indentation mode and indentation settings in the document.&Ctrl;DToolsCommentThis adds one space to the beginning of the line
where the text cursor is located or to the beginning of any
selected lines.&Ctrl;&Shift;DToolsUncommentThis removes 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;UToolsUppercasePut the selected text or the letter after the cursor in
uppercase.&Ctrl;&Shift;UToolsLowercasePut the selected text or the letter after the cursor in
lowercase.&Alt;&Ctrl;UToolsCapitalizeCapitalize the selected text or the current
word.&Ctrl;JToolsJoin LinesJoins the selected lines, or the current line and the line below
with one white space character as a separator. Leading/trailing white space on
joined lines is removed in the affected ends.ToolsApply Word WrapApply static word wrapping on all the document. That means that
a new line of text will automatically start when the current
line exceeds the length specified by the Wrap words at option
in the Editing tab in SettingsConfigure
Editor...Menu items for the selected plugins
are displayed at the end of this menu
The Settings MenuThe Settings menu allows you to change the properties
of the main window, such as showing/hiding toolbars, and provides
access to the configuration dialogs.SettingsShow Toolbar
When this is checked, this displays a movable toolbar containing buttons used to
initiate frequently used commands. When unchecked the toolbar is hidden.
SettingsShow
StatusbarWhen 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.SettingsShow
PathWhen selected, this displays in the titlebar the path (its location in the
file system) of the current document. When unchecked the path is hidden.&Ctrl;&Shift;FSettingsFull Screen
ModeToggles full screen display.SettingsConfigure Shortcuts...Display the familiar &kde; Keyboard Shortcut Configuration
Dialog.SettingsConfigure Toolbars...Display the familiar &kde; Toolbar Configuration Dialog.SettingsConfigure &kate;...Launch the Main Configuration DialogThe Help MenuApart from standard &kde; Help menu items
described below you will have menu entries to show the
Tip of the Day and the About
Editor Component information.
&help.menu.documentation;