Git commit 825a28f3d28cc282559145ffde9fd879f7f26be5 by Burkhard Lück. Committed on 13/11/2016 at 00:25. Pushed by lueck into branch 'master'.
rm the docbooks for RR 129380 D +0 -2 doc/kcontrol/cache/CMakeLists.txt D +0 -66 doc/kcontrol/cache/index.docbook D +0 -2 doc/kcontrol/cookies/CMakeLists.txt D +0 -208 doc/kcontrol/cookies/index.docbook D +0 -2 doc/kcontrol/filetypes/CMakeLists.txt D +0 -367 doc/kcontrol/filetypes/index.docbook D +0 -2 doc/kcontrol/netpref/CMakeLists.txt D +0 -109 doc/kcontrol/netpref/index.docbook D +0 -2 doc/kcontrol/proxy/CMakeLists.txt D +0 -209 doc/kcontrol/proxy/index.docbook D +0 -2 doc/kcontrol/smb/CMakeLists.txt D +0 -104 doc/kcontrol/smb/index.docbook D +0 -2 doc/kcontrol/useragent/CMakeLists.txt D +0 -110 doc/kcontrol/useragent/index.docbook D +0 -2 doc/kcontrol/webshortcuts/CMakeLists.txt D +0 -174 doc/kcontrol/webshortcuts/index.docbook http://commits.kde.org/plasma-desktop/825a28f3d28cc282559145ffde9fd879f7f26be5 diff --git a/doc/kcontrol/cache/CMakeLists.txt b/doc/kcontrol/cache/CMakeLists.txt deleted file mode 100644 index 7728027..0000000 --- a/doc/kcontrol/cache/CMakeLists.txt +++ /dev/null @@ -1,2 +0,0 @@ -########### install files ############### -kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/cache) diff --git a/doc/kcontrol/cache/index.docbook b/doc/kcontrol/cache/index.docbook deleted file mode 100644 index 3661f28..0000000 --- a/doc/kcontrol/cache/index.docbook +++ /dev/null @@ -1,66 +0,0 @@ -<?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 --> -]> -<!--FIXME code in frameworks/kio - docbook in plasma-desktop? --> -<article id="cache" lang="&language;"> -<title>Cache</title> -<articleinfo> - -<authorgroup> -<author><firstname>Lauri</firstname><surname>Watts</surname></author> - -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> - -<date>2015-04-09</date> -<releaseinfo>Plasma 5.3</releaseinfo> - -<keywordset> -<keyword>KDE</keyword> -<keyword>Systemsettings</keyword> -<keyword>Konqueror</keyword> -<keyword>Cache</keyword> -</keywordset> -</articleinfo> - -<para>This module allows you to control the size of the local cache -folder used by &konqueror;. Note that each user account on your -computer has a separate cache folder, and this folder is not -shared with other web browsers such as Firefox.</para> - -<para>Storing local copies of web pages that you have visited allows -&konqueror; to quickly load their contents on subsequent visits. It -will only be necessary to reload the contents from the original site -if they have changed since your last visit, or if you click the reload -button in &konqueror;.</para> - -<para>If you really do not want any of the web pages you visit to be -stored on your computer, you can disable &konqueror;'s disk cache by -clearing the checkbox labeled <guilabel>Use cache</guilabel>.</para> - -<para>You can set here how aggressively &konqueror; keeps the cache up -to date. <guilabel>Keep cache in sync</guilabel> means that &konqueror; -will hit the cache for all objects, downloading them if they are not -there, and then display the item from the cache. <guilabel>Use cache -whenever possible</guilabel> means that &konqueror; will try the cache, -and if an object is not there, it will directly download it for display. -<guilabel>Offline browsing mode</guilabel> means that &konqueror; will -try the cache, and if an object is not there, it will not attempt to -download it from the Internet.</para> - -<para>You can control the size of the cache by typing a number into the -text box labeled <guilabel>Disk cache size</guilabel>. This is the -average amount of space in kilobytes that the cache folder is allowed -to use. When the cache grows too large, &konqueror; will delete older -files to reduce the size of the cache folder.</para> - -<para>This is however, only an average, and during a browsing session -the cache could become substantially larger.</para> - -<para>You can use the <guibutton>Clear Cache</guibutton> button to empty -the cache at any time.</para> - -</article> diff --git a/doc/kcontrol/cookies/CMakeLists.txt b/doc/kcontrol/cookies/CMakeLists.txt deleted file mode 100644 index 8f86430..0000000 --- a/doc/kcontrol/cookies/CMakeLists.txt +++ /dev/null @@ -1,2 +0,0 @@ -########### install files ############### -kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/cookies) diff --git a/doc/kcontrol/cookies/index.docbook b/doc/kcontrol/cookies/index.docbook deleted file mode 100644 index a28b7b1..0000000 --- a/doc/kcontrol/cookies/index.docbook +++ /dev/null @@ -1,208 +0,0 @@ -<?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 --> -]> -<!--FIXME code in frameworks/kio - docbook in plasma-desktop? --> -<article id="cookies" lang="&language;"> -<articleinfo> -<title>Cookies</title> -<authorgroup> -<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> -<author>&Jost.Schenck; &Jost.Schenck.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> - -<date>2015-04-09</date> -<releaseinfo>Plasma 5.3</releaseinfo> - -<keywordset> -<keyword>KDE</keyword> -<keyword>Systemsettings</keyword> -<keyword>cookie</keyword> -</keywordset> - -</articleinfo> - -<sect1 id="cookie"> -<title>Cookies</title> - -<para>Cookies are a mechanism used by web sites to store and retrieve -information using your browser. For example, a web site may allow you -to customize the content and layout of the pages you see, so that your -choices are persistent across different visits to that web site.</para> - -<para>The web site is able to remember your preferences by storing a -cookie on your computer. Then, on future visits, the web site retrieves -the information stored in the cookie to format the content of the site -according to your previously specified preferences.</para> - -<para>Thus, cookies play a very useful role in web browsing. -Unfortunately, web sites often store and retrieve information in cookies -without your explicit knowledge or consent. Some of this information may -be quite useful to the web site owners, for example, by allowing them to -collect summary statistics on the number of visits different areas of -the web sites get, or to customize banner advertising.</para> - -<para>The cookies page allows you to set policies -for the use of cookies when you are browsing the web with the -&konqueror; web browser. </para> - -<warning><para>Note that the policies that you set using this control -module will <emphasis>not</emphasis> apply to other web browsers such -as Firefox.</para></warning> - -<sect2 id="cookie-policy"> - -<title>Policy</title> - -<para>Using the <guilabel>Policy</guilabel> tab, you can configure the -&kde; applications that will handle cookies. You can do this by specifying a -general cookie policy as well as special cookie policies for certain -domains or hosts.</para> - -<para>The top of the policy tab has a check box labeled <guilabel>Enable -cookies</guilabel>. If you leave this unchecked, cookies will be -completely disabled. However, this may make browsing rather -inconvenient, especially as some web sites require the use of browsers -with cookies enabled.</para> - -<para>You will probably want to enable cookies and then set -specific policies on how you want them to be handled.</para> - -<para>The first group of options create settings that apply to all cookies.</para> - -<variablelist> -<varlistentry> -<term><guilabel>Only accept cookies from originating server</guilabel></term> -<listitem> -<para>Some pages try to set cookies from servers other than the one -you are seeing the &HTML; page from. For example, -they show you advertisements, and the advertisements are from another -computer, often one that belongs to a large advertising group. These -advertisements may try to set a cookie which would allow them to -track the pages you view across multiple web sites.</para> -<para>Enabling this option will mean only cookies that come from the -same web server as you are explicitly connecting to will be -accepted.</para> -</listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Automatically accept session cookies</guilabel></term> -<listitem> - -<para>An increasingly common use for cookies is not to track your -movements across many visits to a web site, but to just follow what you -do during one single visit. Session cookies are saved as long as you -are looking at the site, and deleted when you leave it.</para> - -<para>Web sites can use this information for various things, most -commonly it is a convenience so that you do not have to keep logging in -to view pages. For example, on a webmail site, without some kind of -session <acronym>ID</acronym>, you would have to give your password -again for each email you want to read. There are other ways to -achieve this, but cookies are simple and very common.</para> - -<para>Enabling this option means that session cookies are always -accepted, even if you don't accept any other kind, and even if you -choose to reject cookies from a particular site, session cookies from -that site will be accepted.</para> -</listitem> -</varlistentry> -</variablelist> - -<para>The section for <guilabel>Default Policy</guilabel> sets some -further options that are mutually exclusive — you can choose only one -of these options as the default, but you are free to set a different -option for any specific web server.</para> -<note><para>Site specific policies always take precedence over the default -policy.</para></note> - -<variablelist> -<varlistentry> -<term><guilabel>Accept all cookies</guilabel></term> -<listitem> -<para>If this option is selected, all cookies will be accepted without -asking for confirmation.</para> -</listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Accept until end of session</guilabel></term> -<listitem> -<para>Cookies will be accepted, but they will expire at the end -of the session.</para> -</listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Ask for confirmation</guilabel></term> -<listitem> -<para>If this option is selected, you will be asked for confirmation -every time a cookie is stored or retrieved. You can selectively accept -or reject each cookie. The confirmation dialog will also allow you to -set a domain specific policy, if you do not want to confirm each -cookie for that domain.</para> -</listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Reject all cookies</guilabel></term> -<listitem> -<para>If this option is selected, all cookies will be rejected without -asking for confirmation.</para> -</listitem> -</varlistentry> -</variablelist> - -<para>In addition to the default policy for handling of cookies, which you can -set by selecting one of the three options described above, you can also set -policies for specific host domains using the controls in the <guilabel>Site -Policy</guilabel> group.</para> - -<para>The Ask, Accept, Accept until end of session, or Reject policy can be applied to a specific -domain by clicking on the <guibutton>New...</guibutton> button, which -brings up a dialog. In this dialog, you can type the name of the -domain (with a leading dot), then select the policy you want to apply -to this domain. Note that entries may also get added while you are -browsing, if the default policy is to ask for confirmation, and you -choose a general policy for a specific host (for example, by selecting -<guilabel>Reject</guilabel> when asked to -confirm a cookie).</para> - -<para>You can also select a specific host domain from the list and click the -<guibutton>Change</guibutton> button to choose a different policy for that -domain than the one shown in the list.</para> - -<para>To delete a domain specific policy, choose a domain from the list, and -then click the <guibutton>Delete</guibutton> button. The default policy will -apply to domains which have been deleted from the list.</para> - -</sect2> - -<sect2 id="cookie-management"> -<title>Management</title> - -<para>In the <guilabel>Management</guilabel> tab you can browse and selectively -delete cookies that have been set in the past.</para> - -<para>In the upper part of this dialog, you can see a list of domains displayed - as a tree. Click on the little <guiicon>></guiicon> next to a domain to see all -cookies that have been set for this particular target domain. If you select one -of these cookies, you will notice that its contents will show up in the frame -<guilabel>Details</guilabel> below.</para> - -<para>By clicking the <guibutton>Delete</guibutton> button you can now delete the selected -cookie. Click <guibutton>Delete All</guibutton> to delete all cookies stored.</para> - -<para>If a domain is selected, you can use <guibutton>Configure Policy</guibutton> to set -a site policy.</para> - -<para>Choose <guibutton>Reload List</guibutton> to reload the list -from your hard disk. You might want to do this if you have had the -module open and are testing web sites, or have made many changes in the -module itself.</para> - -</sect2> - -</sect1> - -</article> diff --git a/doc/kcontrol/filetypes/CMakeLists.txt b/doc/kcontrol/filetypes/CMakeLists.txt deleted file mode 100644 index c6a6b24..0000000 --- a/doc/kcontrol/filetypes/CMakeLists.txt +++ /dev/null @@ -1,2 +0,0 @@ -########### install files ############### -kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/filetypes) diff --git a/doc/kcontrol/filetypes/index.docbook b/doc/kcontrol/filetypes/index.docbook deleted file mode 100644 index 3e53332..0000000 --- a/doc/kcontrol/filetypes/index.docbook +++ /dev/null @@ -1,367 +0,0 @@ -<?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 --> -]> -<!--FIXME code in kde-cli-tools - docbook in plasma-desktop? --> -<article id="filetypes" lang="&language;"> -<articleinfo> - -<title>File Associations</title> -<authorgroup> -<author>&Mike.McBride; &Mike.McBride.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> - -<date>2015-04-09</date> -<releaseinfo>Plasma 5.3</releaseinfo> - -<keywordset> -<keyword>KDE</keyword> -<keyword>Systemsettings</keyword> -<keyword>files association</keyword> -<keyword>association</keyword> -</keywordset> -</articleinfo> -<sect1 id="file-assoc"> -<title>File Associations</title> - -<sect2 id="file-assoc-intro"> -<title>Introduction</title> - -<para>One of the most convenient aspects of &kde;, is its ability to -automatically match a data file with its application. As an example, -when you click on your favorite &calligrawords; document in the filemanager, &kde; -automatically starts &calligrawords;, and automatically loads that file into -&calligrawords; so you can begin working on it.</para> - -<para>In the example above, the &calligrawords; Data file is -<emphasis>associated</emphasis> with &calligrawords; (the application). These -file associations are crucial to the functioning of &kde;.</para> - -<para>When &kde; is installed, it automatically creates hundreds of file -associations to many of the most common data types. These initial -associations are based on the most commonly included software, and the -most common user preferences.</para> - -<para>Unfortunately, &kde; can not:</para> - -<itemizedlist> -<listitem><para>predict every possible combination of software and data files</para></listitem> -<listitem><para>prepare for file formats not yet invented</para></listitem> -<listitem><para>or predict everyone's favorite application for certain file formats</para></listitem> -</itemizedlist> - -<para>You can change your current file associations or add new file -associations using this module.</para> - -<para>Each file association is recorded as a mime type. -&MIME; stands for <quote>Multipurpose Internet Mail -Extensions</quote>. It allows a computer to determine the type of file, -without opening and analyzing the format of each and every file.</para> - -</sect2> - -<sect2 id="file-assoc-use"> -<title>How to use this module</title> - -<para>You can start this module -by opening &systemsettings; and selecting <menuchoice><guimenu>Applications</guimenu> -<guimenuitem>File Associations</guimenuitem></menuchoice> in the -<guilabel>Personalization</guilabel> category. Alternatively, you can start it by -typing <command>kcmshell5 filetypes</command> from the terminal or &krunner;.</para> - -<para>The file associations are organized into several categories, and -at a minimum you will have:</para> - -<orderedlist> -<listitem><para>Application</para></listitem> -<listitem><para>Audio</para></listitem> -<listitem><para>Image</para></listitem> -<listitem><para>Inode</para></listitem> -<listitem><para>Message</para></listitem> -<listitem><para>Multipart</para></listitem> -<listitem><para>Text</para></listitem> -<listitem><para>Video</para></listitem> -</orderedlist> - -<para>All of the file associations are sorted into one of these -categories.</para> - -<note><para>There is no functional difference between any of the -categories. These categories are designed to help organize your file -associations, but they do not alter the associations in any way. -</para></note> - -<para>The categories are listed in the box labeled <guilabel>Known -Types</guilabel>.</para> - -<para>You can explore each of these categories, and see the file -associations contained within each one, by simply double-clicking on the -category name. You will be presented with a list of the associated -mime-types under that category.</para> - -<tip><para>You can also search for a particular &MIME; type by using the -search box. The search box is labeled <guilabel>Find file type or filename -pattern</guilabel> and is located above the category list.</para> - -<para>Simply type the first letter of the &MIME; type you are interested -in. The categories are automatically expanded, and only the mime-types -that include that letter are displayed.</para> - -<para>You can then enter a second character and the mime-types will be -further limited to mime types containing those two -characters.</para></tip> - -<sect3 id="file-assoc-use-add"> -<title>Adding a new mime type</title> - -<para>If you want to add a new &MIME; type to your file associations, -you can click on the <guibutton>Add...</guibutton> button. A small -dialog box will appear. You select the category from the drop down -box labeled <guilabel>Group</guilabel>, and type the &MIME; name in the blank labeled <guilabel>Type -name</guilabel>. Click <guibutton>OK</guibutton> to add the new mime -type, or click <guibutton>Cancel</guibutton> to not add any new -mime-types.</para> - -</sect3> - -<sect3 id="file-assoc-use-del"> -<title>Removing a mime type</title> - -<para>If you want to remove a &MIME; type, simply select the &MIME; -type you want to delete by clicking once with the mouse on the &MIME; -type name. Then click the button labeled -<guibutton>Remove</guibutton>. The &MIME; type will be deleted -immediately.</para> - -</sect3> - -<sect3 id="file-assoc-use-edit"> -<title>Editing a mime types properties</title> - -<para>Before you can edit a &MIME; types property, you must first -specify which &MIME; type. Simply browse through the categories until -you find the &MIME; type you want to edit, then click once on it with -the mouse.</para> - -<para>As soon as you have selected the &MIME; type, the current values of -the &MIME; type will appear in the module window.</para> - -<para>You will notice the current values are split into two tabs: -<guilabel>General</guilabel> and <guilabel>Embedding</guilabel></para> - -<variablelist> -<varlistentry> -<term><guilabel>General</guilabel></term> -<listitem> -<para>There are 4 properties for each &MIME; type in this tab:</para> - -<orderedlist> -<listitem><para><guilabel>Mime Type Icon</guilabel> is the icon that -will be visible when using &dolphin; or &konqueror; as a file -manager.</para></listitem> -<listitem><para><guilabel>Filename Patterns</guilabel> is a search -pattern which &kde; will use to determine the &MIME; type.</para></listitem> -<listitem><para><guilabel>Description</guilabel> is a short description -of the file type. This is for your benefit only.</para></listitem> -<listitem><para><guilabel>Application Preference Order</guilabel> -determines which applications will be associated with the specified -&MIME; type.</para></listitem> -</orderedlist> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Embedding Tab</guilabel></term> -<listitem> -<para>The Embedding tab allows you to determine if a file will be -viewed within a filemanager window, or by starting the -application.</para> -</listitem> -</varlistentry> -</variablelist> - -</sect3> - -<sect3 id="file-assoc-use-icon"> -<title>Changing the Icon</title> - -<para>To change the icon, simply click on the Icon button. A dialog box -will appear, which will show you all available icons. Simply click once -with the mouse on the icon of your choice, and click -<guibutton>OK</guibutton>.</para> - -</sect3> - -<sect3 id="file-assoc-use-pattern"> -<title>Editing the mime-type patterns</title> - -<para>The box labeled <guilabel>Filename Patterns</guilabel>, determines -what files will be included within this mime-type.</para> - -<para>Usually, files are selected based on their suffix. (Examples: -Files that end with <literal role="extension">.wav</literal> are sound -files, using the WAV format and files that end in <literal -role="extension">.c</literal> are program files written in C).</para> - -<para>You should enter your filename mask in this combo box.</para> - -<para>The asterisk (<literal>*</literal>) is a wildcard character that -will be used with nearly every mime type mask. A complete discussion -of wildcards is beyond the scope of this manual, but it is important -to understand that the asterisk (in this context), -<quote>matches</quote> any number of characters. As an example: -<userinput>*.pdf</userinput> will match -<filename>Datafile.pdf</filename>, <filename>Graphics.pdf</filename> -and <filename>User.pdf</filename>, but not <filename>PDF</filename>, -<filename>Datafile.PDF</filename>, or -<filename>.pdf</filename>.</para> - -<tip><para>It is very beneficial to have multiple masks. One for lower -case, one for upper case, &etc; This will help ensure that &kde; can -determine the file type more accurately.</para></tip> - -</sect3> - -<sect3 id="file-assoc-use-desc"> -<title>Editing a mime types description.</title> - -<para>You can type a short description of the &MIME; type in the text -box labeled <guilabel>Description</guilabel>. This label is to help -you, it does not affect the function of the &MIME; type.</para> - -</sect3> - -<sect3 id="file-assoc-use-app"> -<title>Editing the application associations</title> - -<para>There are five buttons (<guibutton>Move Up</guibutton>, -<guibutton>Move Down</guibutton>, <guibutton>Add</guibutton>, <guibutton>Edit</guibutton> and -<guibutton>Remove</guibutton>) and a list box (which lists the -applications) which are used to configure the applications.</para> - -<para>The list box lists all of the applications associated with a -specific &MIME; type. The list is in a specific order. The top -application is the first application tried. The next application down -the list is the second, &etc;</para> - -<note><para>What do you mean there is more than one application per -&MIME; type? Why is this necessary?</para> - -<para>We started out by saying that &kde; comes preconfigured with -hundreds of file associations. The reality is, each system that &kde; -is installed on has a different selection of applications. By -allowing multiple associations per &MIME; type, &kde; can continue to -operate when a certain application is not installed on the -system.</para> - -<para>As an example:</para> -<para>For the &MIME; type <literal>pdf</literal>, there are two -applications associated with this file type. The first program is -called &okular;. If your system does not -have &okular; installed, then &kde; -automatically starts the second application &krita;. -As you can see, this will help keep &kde; running -strong as you add and subtract applications.</para></note> - -<para>We have established that the order is important. You can change -the order of the applications by clicking once with the mouse on the -application you want to move, and then clicking either <guibutton>Move -Up</guibutton> or <guibutton>Move Down</guibutton>. This will shift -the currently selected application up or down the list of -applications. </para> - -<para>You can add new applications to the list by clicking the button -labeled <guibutton>Add</guibutton>. A dialog box will appear. Using the -dialog box, you can select the application you want to use for this mime -type. Click <guibutton>OK</guibutton> when you are done, and the -application will be added to the current list.</para> - -<para>To change the options of an application for a particular &MIME; type -select it in the list and then press the <guibutton>Edit...</guibutton> button. -This opens a new dialog with <guilabel>General</guilabel>, -<guilabel>Permissions</guilabel>, <guilabel>Applications</guilabel> and -<guilabel>Preview</guilabel> tabs. -On the <guilabel>Applications</guilabel> tab you can edit <guilabel>Name</guilabel>, -<guilabel>Description</guilabel> and <guilabel>Comment</guilabel>. -In the <guilabel>Command</guilabel> field you can have several place holders -following the command, which will be replaced with the actual values -when the actual program is run:</para> -<itemizedlist> -<listitem><para>%f - a single file name</para></listitem> -<listitem><para>%F - a list of files; use for applications that can open several local files -at once</para></listitem> -<listitem><para>%u - a single URL</para></listitem> -<listitem><para>%U - a list of URLs</para></listitem> -<listitem><para>%d - the folder of the file to open</para></listitem> -<listitem><para>%D - a list of folders</para></listitem> -<listitem><para>%i - the icon</para></listitem> -<listitem><para>%m - the mini-icon</para></listitem> -<listitem><para>%c - the caption</para></listitem> -</itemizedlist> - -<para>You can remove an application (thereby ensuring that the -application will never run with this &MIME; type by clicking once on the -name of the application, and clicking the <guibutton>Remove</guibutton> -button.</para> - -<tip><para>It is a good idea to use the <guibutton>Move Up</guibutton> -and <guibutton>Move Down</guibutton> buttons to adjust the unwanted -application to a lower position in the list, rather than deleting the -application from the list entirely. Once you have deleted an -application, if your preferred application should become compromised, -there will not be an application to view the data document.</para></tip> - -</sect3> - -<sect3 id="file-assoc-embedding"> -<title>Embedding</title> -<para>These settings are valid only for &konqueror; used as file manager, &dolphin; -is not able to use embedded views and opens a file always in the associated application.</para> -<para>By clicking on the <guilabel>Embedding</guilabel> tab, you are -presented with four radio buttons in the <guilabel>Left click -action</guilabel> group. These determine how the filemanager views the selected -&MIME; type:</para> - -<variablelist> -<varlistentry><term>Show file in embedded viewer</term> -<listitem><para>If this is selected, the file will be shown <emphasis>within</emphasis> the filemanager window.</para></listitem></varlistentry> -<varlistentry><term>Show file in separate viewer</term> -<listitem><para>This will cause a separate window to be created when showing this mime-type.</para></listitem></varlistentry> -<varlistentry><term>Use settings for 'application' group</term> -<listitem><para>This will cause the mime-type to use the settings for the mime-type group. -(if you are editing an audio mime type, then the settings for the audio group are used).</para></listitem></varlistentry> -<varlistentry><term>Ask whether to save to disk instead</term> -<listitem><para>This setting applies only to &konqueror; in browser mode and determines -if the file is shown in an embedded viewer or if you are asked to save the file to disk instead.</para></listitem></varlistentry> -</variablelist> - -<para>Below this is a listbox labeled <guilabel>Services Preference -Order</guilabel>.</para> - -<para>When you use a filemanager like &dolphin; or &konqueror;, you can -<mousebutton>right</mousebutton> mouse click, and a menu will with an -entry labeled <guimenu>Open with...</guimenu> will appear. This box -lists the applications that will appear, in the order they will -appear, under this menu.</para> - -<para>You can use the <guibutton>Move Up</guibutton> and -<guibutton>Move Down</guibutton> buttons to change the order.</para> - -</sect3> - -<sect3 id="file-assoc-use-done"> -<title>Making changes permanent</title> - -<para>When you are done making any changes to mime types, you can click -<guibutton>Apply</guibutton> to make your changes permanent, but keep -you in this module.</para> - -</sect3> -</sect2> - -</sect1> - -</article> diff --git a/doc/kcontrol/netpref/CMakeLists.txt b/doc/kcontrol/netpref/CMakeLists.txt deleted file mode 100644 index 42010fd..0000000 --- a/doc/kcontrol/netpref/CMakeLists.txt +++ /dev/null @@ -1,2 +0,0 @@ -########### install files ############### -kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/netpref) diff --git a/doc/kcontrol/netpref/index.docbook b/doc/kcontrol/netpref/index.docbook deleted file mode 100644 index 643c01e..0000000 --- a/doc/kcontrol/netpref/index.docbook +++ /dev/null @@ -1,109 +0,0 @@ -<?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 --> -]> -<!--FIXME code in frameworks/kio - docbook in plasma-desktop? --> -<article id="netpref" lang="&language;"> -<articleinfo> -<title>Connection Preferences</title> -<authorgroup> -<author>&Lauri.Watts; &Lauri.Watts.mail;</author> - -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> - -<date>2015-04-09</date> -<releaseinfo>Plasma 5.3</releaseinfo> - -<keywordset> -<keyword>KDE</keyword> -<keyword>kdebase</keyword> -<keyword>kcontrol</keyword> -<keyword>network</keyword> -<keyword>timeouts</keyword> -</keywordset> - -</articleinfo> - -<sect1 id="timeouts"> - -<title>Connection Preferences</title> - -<para>Here you can set timeout values. You might want to tweak them -if your connection is very slow, but the default settings are -appropriate for most users.</para> - -<para>Here <guilabel>Timeout Values</guilabel> are the length of time -an application should wait for an answer from a network operation.</para> - -<para>You can configure the following timeouts:</para> - -<variablelist> -<varlistentry> -<term><guilabel>Socket read:</guilabel></term> -<listitem> -<para> Some applications use <firstterm>sockets</firstterm> to -communicate. You can think of a socket as a water tap; while it is -open, water (or in our case, data) comes out, without any interaction. -If something stops this flow of data, the application will wait for -more to come. This could be a very long time, but you can configure a -maximum time for an application to wait with this option.</para> -<para>This setting will only apply to &kde; applications, of course.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Proxy connect:</guilabel></term> -<listitem> -<para> -Sets how long to wait for a connection to a proxy server, if one is configured. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Server connect:</guilabel></term> -<listitem> -<para> -Sets how long to wait for a connection to a remote server. -</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Server response:</guilabel></term> -<listitem> -<para> -Sets how long to wait for a reply from a remote server. -</para> -</listitem> -</varlistentry> - -</variablelist> - -<para>You can configure <guilabel>FTP Options</guilabel> here. At -present there is just two options:</para> -<variablelist> -<varlistentry> -<term><guilabel>Enable passive mode (PASV)</guilabel></term> -<listitem><para>Passive &FTP; is often required when you are behind a firewall. -Many firewalls only permit connections that were initiated from -<quote>the inside</quote>. Passive &FTP; is controlled by the client, -which makes it usable through firewalls.</para></listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Mark partially uploaded files</guilabel></term> -<listitem><para>When a mark is placed in this box, partially uploaded files will -have a <literal role="extension">.part</literal> extension added to the end -of the file. This extension is removed once the file download is complete. </para></listitem> -</varlistentry> - -</variablelist> - - - -</sect1> -</article> diff --git a/doc/kcontrol/proxy/CMakeLists.txt b/doc/kcontrol/proxy/CMakeLists.txt deleted file mode 100644 index 37b19c9..0000000 --- a/doc/kcontrol/proxy/CMakeLists.txt +++ /dev/null @@ -1,2 +0,0 @@ -########### install files ############### -kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/proxy) diff --git a/doc/kcontrol/proxy/index.docbook b/doc/kcontrol/proxy/index.docbook deleted file mode 100644 index 48864fc..0000000 --- a/doc/kcontrol/proxy/index.docbook +++ /dev/null @@ -1,209 +0,0 @@ -<?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 --> -]> -<!--FIXME code in frameworks/kio - docbook in plasma-desktop? --> -<article id="proxy" lang="&language;"> -<title>Proxy</title> -<articleinfo> -<authorgroup> -<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> - -<date>2015-04-09</date> -<releaseinfo>Plasma 5.5</releaseinfo> - -<keywordset> -<keyword>KDE</keyword> -<keyword>Systemsettings</keyword> -<keyword>proxy</keyword> -<keyword>proxies</keyword> -</keywordset> - -</articleinfo> -<sect1 id="proxies"> -<title>Proxies</title> - -<sect2 id="proxies-intro"> - -<title>Introduction</title> - -<para>Proxies are programs running on a computer that acts a server on -the network you are connected to (whether by modem or other -means). These programs receive &HTTP; and &FTP; requests, retrieve the -relevant files from the internet, and pass them on to the client -computer that made the requests.</para> - -<para>When you have configured a proxy, &HTTP; and/or &FTP; requests -are re-routed through the computer that is acting as a proxy server. -However, you can also select specific hosts which should be contacted -directly, rather than through the proxy server. If you are on a local -network, for example, access to local hosts probably doesn't need to -go through a proxy server.</para> - -<para>You should only need to configure a proxy server if your network -administrator requires it (if you are a dial-up user, that would be -your internet service provider or <acronym>ISP</acronym>). Otherwise, -especially if you are feeling a bit confused about this proxy -business, but everything seems to be fine with your internet -connection, you don't need to change anything.</para> - -<para>Please note that using proxy servers is optional, but has the -benefit or advantage of giving you faster access to data on the -internet.</para> - -<para>If you are uncertain whether or not you need to use a proxy -server to connect to the internet, please consult with your internet -service provider's setup guide or your system administrator.</para> - -</sect2> - -<sect2 id="proxies-use"> - -<title>Use</title> - -<variablelist> -<varlistentry> -<term><guilabel>No Proxy</guilabel></term> -<listitem> - -<para>Select this option if you do <emphasis>not</emphasis> want to use a proxy server -and connect to the Internet directly.</para> -</listitem> -</varlistentry> -</variablelist> - -<para>If you have decided to use a proxy, you have several methods to -configure the settings for it.</para> - -<variablelist> -<varlistentry> -<term><guilabel>Detect proxy configuration automatically</guilabel></term> -<listitem> - -<para>Select this option if you want the proxy setup configuration -script file to be automatically detected and downloaded.</para> -<para>This option only differs from the next choice in that it -<emphasis>does not</emphasis> require you to supply the location of -the configuration script file. Instead, it will be automatically -downloaded using <quote>Web Proxy Auto-Discovery</quote> -(<acronym>WPAD</acronym>) protocol.</para> - -<note><para>If you have a problem using this setup, please consult the -<acronym>FAQ</acronym> section at <ulink -url="http://www.konqueror.org";>http://www.konqueror.org</ulink> for -more information.</para></note> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Use proxy auto configuration URL</guilabel></term> -<listitem> -<para>Select this option if your proxy support is provided through a -script file located at a specific address. You can then enter the -address in the location text box, or use the <guiicon>folder</guiicon> -icon to browse to it.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><guilabel>Use system proxy configuration</guilabel></term> -<listitem> -<para>Some systems are setup with $<envar>HTTP_PROXY</envar> to allow -graphical as well as non-graphical applications to share the same -proxy configuration information.</para> -<para>If you know this applies to you, select this option and click on -the <guibutton>Auto Detect</guibutton> button to provide the environment -variable names used to set the address of the proxy server(s).</para> -<!-- Exceptions fields are different for system proxy (envar) + manual proxy list of hosts/IPs? --> -<para>In the <guilabel>Exceptions</guilabel> field enter the environment variable, -⪚ $<envar>NO_PROXY</envar>, used to store the -addresses of sites for which the proxy server should not be used.</para> -<para>Use <guilabel>Show the value of the environment variables</guilabel> to -show the value of an environment variable instead of its name. -However it is not possible to edit the values of environment variables in this module.</para> -<!-- -How to enable Auto Detect button? ---> - -</listitem> -</varlistentry> -<varlistentry> -<term><guilabel>Use manually specified proxy configuration</guilabel></term> -<listitem> - -<para>The complete addressing information for the proxy includes both -the Internet address and a port number. You should enter these into -the relevant text boxes. Check <guilabel>Use this proxy server for all -protocols</guilabel> to copy the addresses and port of the HTTP proxy server -into all other proxy fields, in order to help save some typing.</para> - -<variablelist> -<varlistentry> -<term><guilabel>Exceptions</guilabel></term> -<listitem> -<para>Enter a comma separated list of hostnames or ip addresses that should -be excluded from using the above proxy settings. If you want to exclude all -hosts for a given domain, then simply enter the domain name preceded by a dot. -For example, to exclude all hostnames for kde.org, enter <userinput>.kde.org</userinput>. -Wildcard characters such as <userinput>*</userinput> or <userinput>?</userinput> -are not supported and will have no effect. -Additionally, you can also enter IP addresses, e.g. 127.0.0.1 and -IP addresses with a subnet, e.g. 192.168.0.1/24.</para> -</listitem> -</varlistentry> -</variablelist> - -<para>You can also choose <guilabel>Use proxy settings only for addresses -in the Exceptions list</guilabel>.</para> - -<para>Check this box to reverse the use of the exception list, &ie; -the proxy servers will only be used when the requested &URL; matches -one of the addresses listed here.</para> - -<para>This feature is useful if all you need is a proxy to access a -few specific sites, for example, an internal intranet. If you have -more complex requirements you might want to use a configuration -script.</para> -</listitem> -</varlistentry> -</variablelist> - -</sect2> -<!-- not in 4.8 anymore - -What if authorization is needed? - -<sect2 id="authorization"> -<title><guilabel>Authorization</guilabel></title> - -<para>Here you can choose between two types of authentication, if your -proxy requires it. You can have <guilabel>Prompt as -needed</guilabel>, the default, in which case &konqueror; will only -ask for a username or password if it needs to.</para> - -<para>The other option is to use automatic login. -Select this option and enter <guilabel>Username</guilabel> and <guilabel>Password</guilabel>. -</para> - -</sect2> - -<sect2 id="options"> -<title><guilabel>Options</guilabel></title> -<variablelist> -<varlistentry> -<term><guilabel>Use persistent connections to proxy</guilabel></term> -<listitem> -<para>Use persistent connection to your proxy server. Keeps connection to proxy open, helps lower bandwidth/speed up connection. Enabling this option will require the proxy server's cooperation, if the proxy server does not support this, it will bring your internet to a stop. </para> -</listitem> -</varlistentry> -</variablelist> - -</sect2> ---> -</sect1> - -</article> diff --git a/doc/kcontrol/smb/CMakeLists.txt b/doc/kcontrol/smb/CMakeLists.txt deleted file mode 100644 index 3285ccf..0000000 --- a/doc/kcontrol/smb/CMakeLists.txt +++ /dev/null @@ -1,2 +0,0 @@ -########### install files ############### -kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/smb) diff --git a/doc/kcontrol/smb/index.docbook b/doc/kcontrol/smb/index.docbook deleted file mode 100644 index 0197c53..0000000 --- a/doc/kcontrol/smb/index.docbook +++ /dev/null @@ -1,104 +0,0 @@ -<?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 --> -]> -<!--FIXME code in frameworks/kio - docbook in plasma-desktop? --> -<article id="smb" lang="&language;"> -<articleinfo> -<title>Windows Shares</title> -<authorgroup> -<author>&Mike.McBride; &Mike.McBride.mail;</author> -<author>&Jost.Schenck; &Jost.Schenck.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> - -<date>2015-04-09</date> -<releaseinfo>Plasma 5.3</releaseinfo> - -<keywordset> -<keyword>KDE</keyword> -<keyword>Systemsettings</keyword> -<keyword>Windows shares</keyword> -</keywordset> -</articleinfo> -<sect1 id="windows-shares"> -<title>Windows Shares</title> - -<sect2 id="windows-shares-intro"> -<title>Introduction</title> - -<para>In many small local area networks, the <acronym>SMB</acronym> -protocol is used to offer network services. Names like -<quote>&Windows; Network</quote> or <quote>&Windows; for Workgroups -Network</quote> or <quote>LanManager</quote> are often used as -well. Using <acronym>SMB</acronym> you can access so-called -<quote>shares</quote> (&ie; folders made available by the server) -as well as printers. </para> - -<para>&kde; comes with built-in support for the <acronym>SMB</acronym> -protocol. As &kde; is network-transparent that means you can access -<acronym>SMB</acronym> shares from everywhere you can access your -local files, for example in the &konqueror; file manager and in the -file dialog. To make use of this you should provide &kde; with some -information on your <acronym>SMB</acronym> network. But don't worry, -this is normally pretty simple as, for example, all the Windows -clients in your network need and have the same information.</para> - -<!-- Don't know if the following info should go in the base -documentation --> - -<!-- this smb-ioslave doesn't support showing a list -of hosts (like e.g. smb:/), for this you need the lan or rlan-ioslave, -very cool thing (TM) btw. If you want to write some documentation for -this one too, have a look at kdenetwork/lanbrowsing/lisa/README and -contact me if you have questions. --> - -<note><para>For the <acronym>SMB</acronym> protocol to work, it is -required to have <application>Samba</application> correctly -installed.</para></note> - -<!-- TODO: link to some place which explains USING SMB, i.e. konqueror -or file dialog manual --> - -</sect2> - -<sect2 id="windows-shares-use"> -<title>Use</title> - -<para>Although there are a lot of insecure <acronym>SMB</acronym> -networks out there which allow access to anyone, in principle you have -to authenticate yourself to access the services of an -<acronym>SMB</acronym> server. By default, &kde; will use the data -entered in the <guilabel>Default user name</guilabel> and -<guilabel>Default password</guilabel> fields to authenticate itself on -<acronym>SMB</acronym> hosts. If you leave the field <guilabel>Default -user name</guilabel> empty, &kde; will try to access -<acronym>SMB</acronym> hosts without a username. If you leave the -default password empty, it will try without a password. If &kde; is -unsuccessful accessing the host using these settings, you will be -asked for a username and a password.</para> - -<important><para>While it makes things more comfortable if &kde; -stores your <acronym>SMB</acronym> password, this may be a security -problem. If you are using <acronym>SMB</acronym> in a security -conscious environment, you should not store your password here but -rather enter it anew every time you need to access an -<acronym>SMB</acronym> host.</para></important> - -<!-- not in kde 4 -<para>In the <guilabel>Workgroup</guilabel> field, you can enter your -workgroup name. If you don't know it, ask your system administrator -or have a look at other already configured machines in your network. -However, in most cases providing the workgroup name is not required, -so you probably can also leave this empty.</para> - -<para>If the option <guilabel>Show hidden shares</guilabel> is -checked, shares ending with a <quote>$</quote> will be shown.</para> ---> -</sect2> - -</sect1> - -</article> diff --git a/doc/kcontrol/useragent/CMakeLists.txt b/doc/kcontrol/useragent/CMakeLists.txt deleted file mode 100644 index 35165d2..0000000 --- a/doc/kcontrol/useragent/CMakeLists.txt +++ /dev/null @@ -1,2 +0,0 @@ -########### install files ############### -kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/useragent) diff --git a/doc/kcontrol/useragent/index.docbook b/doc/kcontrol/useragent/index.docbook deleted file mode 100644 index 24bc9b2..0000000 --- a/doc/kcontrol/useragent/index.docbook +++ /dev/null @@ -1,110 +0,0 @@ -<?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 --> -]> -<!--FIXME code in frameworks/kio - docbook in plasma-desktop? --> -<article id="useragent" lang="&language;"> -<title>Browser Identification</title> -<articleinfo> -<authorgroup> -<author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> - -<date>2015-04-09</date> -<releaseinfo>Plasma 5.3</releaseinfo> - -<keywordset> -<keyword>KDE</keyword> -<keyword>Systemsettings</keyword> -<keyword>user agent</keyword> -<keyword>browser</keyword> -<keyword>identification</keyword> -</keywordset> - -</articleinfo> - -<sect1 id="user-agent"> -<title>Browser Identification</title> - - -<sect2 id="user-agent-intro"> -<title>Introduction</title> - -<para>When &konqueror; connects to a web site to retrieve information, -some basic identifying information is sent to the web site in the form -of a <quote>User Agent</quote> header.</para> - -<para>Because of minor differences in the way that different web -browsers function, web sites that rely too much on a single browser may -sometimes not display as intended when viewed using another -browser. Some web sites are smart enough to examine the contents of the -user agent header and incorporate this information in the -&HTML; code so that the content is displayed correctly -regardless of the browser used.</para> - -<para>However, you may find that some web sites refuse to function -correctly unless you are using a browser recognized as -<quote>proper</quote> by that site. In these cases, you may find it -necessary to fool the web site by having &konqueror; report itself to be -another browser by means of the user agent header.</para> - -</sect2> - -<sect2 id="user-agent-use"> -<title>Use</title> - -<para>In this module you can configure the -type of browser that &konqueror; will report itself to be. You can -control this information by web site. Usually, the list box that is -labeled <guilabel>Site Specific Identification</guilabel> will be -empty, so that &konqueror; will always use its default useragent -string.</para> - -<para>You can disable the sending of a user agent entirely, by -unchecking the <guilabel>Send identification</guilabel> -check box. This may cause strange behavior on some sites, and may even -deny you access to some websites, so disable this with caution.</para> - -<para>To configure a new agent binding, press the -<guibutton>New...</guibutton> button. Type the name of the server or -a domain in the text box at the top of the dialog that pops up, which -is labeled <guilabel>When browsing the following -site</guilabel>.</para> - -<para>Note that you can <emphasis>not</emphasis> use the wildcard -character <token>*</token> in this text box. However, the string -<userinput>kde.org</userinput> will match all hosts in the domain -<systemitem>kde.org</systemitem></para> - -<para>After typing the name of the server, type in the identifying -string in the next combo box, which is labeled <guilabel>Use the -following identification:</guilabel>, or choose a string from the list. If -you don't choose a string from the list, you will need to know what a -valid string from the browser looks like. For example, you could type -<userinput>Mozilla/4.0 (compatible; MSIE 4.0)</userinput>. </para> - -<para>You can click on an existing entry in the list, and then modify the contents of the -text boxes, followed by clicking <guibutton>Change...</guibutton>.</para> - -<para>The <guibutton>Delete</guibutton> button can be used to delete -the selected entry in the list of configured agent bindings. The -<guibutton>Delete All</guibutton> will remove all the configured user -agent strings. Click the <guibutton>Apply</guibutton> to take your -changes in effect.</para> - -<para>You can use the check boxes at the top of the screen to build a -user agent that is uniquely yours, by choosing your own combination of -operating system name and version, platform, processor type, and -language.</para> - -<para>In all cases, the user agent that is being sent by default is -displayed in bold text at the top of the page.</para> - -</sect2> - -</sect1> - -</article> diff --git a/doc/kcontrol/webshortcuts/CMakeLists.txt b/doc/kcontrol/webshortcuts/CMakeLists.txt deleted file mode 100644 index 7324220..0000000 --- a/doc/kcontrol/webshortcuts/CMakeLists.txt +++ /dev/null @@ -1,2 +0,0 @@ -########### install files ############### -kdoctools_create_handbook(index.docbook INSTALL_DESTINATION ${HTML_INSTALL_DIR}/en SUBDIR kcontrol/webshortcuts) diff --git a/doc/kcontrol/webshortcuts/index.docbook b/doc/kcontrol/webshortcuts/index.docbook deleted file mode 100644 index 81893ab..0000000 --- a/doc/kcontrol/webshortcuts/index.docbook +++ /dev/null @@ -1,174 +0,0 @@ -<?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 --> -]> -<!--FIXME code in frameworks/kio - docbook in plasma-desktop? --> -<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>2015-04-09</date> -<releaseinfo>Plasma 5.3</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;<keycap>Space</keycap></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, -<abbrev>etc...</abbrev>.</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 Shortcuts</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 shortcuts</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 shortcuts only</guilabel> is checked, only -web shortcuts marked as preferred in the third 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 shortcuts</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>Shortcuts -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 shortcuts 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>http://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>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 -&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>
