Warning, /utilities/kate/doc/kate/fundamentals.docbook is written in an unsupported language. File is not indexed.
0001 <chapter id="fundamentals"> 0002 <chapterinfo> 0003 <authorgroup> 0004 <author><personname><firstname></firstname></personname></author> 0005 <!-- TRANS:ROLES_OF_TRANSLATORS --> 0006 </authorgroup> 0007 </chapterinfo> 0008 <title>The Fundamentals</title> 0009 0010 <para> 0011 If you have ever used a text editor, you will have no problem using 0012 &kate;. In the next two sections, <link linkend="starting-kate">Starting 0013 &kate; </link> and in <link linkend="working-with-kate">Working with 0014 &kate;</link>, we will show you everything you need to get up and running 0015 quickly. 0016 </para> 0017 0018 <sect1 id="starting-kate"> 0019 <title>Starting &kate;</title> 0020 0021 <para> 0022 You can start &kate; from the application launcher or from the 0023 command line. 0024 </para> 0025 0026 <sect2 id="starting-from-the-menu"> 0027 <title>From the Menu</title> 0028 <para> 0029 Open the &kde; program menu by clicking on the 0030 application launcher icon on the toolbar at the bottom left of your 0031 screen. This will raise a menu. Move your 0032 cursor up the menu to the <menuchoice><guimenu>Applications</guimenu><guisubmenu>Utilities</guisubmenu> 0033 <guimenuitem>Advanced Text Editor &kate;</guimenuitem></menuchoice> menu item. 0034 </para> 0035 0036 </sect2> 0037 0038 <sect2 id="starting-from-the-command-line"> 0039 <title>From the Command Line</title> 0040 0041 <para> 0042 You can start &kate; by typing its name on the command line. If you give 0043 it a file name, as in the example below, it will open or create that 0044 file. 0045 </para> 0046 0047 <informalexample> 0048 <screen> 0049 <prompt>%</prompt><userinput><command>kate</command> <option><replaceable>myfile.txt</replaceable></option></userinput> 0050 </screen> 0051 </informalexample> 0052 0053 <para> 0054 If you have an active connection, and permission, you can take advantage 0055 of &kde;'s network transparency to open files on the internet. 0056 </para> 0057 0058 <informalexample> 0059 <screen> 0060 <prompt>%</prompt><userinput><command>kate</command> <option><replaceable>&kde-ftp;README</replaceable></option></userinput> 0061 </screen> 0062 </informalexample> 0063 0064 <para>To change the directory for temporary files, which defaults to <filename class="directory">/tmp</filename> 0065 set the <envar>TMPDIR</envar> environment variable before starting &kate;, ⪚ 0066 <informalexample> 0067 <screen> 0068 <prompt>%</prompt><userinput><command>mkdir</command> /tmp/kate -p && export TMPDIR=/tmp/kate && kate</userinput> 0069 </screen> 0070 </informalexample> 0071 </para> 0072 0073 <sect3 id="command-line-options"> 0074 <title>Command Line Options</title> 0075 <para>&kate; accepts following command line options:</para> 0076 0077 <variablelist> 0078 <varlistentry> 0079 <term><userinput><command>kate</command> <option>--help</option></userinput></term> 0080 <listitem> 0081 <para> 0082 This lists the options available at the command line. 0083 </para> 0084 </listitem> 0085 </varlistentry> 0086 0087 <varlistentry> 0088 <term><userinput><command>kate</command> 0089 <option>-s</option> <option>--start</option> <parameter>name</parameter></userinput></term> 0090 <listitem> 0091 <para> 0092 Starts &kate; with the session <parameter>name</parameter>. The session is created 0093 if it does not exist already. If a &kate; instance running the specified session 0094 exists, the specified files are loaded in that instance. 0095 </para> 0096 </listitem> 0097 </varlistentry> 0098 0099 <varlistentry> 0100 <term><userinput><command>kate</command> 0101 <option>-p</option> <option>--pid</option> <parameter>PID</parameter></userinput></term> 0102 <listitem> 0103 <para> 0104 Only reuses an instance with the specified PID (Process ID). 0105 </para> 0106 </listitem> 0107 </varlistentry> 0108 0109 <varlistentry> 0110 <term><userinput><command>kate</command> 0111 <option>-e</option> <option>--encoding</option> <parameter>encoding</parameter> 0112 <parameter>URL</parameter></userinput></term> 0113 <listitem><para>Uses the specified encoding for the document. 0114 </para></listitem> 0115 </varlistentry> 0116 0117 <varlistentry> 0118 <term><userinput><command>kate</command> 0119 <option>-l</option> <option>--line</option> <parameter>line</parameter> 0120 <parameter>URL</parameter></userinput></term> 0121 <listitem><para>Navigates to the specified line after opening the document. 0122 </para></listitem> 0123 </varlistentry> 0124 0125 <varlistentry> 0126 <term><userinput><command>kate</command> 0127 <option>-c</option> <option>--column</option> <parameter>column</parameter> 0128 <parameter>URL</parameter></userinput></term> 0129 <listitem><para>Navigates to the specified column after opening the document. 0130 </para></listitem> 0131 </varlistentry> 0132 0133 <varlistentry> 0134 <term><userinput><command>kate</command> 0135 <option>-i</option> <option>--stdin</option></userinput></term> 0136 <listitem><para>Reads the document content from STDIN. This 0137 is similar to the common option <option>-</option> used in many command line 0138 programs, and allows you to pipe command output into &kate;.</para></listitem> 0139 </varlistentry> 0140 0141 <varlistentry> 0142 <term><userinput><command>kate</command> 0143 <option>--startanon</option></userinput></term> 0144 <listitem><para>Start &kate; with a new anonymous session, implies 0145 <option>-n</option>.</para></listitem> 0146 </varlistentry> 0147 0148 <varlistentry> 0149 <term><userinput><command>kate</command> 0150 <option>-n</option> <option>--new</option></userinput></term> 0151 <listitem><para>Force start of a new &kate; instance (is ignored if <option>start</option> is 0152 used and another &kate; instance already has the given session opened), forced 0153 if no parameters and no URLs are given at all.</para></listitem> 0154 </varlistentry> 0155 0156 <varlistentry> 0157 <term><userinput><command>kate</command> 0158 <option>-b</option> <option>--block</option></userinput></term> 0159 <listitem><para>If using an already running &kate; instance, block until it exits, if URLs 0160 given to open.</para> 0161 <para> 0162 You can use &kate; with this option as editor for typing in commit messages for version 0163 control systems like &git; or <application>Subversion</application>. 0164 These systems expect to block the editor till you have entered your 0165 message, because they then open the temporary file, which would be empty 0166 if &kate; immediately returned to the caller. 0167 </para> 0168 <para>This option is also needed with KIO (&kde; Input/Output), if you open a remote file (which has been 0169 downloaded to a temporary) and should be reuploaded, after you saved it. 0170 </para></listitem> 0171 </varlistentry> 0172 0173 <varlistentry> 0174 <term><userinput><command>kate</command> 0175 <option>--tempfile</option></userinput></term> 0176 <listitem><para>When used, the specified files are treated as temporary files and 0177 deleted (if they are local files and you have sufficient permissions) when 0178 closed, unless they were modified since they were opened.</para></listitem> 0179 </varlistentry> 0180 0181 <varlistentry> 0182 <term><userinput><command>kate</command> 0183 <option>--desktopfile</option> <parameter>filename</parameter></userinput></term> 0184 <listitem><para>The base file name of the desktop entry for this application.</para> 0185 <para>This is in particular useful for wrapper applications and 0186 applications having in general multiple desktop files. Thus each desktop 0187 file can have its own command line for the <option>Exec</option> entry. 0188 </para></listitem> 0189 </varlistentry> 0190 0191 <varlistentry> 0192 <term><userinput><command>kate</command> 0193 <option>--author</option></userinput></term> 0194 <listitem> 0195 <para> 0196 Lists &kate;'s authors in the terminal window. 0197 </para> 0198 </listitem> 0199 </varlistentry> 0200 0201 <varlistentry> 0202 <term><userinput><command>kate</command> 0203 <option>-v</option> <option>--version</option></userinput></term> 0204 <listitem> 0205 <para> 0206 Lists version information for &kate;. 0207 </para> 0208 </listitem> 0209 </varlistentry> 0210 0211 <varlistentry> 0212 <term><userinput><command>kate</command> 0213 <option>--license</option></userinput></term> 0214 <listitem> 0215 <para> 0216 Shows license information. 0217 </para> 0218 </listitem> 0219 </varlistentry> 0220 </variablelist> 0221 0222 </sect3> 0223 </sect2> 0224 0225 <sect2 id="drag-and-drop"> 0226 <title>Drag and Drop</title> 0227 <para> 0228 &kate; uses the &kde; Drag and Drop protocol. Files may be dragged and 0229 dropped onto &kate; from the Desktop, the filemanager &dolphin; or some remote &FTP; 0230 site opened in one of &dolphin;'s windows. 0231 </para> 0232 </sect2> 0233 </sect1> 0234 0235 <sect1 id="working-with-kate"> 0236 <title>Working with &kate;</title> 0237 <para> 0238 <link linkend="quick-start">Quick Start</link> will show you how to 0239 toggle four simple options that will let you configure some of &kate;'s 0240 more powerful features right away. <link linkend="keystroke-commands"> 0241 Shortcuts</link> lays out some of the default keystroke 0242 shortcuts for those who can't or don't want to use a mouse. 0243 </para> 0244 0245 <sect2 id="quick-start"> 0246 <title>Quick Start</title> 0247 0248 <para> 0249 This section will describe some of the items on the 0250 <guimenu>View</guimenu> menu so that you can quickly configure 0251 &kate; to work the way you want it. 0252 </para> 0253 0254 <para> When you start &kate; for the first time you will see two windows 0255 with white backgrounds. Above the two windows is a toolbar with the 0256 usual labeled icons. And above that, a menubar. 0257 </para> 0258 0259 <para> 0260 The left-hand window is a side bar. It combines the <guilabel>Documents</guilabel> 0261 and <guilabel>Filesystem Browser</guilabel> windows. Switch between the two by clicking on the tabs 0262 to the left of the window. </para> 0263 0264 <para> 0265 If you've started &kate; with a file, the right-hand window will show 0266 the file you are editing and the <guilabel>Documents</guilabel> on the side bar will show the 0267 name of the file. Use the <guilabel>Filesystem Browser</guilabel> window to open files. 0268 </para> 0269 0270 <para> 0271 You can toggle all sidebar windows on and off in 0272 <menuchoice><guimenu>View</guimenu><guisubmenu>Tool Views</guisubmenu></menuchoice> 0273 menu or use <keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>F</keycap></keycombo>. 0274 This menu offers you your first glimpse into &kate;'s power and 0275 flexibility. 0276 </para> 0277 0278 <para>In <guisubmenu>Tool Views</guisubmenu> you have a list of all enabled plugins. 0279 Click the checkbox in front of each item or click with the &LMB; on the tool buttons 0280 in the sidebar to toggle this tool view on and off. 0281 </para> 0282 0283 </sect2> 0284 0285 <sect2 id="keystroke-commands"> 0286 <title>Shortcuts</title> 0287 0288 <para> 0289 Many of &kate;'s keystroke commands (shortcuts) are configurable by 0290 way of the <link linkend="settings-help-menu">Settings</link> menu. By default 0291 &kate; honors the following key bindings. 0292 </para> 0293 0294 <informaltable> 0295 <tgroup cols="2"> 0296 <tbody> 0297 0298 <row> 0299 <entry><para><keycombo action="simul"><keycap>F1</keycap></keycombo></para></entry> 0300 <entry><para> Help</para></entry> 0301 </row> 0302 <row> 0303 <entry><para><keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo></para></entry> 0304 <entry><para><link linkend="whats-this">What's this?</link></para></entry> 0305 </row> 0306 <row> 0307 <entry><para><keycombo action="simul">&Ctrl;<keycap>N</keycap></keycombo></para></entry> 0308 <entry><para> <link linkend="file-new">New</link> document</para></entry> 0309 </row> 0310 <row> 0311 <entry><para><keycombo action="simul">&Ctrl;<keycap>L</keycap></keycombo></para></entry> 0312 <entry><para> Save All</para></entry> 0313 </row> 0314 <row> 0315 <entry><para><keycombo 0316 action="simul">&Ctrl;<keycap>O</keycap></keycombo></para></entry> 0317 <entry><para><link linkend="file-open">Open a document</link> </para></entry> 0318 </row> 0319 <row> 0320 <entry><para><keycombo action="simul">&Ctrl;&Alt;<keycap>O</keycap></keycombo> </para></entry> 0321 <entry><para>Quick Open</para></entry> 0322 </row> 0323 <row> 0324 <entry><para><keycombo action="simul">&Ctrl;&Shift;<keycap>F</keycap></keycombo> </para></entry> 0325 <entry><para>Full Screen Mode</para></entry> 0326 </row> 0327 <row> 0328 <entry><para><keycombo action="simul">&Ctrl;&Shift;<keycap>,</keycap></keycombo> </para></entry> 0329 <entry><para>Configure &kate;</para></entry> 0330 </row> 0331 <row> 0332 <entry><para><keycombo 0333 action="simul">&Ctrl;<keycap>W</keycap></keycombo> / 0334 <keycombo action="simul">&Ctrl;&Esc;</keycombo></para></entry> 0335 <entry><para><link linkend="file-close">Close</link> </para></entry> 0336 </row> 0337 <row> 0338 <entry><para><keycombo action="simul">&Ctrl;<keycap>Q</keycap></keycombo> </para></entry> 0339 <entry><para>Quit - close active copy of editor </para></entry> 0340 </row> 0341 <row> 0342 <entry><para><keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>F</keycap></keycombo> </para></entry> 0343 <entry><para>Show Sidebars</para></entry> 0344 </row> 0345 <row> 0346 <entry><para><keycombo action="simul">&Ctrl;&Shift;<keycap>T</keycap></keycombo> </para></entry> 0347 <entry><para>Split Horizontal</para></entry> 0348 </row> 0349 <row> 0350 <entry><para><keycombo action="simul">&Ctrl;&Shift;<keycap>L</keycap></keycombo> </para></entry> 0351 <entry><para>Split Vertical</para></entry> 0352 </row> 0353 <row> 0354 <entry><para><keycap>F8</keycap></para></entry> 0355 <entry><para>Next Split View</para></entry> 0356 </row> 0357 <row> 0358 <entry><para><keycombo action="simul">&Shift;<keycap>F8</keycap></keycombo> / 0359 <keycombo action="simul">&Ctrl;&Esc;</keycombo></para></entry> 0360 <entry><para>Previous Split View</para></entry> 0361 </row> 0362 <row> 0363 <entry><para><keycombo action="simul">&Ctrl;&Shift;<keycap>R</keycap></keycombo> </para></entry> 0364 <entry><para>Close Current View</para></entry> 0365 </row> 0366 <row> 0367 <entry><para><keycombo action="simul">&Alt;&Right;</keycombo></para></entry> 0368 <entry><para>Next Tab</para></entry> 0369 </row> 0370 <row> 0371 <entry><para><keycombo action="simul">&Alt;&Left;</keycombo></para></entry> 0372 <entry><para>Previous Tab</para></entry> 0373 </row> 0374 0375 </tbody> 0376 </tgroup> 0377 </informaltable> 0378 0379 <para>Additionally you can use the shortcuts provided by the <ulink 0380 url="help:/katepart/keybindings.html">&katepart;</ulink> component and by all activated <link linkend="plugins">&kate; plugins</link>.</para> 0381 0382 </sect2> 0383 0384 </sect1> 0385 0386 <sect1 id="kate-mdi"> 0387 <title>Working With the &kate; <acronym>MDI</acronym></title> 0388 0389 <sect2 id="kate-mdi-overview"> 0390 <title>Overview</title> 0391 0392 <para>Window, View, Document, Frame, Editor... What are they all in 0393 the terminology of &kate;, and how do you get the most out of it? This 0394 chapter will explain all of that, and even more.</para> 0395 0396 <sect3 id="kate-mdi-overview-mainwindow"> 0397 0398 <title>The Main Window</title> 0399 0400 <para><indexterm><primary>Main window</primary></indexterm> 0401 The &kate; Main Window is a standard &kde; application window, 0402 with the addition of side bars containing tool views. It has a 0403 menubar with all the common menus, and some more, and a toolbar 0404 providing access to commonly used commands.</para> 0405 0406 <para>The most important part of the window is the editing area, by 0407 default displaying a single text editor component, in which you can 0408 work with your documents.</para> 0409 0410 <para>The docking capabilities of the window is used for the tool 0411 windows of any plugin enabled in the settings dialog.</para> 0412 0413 <para>Tool views can be positioned in any sidebar, to move a tool right click 0414 its sidebar button and select from the &RMB; menu</para> 0415 0416 <para>A tool view can be marked as <emphasis>persistent</emphasis> in the &RMB; 0417 menu for its sidebar button. The sidebar can contain 0418 more tools at one time so that when a tool is persistent other tools can be 0419 shown simultaneously.</para> 0420 0421 <para>If a plugin has configuration options you can use the first item 0422 in the context menu to open the corresponding page in &kate;'s 0423 settings dialog.</para> 0424 0425 </sect3> 0426 0427 </sect2> 0428 0429 <sect2 id="kate-mdi-editor"> 0430 0431 <title>The Editor area</title> 0432 0433 <para><indexterm><primary>Editing Area</primary></indexterm> 0434 &kate; is capable of having more than one document open at the 0435 same time, and also of splitting the editing area into any number of 0436 frames, similar to how for example &konqueror; or the popular 0437 <application>emacs</application> text editor works. This way you can 0438 view several documents at the same time, or more instances of the same 0439 document, handy for example if your document contains definitions in 0440 the top that you want to see often for reference. Or you could view a 0441 program source header in one frame, while editing the implementation 0442 file in another.</para> 0443 0444 <para>When a document is available in more than one editor, changes 0445 made in one editor will immediately be reflected in the others as 0446 well. This includes changing the text as well as selecting 0447 text. Search operations or cursor movement is only reflected in the 0448 current editor.</para> 0449 0450 <para>It is currently not possible to have more instances of the same 0451 document open in the sense that one instance will be edited while the 0452 other will not.</para> 0453 0454 <para>When splitting an editor into two frames, it is divided into two 0455 equally sized frames, both displaying the current document of that 0456 editor. The new frame will be at the bottom (in the case of a 0457 horizontal split) or at the right (for a vertical split). The new 0458 frame gets the focus, which is visualized by the blinking cursor bar in the 0459 focused frame.</para> 0460 0461 </sect2> 0462 0463 </sect1> 0464 0465 <sect1 id="fundamentals-using-sessions"> 0466 <title>Using Sessions</title> 0467 0468 <para>Sessions is how &kate; lets you keep more than one list of files and 0469 &GUI; configuration around. You can have as many named sessions as you want, 0470 and you can use unnamed or anonymous sessions for files you want to use only 0471 once. Currently &kate; can save the list of open files, and the general window 0472 configuration in the session; future versions of &kate; may add more features 0473 that can be saved in sessions. With the introduction of sessions, &kate; also 0474 allows you to open any number of instances of the application instead of just 0475 one as it used to do as the default behavior.</para> 0476 0477 <para>Sessions are supported in three areas: 0478 0479 <itemizedlist> 0480 <listitem><para><link linkend="command-line-options"><emphasis>Command line 0481 options</emphasis></link> that lets you select and start sessions when launching 0482 &kate; from the command line.</para> 0483 </listitem> 0484 <listitem><para><link linkend="sessions-menu"><emphasis>The Sessions 0485 menu</emphasis></link> that lets you switch, save, start and manage your 0486 sessions.</para></listitem> 0487 <listitem><para><link linkend="config-dialog-sessions"><emphasis>Configuration 0488 options</emphasis></link> that lets you decide how sessions generally should 0489 behave.</para></listitem> 0490 </itemizedlist> 0491 0492 </para> 0493 0494 <para>When starting a new session, the &GUI; configuration of <guilabel>Default 0495 Session</guilabel> is loaded. To save window configuration in the default 0496 session, you need to enable saving window configuration in the sessions 0497 configuration page of the configuration dialog and then load the default 0498 session, set up the window as desired and save the session again.</para> 0499 0500 <para>When a named session is loaded, &kate; will display the session name at 0501 the start of the window title, which then has the form 0502 <quote><replaceable>Session Name</replaceable>: <replaceable>Document name or 0503 &URL;</replaceable> - &kate;</quote>.</para> 0504 0505 <para>When opening files on the command line with <option>--start 0506 <replaceable>name</replaceable></option> or if a session is selected using the 0507 session chooser, the specified session is loaded prior to the files specified 0508 on the command line. To open files from the command line in a new, unnamed 0509 session, configure &kate; to start a new session as default in the session page of 0510 the configuration dialog or use <option>--start</option> with an empty string: 0511 <replaceable>''</replaceable>.</para> 0512 0513 <para>Since &kate; 2.5.1 the <acronym>PID</acronym> of the current instance is 0514 exported to the environment variable <envar>KATE_PID</envar>. When opening files 0515 from the built in terminal Kate will automatically select the current instance 0516 if nothing else is indicated on the command line.</para> 0517 0518 </sect1> 0519 0520 <sect1 id="fundamentals-quick-open"> 0521 <title>Quick Open</title> 0522 0523 <para>To be able to quickly open/switch between files, Kate comes with a built-in quick open 0524 dialog. You can open it with <keycombo action="simul">&Ctrl;&Alt;<keycap>O</keycap></keycombo>. 0525 </para> 0526 0527 <para> 0528 Quick open can show all open documents in Kate as well as all files in open projects. To 0529 be able to see project files, you need to enable <link linkend="kate-application-plugin-projects">Project Plugin</link>. 0530 </para> 0531 0532 <sect2> 0533 <title>Using Quick Open</title> 0534 0535 <para> 0536 Using quick open is very simple. Once you open it, just type the name or portions of the name of the file 0537 you want to open and quick open will filter the list based on what you typed. Hitting &Enter; opens the selected file, 0538 while &Esc; hides the quick open. 0539 </para> 0540 <para> 0541 By default, only the file name is matched while filtering. If you want to match path, you need 0542 to have a "/" in the typed text. For example: "doc/index" will match all the files that contain 0543 "index" inside the folder "doc". 0544 </para> 0545 <para> 0546 The documents which are already open are highlighted in bold and are listed at the top when the dialog 0547 opens. Also, when quick open shows up the previous open document is already selected so you can just 0548 press &Enter; and it will take you to that document. 0549 </para> 0550 0551 </sect2> 0552 0553 <sect2> 0554 <title>Configuring Quick Open</title> 0555 <screenshot id="screenshot-project-quickopen"> 0556 <screeninfo>Quick Open</screeninfo> 0557 <mediaobject> 0558 <imageobject><imagedata fileref="project-quickopen.png" format="PNG"/></imageobject> 0559 </mediaobject> 0560 </screenshot> 0561 <para> 0562 Quick open provides a couple of config options. To access these options, right-click in the input line edit. 0563 </para> 0564 <variablelist> 0565 <varlistentry> 0566 <term>Currently available options are:</term> 0567 <listitem> 0568 <para><userinput>Current Project</userinput> - Show files from current project only</para> 0569 <para><userinput>All Projects</userinput> - Show files from all open projects</para> 0570 <para><userinput>Fuzzy Filtering</userinput> - Use fuzzy matching algorithm to filter files</para> 0571 <para><userinput>Wildcard Filtering</userinput>- Use wildcard matching to filter files</para> 0572 </listitem> 0573 </varlistentry> 0574 </variablelist> 0575 </sect2> 0576 0577 </sect1> 0578 0579 <sect1 id="fundamentals-getting-help"> 0580 0581 <title>Getting Help</title> 0582 0583 <sect2> 0584 0585 <title>With &kate;</title> 0586 <variablelist> 0587 0588 <varlistentry> 0589 <term>This manual</term> 0590 0591 <listitem> 0592 <para>Offers detailed documentation on all menu commands, 0593 configuration options, tools, dialogs, plugins &etc; as well as 0594 descriptions of the &kate; window, the editor and various concepts 0595 used in the application.</para> 0596 0597 <para>Press <keycap>F1</keycap> or use the 0598 <menuchoice><guimenu>Help</guimenu> 0599 <guimenuitem>&kate; Handbook</guimenuitem></menuchoice> menu topic to view this 0600 manual.</para></listitem> 0601 0602 </varlistentry> 0603 0604 <varlistentry id="whats-this"> 0605 <term>What's This Help</term> 0606 <listitem> 0607 <para>What's This help offers immediate help with single elements of 0608 graphical windows, such as buttons or other window areas.</para> 0609 0610 <para>We strive to provide What's This help for any elements for which 0611 it makes sense. It is available throughout the configuration dialog, 0612 and in many other dialogs as well.</para> 0613 0614 <para>To employ What's This help, press 0615 <keycombo action="simul">&Shift;<keycap>F1</keycap></keycombo> or use the 0616 <menuchoice><guimenu>Help</guimenu><guimenuitem>What's 0617 This</guimenuitem></menuchoice> menu item to enable What's This 0618 mode. The cursor will turn into an arrow with a question mark, and you 0619 can now click any element in the window to read the What's This help 0620 for that element, if it is available.</para> 0621 </listitem> 0622 </varlistentry> 0623 0624 <varlistentry> 0625 <term>Help Buttons in Dialogs</term> 0626 <listitem> 0627 <para>Some dialogs have a <guibutton>Help</guibutton> Button. Pressing 0628 it will start the &khelpcenter; and open the relevant 0629 documentation.</para> 0630 </listitem> 0631 </varlistentry> 0632 </variablelist> 0633 0634 </sect2> 0635 0636 <sect2> 0637 <title>With Your Text Files</title> 0638 0639 <para>&kate; does not (yet!) provide any means for reading document 0640 related documentation. Depending on the file you are editing, you may 0641 find the <link linkend="kate-application-plugin-konsole">Built in 0642 Terminal Emulator</link> helpful for viewing related &UNIX; manual pages or 0643 info documentation, or you can use &konqueror;.</para> 0644 0645 </sect2> 0646 0647 <sect2> 0648 <title>Articles on &kate;</title> 0649 0650 <para>&kate;'s homepage provides some <ulink url="https://kate-editor.org/featured-articles"> 0651 Articles and Howtos</ulink> with further information beyond the scope of this handbook.</para> 0652 0653 </sect2> 0654 0655 </sect1> 0656 0657 </chapter>