doc/katepart/fundamentals.docbook

0001 <chapter id="on-screen-fundamentals">
0002 <title>Some Fundamentals</title>
0003
0004 <para>
0005 &kwrite; and many other &katepart; users are very simple to use. Anyone that has
0006 used a text editor should have no problems.
0007 </para>
0008
0009 <sect1 id="drag-and-drop">
0010 <title>Drag and Drop</title>
0011
0012 <para>
0013 &katepart; uses the &kde; Drag and Drop protocol. Files may be dragged and
0014 dropped onto &katepart; from the Desktop, the filemanager &dolphin;, or some
0015 remote &FTP; site opened in one of &dolphin;'s windows.
0016 </para>
0017 </sect1>
0018
0019 <sect1 id="keybindings">
0020 <title>Shortcuts</title>
0021
0022 <para>Many of the shortcuts are configurable by way of the <link
0023 linkend="settings-help-menu">Settings</link> menu.  By default &katepart; honors the
0024 following shortcuts:</para>
0025 <informaltable>
0026 <tgroup cols="2">
0027 <tbody>
0028
0029 <row><entry><para>&Ins;</para></entry>
0030 <entry><para>
0031 Toggle between Insert and Overwrite mode. When in insert mode the
0032 editor will add any typed characters to the text while pushing along any data to
0033 the right of the text cursor. Overwrite mode causes the entry of each character
0034 to eliminate the character immediately to the right of the text
0035 cursor.</para></entry>
0036 </row>
0037 <row>
0038 <entry><para>&Left;</para></entry>
0039 <entry><para>Move the cursor one character to the left.</para></entry>
0040 </row>
0041 <row>
0042 <entry><para>&Right;</para></entry>
0043 <entry><para>Move the cursor one character to the right.</para></entry>
0044 </row>
0045 <row>
0046 <entry><para>&Up;</para></entry>
0047 <entry><para>Move the cursor up one line.</para></entry>
0048 </row>
0049 <row>
0050 <entry><para>&Down;</para></entry>
0051 <entry><para>Move the cursor down one line.</para></entry>
0052 </row>
0053 <row>
0054 <entry><para><keycombo action="simul">&Ctrl;<keycap>E</keycap></keycombo></para></entry>
0055 <entry><para>Go to previous edit location in document.</para></entry>
0056 </row>
0057 <row>
0058 <entry><para><keycombo action="simul">&Ctrl;&Shift;<keycap>E</keycap></keycombo></para></entry>
0059 <entry><para>Go to next edit location in document.</para></entry>
0060 </row>
0061 <row>
0062 <entry><para><keycombo action="simul">&Alt;&Shift;&Up;</keycombo></para></entry>
0063 <entry><para>Move cursor to previous matching indent.</para></entry>
0064 </row>
0065 <row>
0066 <entry><para><keycombo action="simul">&Alt;&Shift;&Down;</keycombo></para></entry>
0067 <entry><para>Move cursor to previous matching indent.</para></entry>
0068 </row>
0069 <row>
0070 <entry><para><keycombo action="simul">&Ctrl;<keycap>6</keycap></keycombo></para></entry>
0071 <entry><para>Move to Matching Bracket.</para></entry>
0072 </row>
0073 <row>
0074 <entry><para>&PgUp;</para></entry>
0075 <entry><para>Move the cursor up one page.</para></entry>
0076 </row>
0077 <row>
0078 <entry><para>&PgDn;</para></entry>
0079 <entry><para>Move the cursor down one page.</para></entry>
0080 </row>
0081 <row>
0082 <entry><para>&Home;</para></entry>
0083 <entry><para>Move the cursor to the beginning of the line.</para></entry>
0084 </row>
0085 <row>
0086 <entry><para>&End;</para></entry>
0087 <entry><para>Move the cursor to the end of the line.</para></entry>
0088 </row>
0089 <row>
0090 <entry><para><keycombo action="simul">&Ctrl;&Home;</keycombo></para></entry>
0091 <entry><para>Move to Beginning of Document.</para></entry>
0092 </row>
0093 <row>
0094 <entry><para><keycombo action="simul">&Ctrl;&End;</keycombo></para></entry>
0095 <entry><para>Move to End of Document.</para></entry>
0096 </row>
0097 <row>
0098 <entry><para><keycombo action="simul">&Ctrl;&Up;</keycombo></para></entry>
0099 <entry><para>Scroll Line Up.</para></entry>
0100 </row>
0101 <row>
0102 <entry><para><keycombo action="simul">&Ctrl;&Down;</keycombo></para></entry>
0103 <entry><para>Scroll Line Down.</para></entry>
0104 </row>
0105 <row>
0106 <entry><para><keycombo action="simul">&Ctrl;&Right;</keycombo></para></entry>
0107 <entry><para>Move Word Right.</para></entry>
0108 </row>
0109 <row>
0110 <entry><para><keycombo action="simul">&Ctrl;&Left;</keycombo></para></entry>
0111 <entry><para>Move Word Left.</para></entry>
0112 </row>
0113 <row>
0114 <entry><para><keycombo action="simul">&Ctrl;&Shift;&Up;</keycombo></para></entry>
0115 <entry><para>Move Lines Up.</para></entry>
0116 </row>
0117 <row>
0118 <entry><para><keycombo action="simul">&Ctrl;&Shift;&Down;</keycombo></para></entry>
0119 <entry><para>Move Lines Down.</para></entry>
0120 </row>
0121 <row>
0122 <entry><para><keycombo action="simul">&Ctrl;<keycap>.</keycap></keycombo></para></entry>
0123 <entry><para>Duplicate Selected Lines Down.</para></entry>
0124 </row>
0125 <row>
0126 <entry><para><keycombo action="simul">&Ctrl;<keycap>B</keycap></keycombo></para></entry>
0127 <entry><para>Set a Bookmark.</para></entry>
0128 </row>
0129 <row>
0130 <entry><para><keycombo action="simul">&Alt;&PgUp;</keycombo></para></entry>
0131 <entry><para>Previous Bookmark.</para></entry>
0132 </row>
0133 <row>
0134 <entry><para><keycombo action="simul">&Alt;&PgDn;</keycombo></para></entry>
0135 <entry><para>Next Bookmark.</para></entry>
0136 </row>
0137 <row>
0138 <entry><para>&Del;</para></entry>
0139 <entry><para>Delete the character to the right of the cursor (or any selected
0140 text).</para></entry>
0141 </row>
0142 <row>
0143 <entry><para>&Backspace;</para></entry>
0144 <entry><para>Delete the character to the left of the cursor.</para></entry>
0145 </row>
0146 <row>
0147 <entry><para><keycombo action="simul">&Ctrl;&Del;</keycombo></para></entry>
0148 <entry><para>Delete Right Word.</para></entry>
0149 </row>
0150 <row>
0151 <entry><para><keycombo action="simul">&Ctrl;&Backspace;</keycombo></para></entry>
0152 <entry><para>Delete Left Word.</para></entry>
0153 </row>
0154 <row>
0155 <entry><para><keycombo action="simul">&Ctrl;<keycap>K</keycap></keycombo></para></entry>
0156 <entry><para>Delete Line.</para></entry>
0157 </row>
0158 <row>
0159 <entry><para><keycombo action="simul">&Shift;&Enter;</keycombo></para></entry>
0160 <entry><para>Insert newline including leading characters of the current line which are not letters or numbers.
0161 It is useful &eg; to write comments in the code: At the end of the line <quote>// some text</quote> press
0162 this shortcut and the next line starts already with <quote>// </quote>. So you do not have to enter the comment
0163 characters at the beginning of each new line with comments.</para></entry>
0164 </row>
0165 <row>
0166 <entry><para><keycombo action="simul">&Ctrl;&Shift;&Enter;</keycombo></para></entry>
0167 <entry><para>Create a new line below current line.</para></entry>
0168 </row>
0169 <row>
0170 <entry><para><keycombo action="simul">&Ctrl;&Alt;&Enter;</keycombo></para></entry>
0171 <entry><para>Create a new line above current line.</para></entry>
0172 </row>
0173 <row>
0174 <entry><para><keycombo action="simul">&Shift;&Left;</keycombo></para></entry>
0175 <entry><para>Mark text one character to the left.</para></entry>
0176 </row>
0177 <row>
0178 <entry><para><keycombo action="simul">&Shift;&Right;</keycombo></para></entry>
0179 <entry><para>Mark text one character to the right.</para></entry>
0180 </row>
0181 <row>
0182 <entry><para><keycombo
0183 action="simul">&Ctrl;<keycap>F</keycap></keycombo></para></entry>
0184 <entry><para><link linkend="edit-find">Find</link>.</para></entry>
0185 </row>
0186 <row>
0187 <entry><para><keycombo
0188 action="simul"><keycap>F3</keycap></keycombo></para></entry>
0189 <entry><para><link linkend="edit-find-next">Find Next</link>.</para></entry>
0190 </row>
0191 <row>
0192 <entry><para><keycombo
0193 action="simul">&Shift;<keycap>F3</keycap></keycombo></para></entry>
0194 <entry><para><link linkend="edit-find-previous">Find Previous</link>.</para></entry>
0195 </row>
0196 <row>
0197 <entry><para><keycombo
0198 action="simul">&Ctrl;<keycap>H</keycap></keycombo></para></entry>
0199 <entry><para><link linkend="edit-find-selected">Find Selected</link>.</para></entry>
0200 </row>
0201 <row>
0202 <entry><para><keycombo
0203 action="simul">&Ctrl;&Shift;<keycap>H</keycap></keycombo></para></entry>
0204 <entry><para><link linkend="edit-find-selected-backwards">Find Selected Backwards</link>.</para></entry>
0205 </row>
0206 <row>
0207 <entry><para><keycombo action="simul">&Ctrl;&Shift;&Right;</keycombo></para></entry>
0208 <entry><para>Select Word Right.</para></entry>
0209 </row>
0210 <row>
0211 <entry><para><keycombo action="simul">&Ctrl;&Shift;&Left;</keycombo></para></entry>
0212 <entry><para>Select Word Left.</para></entry>
0213 </row>
0214 <row>
0215 <entry><para><keycombo action="simul">&Shift;&Home;</keycombo></para></entry>
0216 <entry><para>Select to Beginning of Line.</para></entry>
0217 </row>
0218 <row>
0219 <entry><para><keycombo action="simul">&Shift;&End;</keycombo></para></entry>
0220 <entry><para>Select to End of Line.</para></entry>
0221 </row>
0222 <row>
0223 <entry><para><keycombo action="simul">&Shift;&Up;</keycombo></para></entry>
0224 <entry><para>Select to Previous Line.</para></entry>
0225 </row>
0226 <row>
0227 <entry><para><keycombo action="simul">&Shift;&Down;</keycombo></para></entry>
0228 <entry><para>Select to Next Line.</para></entry>
0229 </row>
0230 <row>
0231 <entry><para><keycombo action="simul">&Ctrl;&Shift;<keycap>6</keycap></keycombo></para></entry>
0232 <entry><para>Select to Matching Bracket.</para></entry>
0233 </row>
0234 <row>
0235 <entry><para><keycombo action="simul">&Ctrl;&Shift;&PgUp;</keycombo></para></entry>
0236 <entry><para>Select to Top of View.</para></entry>
0237 </row>
0238 <row>
0239 <entry><para><keycombo action="simul">&Ctrl;&Shift;&PgDn;</keycombo></para></entry>
0240 <entry><para>Select to Bottom of View.</para></entry>
0241 </row>
0242 <row>
0243 <entry><para><keycombo action="simul">&Shift;&PgUp;</keycombo></para></entry>
0244 <entry><para>Select Page Up.</para></entry>
0245 </row>
0246 <row>
0247 <entry><para><keycombo action="simul">&Shift;&PgDn;</keycombo></para></entry>
0248 <entry><para>Select Page Down.</para></entry>
0249 </row>
0250 <row>
0251 <entry><para><keycombo action="simul">&Ctrl;&Shift;&Home;</keycombo></para></entry>
0252 <entry><para>Select to Beginning of Document.</para></entry>
0253 </row>
0254 <row>
0255 <entry><para><keycombo action="simul">&Ctrl;&Shift;&End;</keycombo></para></entry>
0256 <entry><para>Select to End of Document.</para></entry>
0257 </row>
0258 <row>
0259 <entry><para><keycombo
0260 action="simul">&Ctrl;&Home;</keycombo></para></entry>
0261 <entry><para>Select All.</para></entry>
0262 </row>
0263 <row>
0264 <entry><para><keycombo
0265 action="simul">&Ctrl;&Shift;<keycap>A</keycap></keycombo></para></entry>
0266 <entry><para>Deselect.</para></entry>
0267 </row>
0268 <row>
0269 <entry><para><keycombo
0270 action="simul">&Ctrl;&Shift;<keycap>B</keycap></keycombo></para></entry>
0271 <entry><para>Block Selection Mode.</para></entry>
0272 </row>
0273 <row>
0274 <entry><para><keycombo
0275 action="simul">&Ctrl;<keycap>C</keycap></keycombo> / <keycombo
0276 action="simul">&Ctrl;&Ins;</keycombo></para></entry>
0277 <entry><para>Copy the marked text to the clipboard.</para></entry>
0278 </row>
0279 <row>
0280 <entry><para><keycombo
0281 action="simul">&Ctrl;<keycap>D</keycap></keycombo></para></entry>
0282 <entry><para>Comment.</para></entry>
0283 </row>
0284 <row>
0285 <entry><para><keycombo
0286 action="simul">&Ctrl;&Shift;<keycap>D</keycap></keycombo></para></entry>
0287 <entry><para>Uncomment.</para></entry>
0288 </row>
0289 <row>
0290 <entry><para><keycombo
0291 action="simul">&Ctrl;<keycap>G</keycap></keycombo></para></entry>
0292 <entry><para>Go to line...</para></entry>
0293 </row>
0294 <row>
0295 <entry><para><keycombo
0296 action="simul">&Ctrl;<keycap>I</keycap></keycombo></para></entry>
0297 <entry><para>Indent selection.</para></entry>
0298 </row>
0299 <row>
0300 <entry><para><keycombo
0301 action="simul">&Ctrl;&Shift;<keycap>I</keycap></keycombo></para></entry>
0302 <entry><para>Unindent selection.</para></entry>
0303 </row>
0304 <row>
0305 <entry><para><keycombo
0306 action="simul">&Ctrl;<keycap>J</keycap></keycombo></para></entry>
0307 <entry><para>Join Lines.</para></entry>
0308 </row>
0309 <row>
0310 <entry><para><keycombo
0311 action="simul">&Ctrl;<keycap>P</keycap></keycombo></para></entry>
0312 <entry><para><link linkend="file-print">Print</link>.</para></entry>
0313 </row>
0314 <row>
0315 <entry><para><keycombo
0316 action="simul">&Ctrl;<keycap>R</keycap></keycombo></para></entry>
0317 <entry><para><link linkend="edit-replace">Replace</link>.</para></entry>
0318 </row>
0319 <row>
0320 <entry><para><keycombo
0321 action="simul">&Ctrl;<keycap>S</keycap></keycombo></para></entry>
0322 <entry><para>Invokes the <link
0323 linkend="file-save"><guilabel>Save</guilabel></link> command.</para></entry>
0324 </row>
0325 <row>
0326 <entry><para><keycombo
0327 action="simul">&Ctrl;&Shift;<keycap>S</keycap></keycombo></para></entry>
0328 <entry><para>Save As.</para></entry>
0329 </row>
0330 <row>
0331 <entry><para><keycombo
0332 action="simul">&Ctrl;<keycap>U</keycap></keycombo></para></entry>
0333 <entry><para>Uppercase.</para></entry>
0334 </row>
0335 <row>
0336 <entry><para><keycombo
0337 action="simul">&Ctrl;&Shift;<keycap>U</keycap></keycombo></para></entry>
0338 <entry><para>Lowercase.</para></entry>
0339 </row>
0340 <row>
0341 <entry><para><keycombo
0342 action="simul">&Ctrl;&Alt;<keycap>U</keycap></keycombo></para></entry>
0343 <entry><para>Capitalize.</para></entry>
0344 </row>
0345 <row>
0346 <entry><para><keycombo
0347 action="simul">&Ctrl;<keycap>V</keycap></keycombo> / <keycombo
0348 action="simul">&Shift;&Ins;</keycombo></para></entry>
0349 <entry><para>Paste the clipboard text into line edit.</para></entry>
0350 </row>
0351 <row>
0352 <entry><para><keycombo
0353 action="simul">&Ctrl;<keycap>X</keycap></keycombo> / <keycombo
0354 action="simul">&Shift;&Ins;</keycombo></para></entry>
0355 <entry><para>Delete the marked text and copy it to the clipboard.
0356 </para></entry>
0357 </row>
0358 <row>
0359 <entry><para><keycombo
0360 action="simul">&Ctrl;<keycap>Z</keycap></keycombo></para></entry>
0361 <entry><para><link linkend="edit-undo">Undo</link>.</para></entry>
0362 </row>
0363 <row>
0364 <entry><para><keycombo
0365 action="simul">&Ctrl;&Shift;<keycap>Z</keycap></keycombo></para></entry>
0366 <entry><para><link linkend="edit-redo">Redo</link>.</para></entry>
0367 </row>
0368 <row>
0369 <entry><para><keycombo
0370 action="simul">&Ctrl;<keycap>-</keycap></keycombo></para></entry>
0371 <entry><para>Shrink Font.</para></entry>
0372 </row>
0373 <row>
0374 <entry><para><keycombo
0375 action="simul">&Ctrl;<keycap>+</keycap></keycombo><keycombo
0376 action="simul">&Ctrl;<keycap>=</keycap></keycombo></para></entry>
0377 <entry><para>Enlarge Font.</para></entry>
0378 </row>
0379 <row>
0380 <entry><para><keycombo
0381 action="simul">&Ctrl;&Shift;<keycap>-</keycap></keycombo></para></entry>
0382 <entry><para>Fold Toplevel Nodes.</para></entry>
0383 </row>
0384 <row>
0385 <entry><para><keycombo
0386 action="simul">&Ctrl;&Shift;<keycap>+</keycap></keycombo></para></entry>
0387 <entry><para>Unfold Toplevel Nodes.</para></entry>
0388 </row>
0389 <row>
0390 <entry><para><keycombo
0391 action="simul">&Ctrl;&Space;</keycombo></para></entry>
0392 <entry><para>Invoke Code Completion.</para></entry>
0393 </row>
0394 <row>
0395 <entry><para><keycap>F5</keycap></para></entry>
0396 <entry><para><link linkend="file-reload"> Reload</link>.</para></entry>
0397 </row>
0398 <row>
0399 <entry><para><keycap>F6</keycap></para></entry>
0400 <entry><para>Show/Hide Icon Border.</para></entry>
0401 </row>
0402 <row>
0403 <entry><para><keycap>F7</keycap></para></entry>
0404 <entry><para>Switch to Command Line.</para></entry>
0405 </row>
0406 <row>
0407 <entry><para><keycap>F9</keycap></para></entry>
0408 <entry><para>Show/Hide Folding Markers.</para></entry>
0409 </row>
0410 <row>
0411 <entry><para><keycap>F10</keycap></para></entry>
0412 <entry><para>Dynamic Word Wrap.</para></entry>
0413 </row>
0414 <row>
0415 <entry><para><keycap>F11</keycap></para></entry>
0416 <entry><para>Show/Hide Line Numbers.</para></entry>
0417 </row>
0418 <row>
0419 <entry><para><keycombo action="simul">&Ctrl;<keycap>T</keycap></keycombo></para></entry>
0420 <entry><para>Transpose Characters.</para></entry>
0421 </row>
0422 <row>
0423 <entry><para><keycombo action="simul">&Ctrl;&Shift;<keycap>O</keycap></keycombo></para></entry>
0424 <entry><para>Automatic Spell Checking.</para></entry>
0425 </row>
0426 <row>
0427 <entry><para><keycombo action="simul">&Ctrl;&Shift;<keycap>V</keycap></keycombo></para></entry>
0428 <entry><para>Switch to Next Input Mode.</para></entry>
0429 </row>
0430 <row>
0431 <entry><para><keycombo action="simul">&Ctrl;<keycap>8</keycap></keycombo></para></entry>
0432 <entry><para>Reuse Word Above.</para></entry>
0433 </row>
0434 <row>
0435 <entry><para><keycombo action="simul">&Ctrl;<keycap>9</keycap></keycombo></para></entry>
0436 <entry><para>Reuse Word Below.</para></entry>
0437 </row>
0438 <row>
0439 <entry><para><keycombo action="simul">&Ctrl;&Alt;<keycap>#</keycap></keycombo></para></entry>
0440 <entry><para>Expand Abbreviation.</para></entry>
0441 </row>
0442
0443 <row>
0444 <entry><para><keycombo action="simul">&Ctrl;&Alt;&Up;</keycombo></para></entry>
0445 <entry><para>Add a cursor above current cursor.</para></entry>
0446 </row>
0447 <row>
0448 <entry><para><keycombo action="simul">&Ctrl;&Alt;&Down;</keycombo></para></entry>
0449 <entry><para>Add a cursor below current cursor.</para></entry>
0450 </row>
0451 <row>
0452 <entry><para><keycombo action="simul">&Shift;&Alt;<keycap>I</keycap></keycombo></para></entry>
0453 <entry><para>Create a cursor at the end of each line in selection.</para></entry>
0454 </row>
0455 <row>
0456 <entry><para><keycombo action="simul">&Alt;<keycap>J</keycap></keycombo></para></entry>
0457 <entry><para>Find next occurrence of the word under cursor and select it.</para></entry>
0458 </row>
0459 <row>
0460 <entry><para><keycombo action="simul">&Ctrl;&Alt;&Shift;<keycap>J</keycap></keycombo></para></entry>
0461 <entry><para>Find all occurrences of the word under cursor and select them.</para></entry>
0462 </row>
0463
0464 </tbody>
0465 </tgroup>
0466 </informaltable>
0467 </sect1>
0468 </chapter>