~l3on/ubuntu/precise/epiphany-extensions/new-release

        <sect1 id="epi-ext-adblocker">

                <title>Ad Blocker</title>

                

                <sect2 id="epi-ext-adblocker-intro">

                        <title>Introduccion</title>

                        

                        <para>The Ad Blocker extension lets you block ad banners on websites.

                        It avoids downloading them, saving time and bandwidth.</para>

                </sect2>

 

                <sect2 id="epi-ext-adblocker-usage">

                        <title>Using Ad Blocker</title>

                        

                        <para>To use the Ad Blocker, you have to enable the extension.

                        The extension will ignore link to ads when you visit websites, and      they won't 

                        be displayed in web pages.</para>

                        <para><application>Epiphany</application> will display an icon in left side of the status bar 

                        (see <xref linkend="epi-ext-figure-adblocker"/>) to inform you that it has 

                        blocked ads. If you move the mouse pointer over the icon, it will

                        give you the number of ads blocked in the page.</para>

                        <figure id="epi-ext-figure-adblocker">

                          <title>The Ad Blocker icon</title>

                <screenshot>

                  <mediaobject>

                    <imageobject>

                      <imagedata fileref="figures/epi-ext-adblocker.png" format="PNG"/>

                    </imageobject>

                  </mediaobject>

                </screenshot>

                        </figure>

                </sect2>

 

                <sect2 id="epi-ext-adblocker-usage-extend">

                                <title>Extend Ad Blocker</title>

 

                                <para>Ad Blocker should block most of the advertisement on the

                                web, but if you find that some banners are not blocked or Ad

                                Blocker is too restrictive, you can     tune Ad Blocker extension to

                                match your needs.

                                </para>

                                <para>Ad Blocker uses Perl regular expressions to match known URLs of

                                ads servers and common words used in URLs of ads. Ad Blocker

                                stores the system-wide rules in the file

                                <filename>adblock-patterns</filename> located in <filename class="directory">$PREFIX/share/epiphany-extensions/</filename>;

                                one regular     expression per line. 

                                </para>

 

                                <sect3 id="epi-ext-adblocker-usage-extend-blacklist">

                                        <title>Add a deny rule</title>

 

                                        <para>If you want to block an ad not blocked by the Ad

                                        Blocker default rules, you may create a blacklist file, and

                                        add rules inside.</para>

                                        <para><application>Epiphany</application> looks for the blacklist rules in the file 

                                        <filename>$HOME/.gnome2/epiphany/extensions/data/adblock/blacklist</filename>.

                                        </para>

                                </sect3>

 

                                <sect3 id="epi-ext-adblocker-usage-extend-whitelist">

                                        <title>Add a permit rule</title>

 

                                        <para>If you want allow to permit an ad to be displayed or

                                        correct a rule of Ad Blocker which is too restrictive, you can

                                        create a whitelist file, and add rules inside.</para>

                                        <para><application>Epiphany</application> looks for white-list rules in the file 

                                        <filename>$HOME/.gnome2/epiphany/extensions/data/adblock/whitelist</filename>.

                                        </para>

                                </sect3>

                </sect2>

        </sect1>