The Fundamentals
Prev
Next

Chapter 2. The Fundamentals

If you have ever used a text editor, you will have no problem using Kate. In the next two sections, Starting Kate and Working with Kate, you will find everything you need to get up and running quickly.

Starting Kate

You can start Kate from the TDE menu or from the command line.

From the Menu

Open the TDE program menu by clicking on the big T icon on the toolbar at the bottom left of your screen. This will raise the program menu. Move your cursor up the menu to the Utilities->Editors menu item. A list of available editors will appear. Choose Kate.

Unless you configure Kate not to, it will load the last files you edited. See Configuring Kate to learn how to toggle this feature on and off.

From the Command Line

You can start Kate by typing its name on the command line. If you give it a file name, as in the example below, it will open or create that file.

%kate myfile.txt

If you have an active connection and permission, you can take advantage of TDE's network transparency to open files on the internet.

%kate http://git.trinitydesktop.org/cgit/tdebase/plain/doc/kate/index.docbook

Command Line Options

Kate accepts the following command line options:

kate --help

This lists the most basic options available at the command line.

kate --help-qt

This lists the options available for changing the way Kate interacts with Qt™.

kate --help-tde

This lists the options available for changing the way Kate interacts with TDE.

kate --help-tde-tempfile

This lists the available TDE-tempfile specific options.

kate --help-all

This lists all of the command line options.

kate --author

Lists Kate's authors in the terminal window.

kate -v --version

Lists version information for Qt™, TDE, and Kate.

kate --license

Shows license information.

kate -s --start name

Starts Kate with the session name. If the session does not exist, a new session with the specified name is created. If a Kate instance running the specified session already exists, the specified files are loaded in that instance.

kate -u --use URL

Causes Kate to use an existing instance if there is one. If you want all documents to open in one kate instance, you can add this option to the default command in your TDE application configuration, as well as create a shell alias in your command intepreter if it supports that.

kate -f --force-sdi

If the multiple document interface (MDI) setting is enabled, forces Kate to use the single document interface (SDI) mode.

kate -p --pid PID

Only reuses an instance with the specified PID (Process ID). Used with the --use option.

kate -e --encoding encoding URL

Uses the specified encoding for the document.

kate -l --line line URL

Navigates to the specified line after opening the document.

kate -c --column column URL

Navigates to the specified column after opening the document.

kate -i --stdin

Reads the document content from STDIN. This is similar to the common option - used in many command line programs, and allows you to pipe command output into Kate.

kate --tempfile

Since Kate 2.5.1 this standard TDE option is supported. When used, the specified files are treated as temporary files and deleted (if they are local files and you have sufficient permissions) when closed, unless they are modified since they were opened.

Drag and Drop

Kate uses the TDE Drag and Drop protocol. Files may be dragged and dropped onto Kate from the Desktop, Konqueror or some remote ftp site opened in one of Konqueror's windows.

Prev
Next
Home


Would you like to comment or contribute an update to this page?
Send feedback to the TDE Development Team