Changeset View
Changeset View
Standalone View
Standalone View
doc/katepart/fundamentals.docbook
Show All 10 Lines | |||||
11 | 11 | | |||
12 | <para> | 12 | <para> | ||
13 | &katepart; uses the &kde; Drag and Drop protocol. Files may be dragged and | 13 | &katepart; uses the &kde; Drag and Drop protocol. Files may be dragged and | ||
14 | dropped onto &katepart; from the Desktop, the filemanager &dolphin;, or some | 14 | dropped onto &katepart; from the Desktop, the filemanager &dolphin;, or some | ||
15 | remote &FTP; site opened in one of &dolphin;'s windows. | 15 | remote &FTP; site opened in one of &dolphin;'s windows. | ||
16 | </para> | 16 | </para> | ||
17 | </sect1> | 17 | </sect1> | ||
18 | 18 | | |||
19 | <sect1 id="command-line-options"> | | |||
20 | <title>Command Line Options</title> | | |||
21 | | ||||
22 | <para> | | |||
23 | Though &kwrite; may most often be started from the &kde; program menu, or | | |||
24 | a desktop icon, it can also be opened at the command line prompt of a | | |||
25 | terminal window. There are a few useful options that are available when | | |||
26 | doing this. | | |||
27 | </para> | | |||
28 | | ||||
29 | <para>Many other applications that use &katepart; offer similar command line | | |||
30 | options.</para> | | |||
31 | | ||||
32 | <sect2 id="specify-a-file"> | | |||
33 | <title>Specify a File</title> | | |||
34 | | ||||
35 | <para>By specifying the path and name of a particular file the user can | | |||
36 | have &kwrite; open (or create) that file immediately upon startup. This | | |||
37 | option might look something like the following:</para> | | |||
38 | | ||||
39 | <informalexample><screen> | | |||
40 | <prompt>%</prompt> <userinput><command>kwrite</command> | | |||
41 | <option><replaceable>/home/myhome/docs/myfile.txt</replaceable></option> | | |||
42 | </userinput> | | |||
43 | </screen> | | |||
44 | </informalexample> | | |||
45 | </sect2> | | |||
46 | <sect2 id="editing-files-on-the-internet"> | | |||
47 | <title>Specify a file on the Internet</title> | | |||
48 | | ||||
49 | <para>The above-mentioned method could even be used to open files on the | | |||
50 | Internet (if the user has an active connection at the time.) An example of | | |||
51 | this might look like the following:</para> | | |||
52 | | ||||
53 | <informalexample><screen> | | |||
54 | <prompt>%</prompt> <userinput><command>kwrite</command> | | |||
55 | <option><replaceable>ftp://ftp.kde.org/pub/kde/README</replaceable> | | |||
56 | </option></userinput> | | |||
57 | </screen> | | |||
58 | </informalexample> | | |||
59 | | ||||
60 | </sect2> | | |||
61 | | ||||
62 | <sect2 id="other-command-line-options"> | | |||
63 | <title>Other Command Line Options</title> | | |||
64 | | ||||
65 | <para>The following command line help options are available</para> | | |||
66 | | ||||
67 | <variablelist> | | |||
68 | | ||||
69 | <varlistentry> | | |||
70 | <term><userinput><command>kwrite</command> | | |||
71 | <option>--help</option></userinput></term> | | |||
72 | <listitem><para>This lists the most basic options available at the command | | |||
73 | line.</para></listitem> | | |||
74 | </varlistentry> | | |||
75 | | ||||
76 | <varlistentry> | | |||
77 | <term><userinput><command>kwrite</command> | | |||
78 | <option>--author</option></userinput></term> | | |||
79 | <listitem><para>Lists &kwrite;'s authors in the terminal | | |||
80 | window</para></listitem> | | |||
81 | </varlistentry> | | |||
82 | <varlistentry> | | |||
83 | | ||||
84 | <term><userinput><command>kwrite</command> | | |||
85 | <option>-v</option>, <option>--version</option></userinput></term> | | |||
86 | <listitem><para>Lists version information for the application.</para></listitem> | | |||
87 | </varlistentry> | | |||
88 | | ||||
89 | <varlistentry> | | |||
90 | <term><userinput><command>&kwrite;</command> | | |||
91 | <option>--license</option></userinput></term> | | |||
92 | <listitem> | | |||
93 | <para>Shows license information.</para> | | |||
94 | </listitem> | | |||
95 | </varlistentry> | | |||
96 | | ||||
97 | <varlistentry><!--FIXME usecase? --> | | |||
98 | <term><userinput><command>kwrite</command> | | |||
99 | <option>--desktopfile</option> <parameter>filename</parameter></userinput></term> | | |||
100 | <listitem><para>The base file name of the desktop entry for this application.</para></listitem> | | |||
101 | </varlistentry> | | |||
102 | | ||||
103 | <varlistentry> | | |||
104 | <term><userinput><command>kwrite</command> | | |||
105 | <option>-e</option>, <option>--encoding</option> <parameter>encoding</parameter> | | |||
106 | <parameter>&URL;</parameter></userinput></term> | | |||
107 | <listitem><para>Causes &kwrite; to use the specified encoding for the document. | | |||
108 | </para></listitem> | | |||
109 | </varlistentry> | | |||
110 | | ||||
111 | <varlistentry> | | |||
112 | <term><userinput><command>kwrite</command> | | |||
113 | <option>-l</option>, <option>--line</option> <parameter>line</parameter> | | |||
114 | <parameter>&URL;</parameter></userinput></term> | | |||
115 | <listitem><para>Navigate to the specified line after opening the document. | | |||
116 | </para></listitem> | | |||
117 | </varlistentry> | | |||
118 | | ||||
119 | <varlistentry> | | |||
120 | <term><userinput><command>kwrite</command> | | |||
121 | <option>-c</option>, <option>--column</option> <parameter>column</parameter> | | |||
122 | <parameter>&URL;</parameter></userinput></term> | | |||
123 | <listitem><para>Navigate to the specified column after opening the document. | | |||
124 | </para></listitem> | | |||
125 | </varlistentry> | | |||
126 | | ||||
127 | <varlistentry> | | |||
128 | <term><userinput><command>kwrite</command> | | |||
129 | <option>-i</option>, <option>--stdin</option></userinput></term> | | |||
130 | <listitem><para>Causes &kwrite; to read the document content from STDIN. This | | |||
131 | is similar to the common option <option>-</option> used in many command line | | |||
132 | programs, and allows you to pipe command output into &kwrite;.</para></listitem> | | |||
133 | </varlistentry> | | |||
134 | | ||||
135 | </variablelist> | | |||
136 | </sect2> | | |||
137 | </sect1> | | |||
138 | | ||||
139 | <sect1 id="keybindings"> <!--60 shortcuts here and 4.4.63 has 89 lueck | 19 | <sect1 id="keybindings"> <!--60 shortcuts here and 4.4.63 has 89 lueck | ||
140 | missing ctrl+6,7,8,9,T,Home,End | 20 | missing ctrl+6,7,8,9,T,Home,End | ||
141 | ctrl+shift+O,Home,End,PgUp,Left,Right,PgDown | 21 | ctrl+shift+O,Home,End,PgUp,Left,Right,PgDown | ||
142 | Shift+Home | 22 | Shift+Home | ||
143 | --> | 23 | --> | ||
144 | <title>Shortcuts</title> | 24 | <title>Shortcuts</title> | ||
145 | 25 | | |||
146 | <para>Many of the shortcuts are configurable by way of the <link | 26 | <para>Many of the shortcuts are configurable by way of the <link | ||
▲ Show 20 Lines • Show All 320 Lines • Show Last 20 Lines |