dwww Home | Show directory contents | Find package

<FILENAME filename="index.html"><html><head><title>Web Shortcuts</title><link rel="stylesheet" type="text/css" href="help:/kdoctools5-common/kde-default.css"><link rel="stylesheet" type="text/css" href="help:/kdoctools5-common/kde-docs.css"><link rel="stylesheet" type="text/css" href="help:/kdoctools5-common/kde-localised.css"><meta name="generator" content="DocBook XSL Stylesheets Vsnapshot"><meta name="keywords" content="KDE, Systemsettings, enhanced browsing, web shortcuts, browsing"><link rel="home" href="index.html" title="Web Shortcuts"><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><meta name="GENERATOR" content="KDE XSL Stylesheet V1.14 using libxslt"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div id="content"><div id="header"><div id="header_content"><div id="header_left"><div id="header_right"><img src="help:/kdoctools5-common/top-kde.jpg" width="36" height="34"> Web Shortcuts</div></div></div></div><div class="navCenter"><table class="navigation"><tr><td class="prevCell"></td><td class="upCell"> </td><td class="nextCell"></td></tr></table></div><div id="contentBody"><div lang="en" class="article"><div class="titlepage"><div><div><h2 class="title"><a name="ebrowsing"></a>Web Shortcuts</h2></div><div><div class="authorgroup"><p class="author"><span class="firstname">Krishna</span> <span class="surname">Tateneni</span> <code class="email">&lt;tateneni@pluto.njcc.com&gt;</code></p><p class="author"><span class="firstname">Yves</span> <span class="surname">Arrouye</span> <code class="email">&lt;yves@realnames.ca&gt;</code></p></div></div><div>Revision <span class="releaseinfo">Frameworks 5.29 (<span class="date">2016-11-10</span>)</span></div></div><hr></div><div class="toc"><p><b>Table of Contents</b></p><dl class="toc"><dt><span class="sect1"><a href="index.html#ebrowse">Web Shortcuts</a></span></dt><dd><dl><dt><span class="sect2"><a href="index.html#ebrowse-intro">Introduction</a></span></dt><dt><span class="sect2"><a href="index.html#ebrowse-use">Web Search Keywords</a></span></dt></dl></dd></dl></div><div class="sect1"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a name="ebrowse"></a>Web Shortcuts</h2></div></div></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="ebrowse-intro"></a>Introduction</h3></div></div></div><p><span class="application">Konqueror</span> offers some features to enhance your browsing
experience. One such feature is <span class="emphasis"><em>Web Shortcuts</em></span>.</p><p>You may already have noticed that <span class="orgname">KDE</span> is very Internet friendly.
For example, you can click on the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guimenuitem">Run</span></span> menu
item or type the keyboard shortcut assigned to that command (<span class="keycap"><strong>Alt</strong></span>+<span class="keycap"><strong>F2</strong></span> or <span class="keycap"><strong>Alt</strong></span>+<span class="keysym">Space</span>,
unless you have changed it) and type in a <acronym class="acronym">URI</acronym>.
<a href="#ftn.idm40" class="footnote" name="idm40"><sup class="footnote">[1]</sup></a></p><p>Web shortcuts, on the other hand, let you come up with new pseudo
<acronym class="acronym">URL</acronym> schemes, or shortcuts, that basically let you
<span class="emphasis"><em>parameterize</em></span> commonly used
<acronym class="acronym">URI</acronym>s. For example, if you like the Google search
engine, you can configure <span class="orgname">KDE</span> so that a pseudo <acronym class="acronym">URL</acronym>
scheme like <span class="emphasis"><em>gg</em></span> will trigger a search on
Google. This way, typing <strong class="userinput"><code>gg:<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="replaceable"><em class="replaceable"><code>my
query</code></em></span></code></strong> will search for <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="replaceable"><em class="replaceable"><code>my
query</code></em></span> on Google.</p><div class="note" style="margin-left: 0.5in; margin-right: 0.5in;"><h3 class="title">Note</h3><p>One can see why we call these pseudo <acronym class="acronym">URL</acronym>
schemes. They are used like a <acronym class="acronym">URL</acronym> scheme, but the
input is not properly <acronym class="acronym">URL</acronym> encoded, so one will type
<strong class="userinput"><code>google:kde apps</code></strong> and not
<strong class="userinput"><code>google:kde+apps</code></strong>.</p></div><p>You can use web
shortcuts wherever you would normally use
<acronym class="acronym">URI</acronym>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.</p></div><div class="sect2"><div class="titlepage"><div><div><h3 class="title"><a name="ebrowse-use"></a>Web Search Keywords</h3></div></div></div><p>The descriptive names of defined web shortcuts are shown in a
list box. As with other lists in <span class="orgname">KDE</span>, you can click on a column
heading to toggle the sort order between ascending and
descending, and you can resize the columns.</p><p>At the bottom of the list the option <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Enable Web search keywords</span></span>
has to be checked to enable this feature. Use the buttons on the right to 
create, modify or delete shortcuts.</p><p>If <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Use preferred keywords only</span></span> 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.
</p><p>Below the list you find two additional options:</p><div class="variablelist"><dl class="variablelist"><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Default Web search keyword:</span></span></span></dt><dd><p>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 <acronym class="acronym">URL</acronym>. 
To disable this feature select <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">None</span></span> from the list.
</p></dd><dt><span class="term"><span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Keyword delimiter:</span></span></span></dt><dd><p>Choose the delimiter that separates the keyword from the phrase or word to 
be searched.</p></dd></dl></div><p>If you double-click on a specific entry in the list of defined
search providers or click the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guibutton">Change...</span></span> 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 <acronym class="acronym">URI</acronym> which is used, as well as the
associated shortcuts which you can type anywhere in <span class="orgname">KDE</span> where
<acronym class="acronym">URI</acronym>s are expected. A given search provider can have
multiple shortcuts, each separated by a comma.</p><p> 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.</p><p>You can change the contents of either the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Shortcut 
URL:</span></span> or the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Shortcuts:</span></span> text box.
Click <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guibutton">OK</span></span> to save your changes or
<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guibutton">Cancel</span></span> to exit the dialog with no
changes.</p><p>If you examine the contents of the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="guiitem"><span class="guilabel">Shortcut
URL:</span></span> text box, you will find that most, if not all of the
entries have a <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="option"><code class="option">\{@}</code></span> 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 <acronym class="acronym">URL</acronym>, click on the button at the right of the text box.
Let's consider some examples to clarify how to use web shortcuts.</p><p>Suppose that the <acronym class="acronym">URI</acronym> is
<strong class="userinput"><code>https://www.google.com/search?q=\{@}</code></strong>, and
<strong class="userinput"><code>gg</code></strong> is a shortcut to this
<acronym class="acronym">URI</acronym>. Then, typing
<strong class="userinput"><code>gg:<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="replaceable"><em class="replaceable"><code>alpha</code></em></span></code></strong> is
equivalent to
<strong class="userinput"><code>https://www.google.com/search?q=<span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="replaceable"><em class="replaceable"><code>alpha</code></em></span></code></strong>.
You could type anything after the <strong class="userinput"><code>:</code></strong> character;
whatever you have typed simply replaces the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="option"><code class="option">\{@}</code></span>
characters, after being converted to the appropriate character set for
the search provider and then properly
<acronym class="acronym">URL</acronym>-encoded. Only the <span xmlns:doc="http://nwalsh.com/xsl/documentation/1.0" class="option"><code class="option">\{@}</code></span> part of
the search <acronym class="acronym">URI</acronym> is touched, the rest of it is
supposed to be properly <acronym class="acronym">URL</acronym>-encoded already and is
left as is.</p><p>You can also have shortcuts without parameters. Suppose the
<acronym class="acronym">URI</acronym> was
<span class="emphasis"><em>file:/home/me/mydocs/calligra/words</em></span> and the
shortcut was <span class="emphasis"><em>mywords</em></span>. Then, typing
<strong class="userinput"><code>mywords:</code></strong> is the same as typing the complete
<acronym class="acronym">URI</acronym>. 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.</p><p>By now, you will have understood that even though these shortcuts
are called web shortcuts, they really are shortcuts to parameterized
<acronym class="acronym">URI</acronym>s, which can point not only to web sites like
search engines but also to anything else that can be pointed to by a
<acronym class="acronym">URI</acronym>. Web shortcuts are a very powerful feature of
navigation in <span class="orgname">KDE</span>.</p></div></div><div class="footnotes"><br><hr style="width:100; text-align:left;margin-left: 0"><div id="ftn.idm40" class="footnote"><p><a href="#idm40" class="para"><sup class="para">[1] </sup></a>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, <abbr class="abbrev">etc.</abbr></p></div></div></div></div><div id="footer"><div class="navCenter"><table class="navigation"><tr><td class="prevCell"></td><td class="upCell"> </td><td class="nextCell"></td></tr><tr><td class="prevCell"> </td><td class="upCell"> </td><td class="nextCell"> </td></tr></table></div><div id="footer_text">Would you like to make a comment or contribute an update to this page?<br>Send feedback to the <a href="mailto:kde-doc-english@kde.org" class="footer_email">KDE Docs Team</a></div></div></div></body></html></FILENAME>

Generated by dwww version 1.15 on Sat May 18 12:44:27 CEST 2024.