<?xml version="1.0" ?> <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.2-Based Variant V1.1//EN" "dtd/kdex.dtd" [ <!ENTITY % addindex "IGNORE"> <!ENTITY % British-English "INCLUDE" > <!-- change language only here --> ]> <article lang="&language;"> <articleinfo> <authorgroup> <author >&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> <author >&Yves.Arrouye; &Yves.Arrouye.mail;</author> <othercredit role="translator" ><firstname >John</firstname ><surname >Knight</surname ><affiliation ><address ><email >anarchist_tomato@herzeleid.net</email ></address ></affiliation ><contrib >Conversion to British English</contrib ></othercredit > </authorgroup> <date >2002-10-16</date> <releaseinfo >3.1</releaseinfo> <keywordset> <keyword >KDE</keyword> <keyword >KControl</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" ><keycap >Alt</keycap ><keycap >F2</keycap ></keycombo >, unless you have changed it) and type in a <acronym >URI</acronym >. <footnote ><para >Uniform Resource Identifier. A standard way of referring to a resource such as a file on your computer, a World Wide Web address, an email address, <abbrev >etc...</abbrev >.</para ></footnote ></para> <para >Web shortcuts, on the other hand, let you come up with new pseudo <acronym >URL</acronym > schemes, or shortcuts, that basically let you <emphasis >parameterise</emphasis > commonly used <acronym >URI</acronym >s. For example, if you like the Google search engine, you can configure KDE so that a pseudo <acronym >URL</acronym > 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 <acronym >URL</acronym > schemes. They are used like a <acronym >URL</acronym > scheme, but the input is not properly <acronym >URL</acronym > 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 <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 the enhanced browsing control module. </para> </sect2> <sect2 id="ebrowse-use"> <title >Use</title> <para >There is a single tab in this control module. The title of the tab is <guilabel >Keywords</guilabel >. This tab features two main boxes, one for Internet Keywords and one for web shortcuts.</para> <sect3 id="ebrowse-srch-use"> <title >Web Shortcuts</title> <para >The descriptive names of defined web shortcuts are shown in a listbox. 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 >If you double-click on a specific entry in the list of defined search providers, the details for that entry are shown in a popup dialogue. In addition to the descriptive name for the item, you can also see the <acronym >URI</acronym > which is used, as well as the associated shortcuts which you can type anywhere in &kde; where <acronym >URI</acronym >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 >Search URI</guilabel > or the <guilabel >URI Shortcuts</guilabel > text box. Click <guibutton >OK</guibutton > to save your changes or <guibutton >Cancel</guibutton > to exit the dialogue with no changes.</para> <para >If you examine the contents of the <guilabel >Search URI</guilabel > text box, you will find that most, if not all of the entries have a <option >\{@}</option > in them. This sequence of two 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. Let's consider some examples to clarify this idea.</para> <para >Suppose that the <acronym >URI</acronym > is <userinput >http://www.google.com/search?q=\{@}</userinput >, and <userinput >gg</userinput > is a shortcut to this <acronym >URI</acronym >. Then, typing <userinput >gg:<replaceable >alpha</replaceable ></userinput > is equivalent to <userinput >http://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 <acronym >URL</acronym >-encoded. Only the <option >\{@}</option > part of the search <acronym >URI</acronym > is touched, the rest of it is supposed to be properly <acronym >URL</acronym >-encoded already and is left as is.</para> <para >You can also have shortcuts without parameters. Suppose the <acronym >URI</acronym > was <emphasis >file:/home/me/mydocs/kofficefiles/kword</emphasis > and the shortcut was <emphasis >mykword</emphasis >. Then, typing <userinput >mykword:</userinput > is the same as typing the complete <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 recognised as such.</para> <para >By now, you will have understood that even though these shortcuts are called web shortcuts, they really are shortcuts to parameterised <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 >URI</acronym >. Web shortcuts are a very powerful feature of navigation in &kde;.</para> </sect3> </sect2> </sect1> </article>