<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"><tateneni@pluto.njcc.com></code></p><p class="author"><span class="firstname">Yves</span> <span class="surname">Arrouye</span> <code class="email"><yves@realnames.ca></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.