Warning, /frameworks/kio/docs/kcontrol5/webshortcuts/index.docbook is written in an unsupported language. File is not indexed.

 <?xml version="1.0" ?>
 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN"
 "dtd/kdedbx45.dtd" [
 <!ENTITY % addindex "IGNORE">
 <!ENTITY % English "INCLUDE" > <!-- change language only here -->
 ]>
 
 <article id="ebrowsing" lang="&language;">
 <articleinfo>
 <title>Web Shortcuts</title>
 <authorgroup>
 <author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author>
 <author>&Yves.Arrouye; &Yves.Arrouye.mail;</author>
 <!-- TRANS:ROLES_OF_TRANSLATORS -->
 </authorgroup>
 
 <date>2016-11-10</date>
 <releaseinfo>Frameworks 5.29</releaseinfo>
 
 <keywordset>
 <keyword>KDE</keyword>
 <keyword>Systemsettings</keyword>
 <keyword>enhanced browsing</keyword>
 <keyword>web shortcuts</keyword>
 <keyword>browsing</keyword>
 </keywordset>
 
 </articleinfo>
 <sect1 id="ebrowse">
 
 <title>Web Shortcuts</title>
 
 <sect2 id="ebrowse-intro">
 
 <title>Introduction</title>
 
 <para>&konqueror; offers some features to enhance your browsing
 experience. One such feature is <emphasis>Web Shortcuts</emphasis>.</para>
 
 <para>You may already have noticed that &kde; is very Internet friendly.
 For example, you can click on the <guimenuitem>Run</guimenuitem> menu
 item or type the keyboard shortcut assigned to that command (<keycombo
 action="simul">&Alt;<keycap>F2</keycap></keycombo> or <keycombo
 action="simul">&Alt;&Space;</keycombo>,
 unless you have changed it) and type in a &URI;.
 <footnote><para>Uniform Resource Identifier. A standardized way of
 referring to a resource such as a file on your computer, a World Wide
 Web address, an email address, &etc;</para></footnote></para>
 
 <para>Web shortcuts, on the other hand, let you come up with new pseudo
 &URL; schemes, or shortcuts, that basically let you
 <emphasis>parameterize</emphasis> commonly used
 &URI;s. For example, if you like the Google search
 engine, you can configure &kde; so that a pseudo &URL;
 scheme like <emphasis>gg</emphasis> will trigger a search on
 Google. This way, typing <userinput>gg:<replaceable>my
 query</replaceable></userinput> will search for <replaceable>my
 query</replaceable> on Google.</para>
 
 <note><para>One can see why we call these pseudo &URL;
 schemes. They are used like a &URL; scheme, but the
 input is not properly &URL; encoded, so one will type
 <userinput>google:kde apps</userinput> and not
 <userinput>google:kde+apps</userinput>.</para></note>
 
 <para>You can use web
 shortcuts wherever you would normally use
 &URI;s. Shortcuts for several search engines should
 already be configured on your system, but you can add new keywords, and
 change or delete existing ones in this module.</para>
 
 </sect2>
 
 <sect2 id="ebrowse-use">
 
 <title>Web Search Keywords</title>
 
 <para>The descriptive names of defined web shortcuts are shown in a
 list box. As with other lists in &kde;, you can click on a column
 heading to toggle the sort order between ascending and
 descending, and you can resize the columns.</para>
 
 <para>At the bottom of the list the option <guilabel>Enable Web search keywords</guilabel>
 has to be checked to enable this feature. Use the buttons on the right to 
 create, modify or delete shortcuts.</para>
 
 <para>If <guilabel>Use preferred keywords only</guilabel> is checked, only
 keywords marked as preferred in the second column of the list
 are used in places where only a few select 
 shortcuts can be shown at one time.
 </para>
  
 <para>Below the list you find two additional options:</para>
 <variablelist>
 <varlistentry><term><guilabel>Default Web search keyword:</guilabel></term>
 <listitem>
 <para>Select the search engine to use for input boxes that provide automatic 
 lookup services when you type in normal words and phrases instead of a &URL;. 
 To disable this feature select <guilabel>None</guilabel> from the list.
 </para></listitem>
 </varlistentry>
 <varlistentry><term><guilabel>Keyword delimiter:</guilabel></term>
 <listitem>
 <para>Choose the delimiter that separates the keyword from the phrase or word to 
 be searched.</para></listitem>
 </varlistentry>
 </variablelist>
 
 <para>If you double-click on a specific entry in the list of defined
 search providers or click the <guibutton>Change...</guibutton> button,
 the details for that entry are shown in a popup
 dialog.  In addition to the descriptive name for the item, you can
 also see the &URI; which is used, as well as the
 associated shortcuts which you can type anywhere in &kde; where
 &URI;s are expected. A given search provider can have
 multiple shortcuts, each separated by a comma.</para>
 
 <para> The text boxes are used not only for displaying information
 about an item in the list of web shortcuts, but also for modifying or
 adding new items.</para>
 
 <para>You can change the contents of either the <guilabel>Shortcut 
 URL:</guilabel> or the <guilabel>Shortcuts:</guilabel> text box.
 Click <guibutton>OK</guibutton> to save your changes or
 <guibutton>Cancel</guibutton> to exit the dialog with no
 changes.</para>
 
 <para>If you examine the contents of the <guilabel>Shortcut
 URL:</guilabel> text box, you will find that most, if not all of the
 entries have a <option>\{@}</option> in them. This sequence of four
 characters acts as a parameter, which is to say that they are replaced
 by whatever you happen to type after the colon character that is
 between a shortcut and its parameter. To add this query placeholder 
 to a shortcut &URL;, click on the button at the right of the text box.
 Let's consider some examples to clarify how to use web shortcuts.</para>
 
 <para>Suppose that the &URI; is
 <userinput>https://www.google.com/search?q=\{@}</userinput>, and
 <userinput>gg</userinput> is a shortcut to this
 &URI;. Then, typing
 <userinput>gg:<replaceable>alpha</replaceable></userinput> is
 equivalent to
 <userinput>https://www.google.com/search?q=<replaceable>alpha</replaceable></userinput>.
 You could type anything after the <userinput>:</userinput> character;
 whatever you have typed simply replaces the <option>\{@}</option>
 characters, after being converted to the appropriate character set for
 the search provider and then properly
 &URL;-encoded. Only the <option>\{@}</option> part of
 the search &URI; is touched, the rest of it is
 supposed to be properly &URL;-encoded already and is
 left as is.</para>
 
 <para>You can also have shortcuts without parameters. Suppose the
 &URI; was
 <emphasis>file:/home/me/mydocs/calligra/words</emphasis> and the
 shortcut was <emphasis>mywords</emphasis>. Then, typing
 <userinput>mywords:</userinput> is the same as typing the complete
 &URI;. Note that there is nothing after the colon
 when typing the shortcut, but the colon is still required in order for
 the shortcut to be recognized as such.</para>
 
 <para>By now, you will have understood that even though these shortcuts
 are called web shortcuts, they really are shortcuts to parameterized
 &URI;s, which can point not only to web sites like
 search engines but also to anything else that can be pointed to by a
 &URI;. Web shortcuts are a very powerful feature of
 navigation in &kde;.</para>
 
 </sect2>
 
 </sect1>
 
 </article>