Warning, /network/konqueror/doc/kcontrol/khtml-adblock/index.docbook is written in an unsupported language. File is not indexed.
0001 <?xml version="1.0" ?> 0002 <!DOCTYPE article PUBLIC "-//KDE//DTD DocBook XML V4.5-Based Variant V1.1//EN" 0003 "dtd/kdedbx45.dtd" [ 0004 <!ENTITY % addindex "IGNORE"> 0005 <!ENTITY % English "INCLUDE" > <!-- change language only here --> 0006 ]> 0007 <!-- extragear has another adblock ? --> 0008 <article lang="&language;" id="khtml-adblock"> 0009 <articleinfo> 0010 <title>AdBlocK Filters</title> 0011 <authorgroup> 0012 <author>&Krishna.Tateneni; &Krishna.Tateneni.mail;</author> 0013 <!-- TRANS:ROLES_OF_TRANSLATORS --> 0014 </authorgroup> 0015 0016 <date>2016-11-08</date> 0017 <releaseinfo>Applications 16.12</releaseinfo> 0018 </articleinfo> 0019 0020 <para>&konqueror; AdBlocK can be configured to replace or remove 0021 images or frames from web pages that match a series of filters.</para> 0022 0023 <para>The setting <guilabel>Enable filters</guilabel> enables or 0024 disables the use of list of URL filters.</para> 0025 <para>If <guilabel>Hide filtered images</guilabel> is enabled then 0026 blocked images are completely removed from the page and the space they 0027 occupied is reclaimed. If the option is disabled then a placeholder 0028 image is used in place of filtered images.</para> 0029 0030 <variablelist> 0031 <varlistentry id="khtml-adblock-manual"> 0032 <term><guilabel>Manual Filter</guilabel></term> 0033 <listitem> 0034 <para>The main part of this tab is a list of 0035 URLs that will be compared against image and frame names to decide 0036 on fitlering actions. The wildcards can be given as filename style 0037 regular expressions.</para> 0038 0039 <para>Each filter can either be expressed as a file style wildcard 0040 string (e.g. http://www.site.com/ads/*) or as a full regular expression 0041 by enclosing the filter with forward slashes (e.g. //(ads|dclk)\./).</para> 0042 0043 <para>Any filter string can be preceded by <literal>@@</literal> to whitelist 0044 (allow) any matching &URL;, which takes priority over any blacklist (blocking) 0045 filter.</para> 0046 0047 <para><guilabel>Import</guilabel> and <guilabel>Export</guilabel> will 0048 save or read the current filter list to a plain text file. The file begins with a 0049 header line <userinput>[AdBlock]</userinput>, then all of the filters follow each 0050 on a separate line. Lines prefixed with an exclamation mark (<userinput>!</userinput>) 0051 and the header line are treated as comments and can be used 0052 to clarify or label a set of filters.</para> 0053 0054 <para>Highlight an entry from the list to change it in the edit box or remove this item. 0055 Enter a new filter string here and add it to the list using the <guibutton> 0056 Insert</guibutton> button.</para> 0057 </listitem> 0058 </varlistentry> 0059 0060 <varlistentry id="khtml-adblock-automatic"> 0061 <term><guilabel>Automatic Filter</guilabel></term> 0062 <listitem> 0063 <para> 0064 This tab shows a list of names and &URL;'s with predefined AdBlock filter entries. 0065 To enable an entry tick the checkbox beside the filter name and adjust the 0066 <guilabel>Automatic update interval</guilabel> (default 7 days). 0067 <!-- how goes it work? After 7 days eachtime going online with konqui the selected 0068 entries are updated in the background? 0069 User notification about that? 0070 --> 0071 </para> 0072 </listitem> 0073 </varlistentry> 0074 0075 </variablelist> 0076 0077 <para>If AdBlock filters are enabled, an icon at the right side of status bar is shown. 0078 Use a &RMB; click on this icon to open the context menu with actions to show all blockable 0079 elements on a web page, open this &systemsettings; module and disable blocking for a site 0080 or page temporarily.</para> 0081 0082 <para>A click with the &LMB; shows the dialog with all blockable elements on the opened web page 0083 as well. From this dialog you can add new filters directly without opening this &systemsettings; 0084 module.</para> 0085 0086 </article>