doc/webserver/user-manual/quickstart.html

   1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN""http://www.w3.org/TR/html4/loose.dtd">
   2 <HTML
   3 ><HEAD
   4 ><TITLE
   5 >Quickstart to Using Privoxy</TITLE
   6 ><META
   7 NAME="GENERATOR"
   8 CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK
   9 REL="HOME"
  10 TITLE="Privoxy 3.0.27 User Manual"
  11 HREF="index.html"><LINK
  12 REL="PREVIOUS"
  13 TITLE="What's New in this Release"
  14 HREF="whatsnew.html"><LINK
  15 REL="NEXT"
  16 TITLE="Starting Privoxy"
  17 HREF="startup.html"><LINK
  18 REL="STYLESHEET"
  19 TYPE="text/css"
  20 HREF="../p_doc.css"><META
  21 HTTP-EQUIV="Content-Type"
  22 CONTENT="text/html;
  23 charset=ISO-8859-1">
  24 <LINK REL="STYLESHEET" TYPE="text/css" HREF="p_doc.css">
  25 </head
  26 ><BODY
  27 CLASS="SECT1"
  28 BGCOLOR="#EEEEEE"
  29 TEXT="#000000"
  30 LINK="#0000FF"
  31 VLINK="#840084"
  32 ALINK="#0000FF"
  33 ><DIV
  34 CLASS="NAVHEADER"
  35 ><TABLE
  36 SUMMARY="Header navigation table"
  37 WIDTH="100%"
  38 BORDER="0"
  39 CELLPADDING="0"
  40 CELLSPACING="0"
  41 ><TR
  42 ><TH
  43 COLSPAN="3"
  44 ALIGN="center"
  45 >Privoxy 3.0.27 User Manual</TH
  46 ></TR
  47 ><TR
  48 ><TD
  49 WIDTH="10%"
  50 ALIGN="left"
  51 VALIGN="bottom"
  52 ><A
  53 HREF="whatsnew.html"
  54 ACCESSKEY="P"
  55 >Prev</A
  56 ></TD
  57 ><TD
  58 WIDTH="80%"
  59 ALIGN="center"
  60 VALIGN="bottom"
  61 ></TD
  62 ><TD
  63 WIDTH="10%"
  64 ALIGN="right"
  65 VALIGN="bottom"
  66 ><A
  67 HREF="startup.html"
  68 ACCESSKEY="N"
  69 >Next</A
  70 ></TD
  71 ></TR
  72 ></TABLE
  73 ><HR
  74 ALIGN="LEFT"
  75 WIDTH="100%"></DIV
  76 ><DIV
  77 CLASS="SECT1"
  78 ><H1
  79 CLASS="SECT1"
  80 ><A
  81 NAME="QUICKSTART"
  82 >4. Quickstart to Using Privoxy</A
  83 ></H1
  84 ><P
  85 ></P
  86 ><UL
  87 ><LI
  88 ><P
  89 >  Install <SPAN
  90 CLASS="APPLICATION"
  91 >Privoxy</SPAN
  92 >. See the <A
  93 HREF="installation.html"
  94 >Installation Section</A
  95 > below for platform specific
  96   information.
  97  </P
  98 ></LI
  99 ><LI
 100 ><P
 101 >   Advanced users and those who want to offer <SPAN
 102 CLASS="APPLICATION"
 103 >Privoxy</SPAN
 104 >
 105    service to more than just their local machine should check the <A
 106 HREF="config.html"
 107 >main config file</A
 108 >, especially the <A
 109 HREF="config.html#ACCESS-CONTROL"
 110 >security-relevant</A
 111 > options. These are
 112    off by default.
 113   </P
 114 ></LI
 115 ><LI
 116 ><P
 117 >  Start <SPAN
 118 CLASS="APPLICATION"
 119 >Privoxy</SPAN
 120 >, if the installation program has
 121   not done this already (may vary according to platform). See the section
 122   <A
 123 HREF="startup.html"
 124 >Starting <SPAN
 125 CLASS="APPLICATION"
 126 >Privoxy</SPAN
 127 ></A
 128 >.
 129   </P
 130 ></LI
 131 ><LI
 132 ><P
 133 >   Set your browser to use <SPAN
 134 CLASS="APPLICATION"
 135 >Privoxy</SPAN
 136 > as HTTP and
 137    HTTPS (SSL)  <A
 138 HREF="http://en.wikipedia.org/wiki/Proxy_server"
 139 TARGET="_top"
 140 >proxy</A
 141 >
 142    by setting the proxy configuration for address of
 143    <TT
 144 CLASS="LITERAL"
 145 >127.0.0.1</TT
 146 > and port <TT
 147 CLASS="LITERAL"
 148 >8118</TT
 149 >.
 150    <SPAN
 151 CLASS="emphasis"
 152 ><I
 153 CLASS="EMPHASIS"
 154 >DO NOT</I
 155 ></SPAN
 156 > activate proxying for <TT
 157 CLASS="LITERAL"
 158 >FTP</TT
 159 > or
 160    any protocols besides HTTP and HTTPS (SSL) unless you intend to prevent your
 161    browser from using these protocols.
 162   </P
 163 ></LI
 164 ><LI
 165 ><P
 166 >    Flush your browser's disk and memory caches, to remove any cached ad images.
 167     If using <SPAN
 168 CLASS="APPLICATION"
 169 >Privoxy</SPAN
 170 > to manage
 171     <A
 172 HREF="http://en.wikipedia.org/wiki/Browser_cookie"
 173 TARGET="_top"
 174 >cookies</A
 175 >,
 176     you should remove any currently stored cookies too.
 177   </P
 178 ></LI
 179 ><LI
 180 ><P
 181 >   A default installation should provide a reasonable starting point for
 182    most. There will undoubtedly be occasions where you will want to adjust the
 183    configuration, but that can be dealt with as the need arises. Little
 184    to no initial configuration is required in most cases, you may want
 185    to enable the
 186    <A
 187 HREF="config.html#ENABLE-EDIT-ACTIONS"
 188 TARGET="_top"
 189 >web-based action editor</A
 190 > though.
 191    Be sure to read the warnings first.
 192   </P
 193 ><P
 194 >   See the <A
 195 HREF="configuration.html"
 196 >Configuration section</A
 197 > for more
 198    configuration options, and how to customize your installation.
 199    You might also want to look at the <A
 200 HREF="quickstart.html#QUICKSTART-AD-BLOCKING"
 201 >next section</A
 202 > for a quick
 203    introduction to how <SPAN
 204 CLASS="APPLICATION"
 205 >Privoxy</SPAN
 206 > blocks ads and
 207    banners.</P
 208 ></LI
 209 ><LI
 210 ><P
 211 >    If you experience ads that slip through, innocent images that are
 212     blocked, or otherwise feel the need to fine-tune
 213     <SPAN
 214 CLASS="APPLICATION"
 215 >Privoxy's</SPAN
 216 > behavior, take a look at the <A
 217 HREF="actions-file.html"
 218 >actions files</A
 219 >. As a quick start, you might
 220     find the <A
 221 HREF="actions-file.html#ACT-EXAMPLES"
 222 >richly commented examples</A
 223 >
 224     helpful. You can also view and edit the actions files through the <A
 225 HREF="http://config.privoxy.org"
 226 TARGET="_top"
 227 >web-based user interface</A
 228 >. The
 229     Appendix <SPAN
 230 CLASS="QUOTE"
 231 >"<A
 232 HREF="appendix.html#ACTIONSANAT"
 233 >Troubleshooting: Anatomy of an
 234     Action</A
 235 >"</SPAN
 236 > has hints on how to understand and debug actions that
 237     <SPAN
 238 CLASS="QUOTE"
 239 >"misbehave"</SPAN
 240 >.
 241   </P
 242 ></LI
 243 ><LI
 244 ><P
 245 >   Please see the section <A
 246 HREF="contact.html"
 247 >Contacting the
 248    Developers</A
 249 > on how to report bugs, problems with websites or to get
 250    help.
 251   </P
 252 ></LI
 253 ><LI
 254 ><P
 255 >   Now enjoy surfing with enhanced control, comfort and privacy!
 256   </P
 257 ></LI
 258 ></UL
 259 ><DIV
 260 CLASS="SECT2"
 261 ><H2
 262 CLASS="SECT2"
 263 ><A
 264 NAME="QUICKSTART-AD-BLOCKING"
 265 >4.1. Quickstart to Ad Blocking</A
 266 ></H2
 267 ><P
 268 > Ad blocking is but one of <SPAN
 269 CLASS="APPLICATION"
 270 >Privoxy's</SPAN
 271 >
 272  array of features. Many of these features are for the technically minded advanced
 273  user. But, ad and banner blocking is surely common ground for everybody.</P
 274 ><P
 275 > This section will provide a quick summary of ad blocking so
 276  you can get up to speed quickly without having to read the more extensive
 277  information provided below, though this is highly recommended.</P
 278 ><P
 279 > First a bit of a warning ... blocking ads is much like blocking SPAM: the
 280  more aggressive you are about it, the more likely you are to block
 281  things that were not intended. And the more likely that some things
 282  may not work as intended. So there is a trade off here. If you want
 283  extreme ad free browsing, be prepared to deal with more
 284  <SPAN
 285 CLASS="QUOTE"
 286 >"problem"</SPAN
 287 > sites, and to spend more time adjusting the
 288  configuration to solve these unintended consequences. In short, there is
 289  not an easy way to eliminate <SPAN
 290 CLASS="emphasis"
 291 ><I
 292 CLASS="EMPHASIS"
 293 >all</I
 294 ></SPAN
 295 > ads. Either take
 296  the easy way and settle for <SPAN
 297 CLASS="emphasis"
 298 ><I
 299 CLASS="EMPHASIS"
 300 >most</I
 301 ></SPAN
 302 > ads blocked with the
 303  default configuration, or jump in and tweak it for your personal surfing
 304  habits and preferences.</P
 305 ><P
 306 > Secondly, a brief explanation of <SPAN
 307 CLASS="APPLICATION"
 308 >Privoxy's </SPAN
 309 >
 310  <SPAN
 311 CLASS="QUOTE"
 312 >"actions"</SPAN
 313 >. <SPAN
 314 CLASS="QUOTE"
 315 >"Actions"</SPAN
 316 > in this context, are
 317  the directives we use to tell <SPAN
 318 CLASS="APPLICATION"
 319 >Privoxy</SPAN
 320 > to perform
 321  some task relating to HTTP transactions (i.e. web browsing). We tell
 322  <SPAN
 323 CLASS="APPLICATION"
 324 >Privoxy</SPAN
 325 > to take some <SPAN
 326 CLASS="QUOTE"
 327 >"action"</SPAN
 328 >. Each
 329  action has a unique name and function. While there are many potential
 330  <SPAN
 331 CLASS="APPLICATION"
 332 >actions</SPAN
 333 > in <SPAN
 334 CLASS="APPLICATION"
 335 >Privoxy's</SPAN
 336 >
 337  arsenal, only a few are used for ad blocking. <A
 338 HREF="actions-file.html#ACTIONS"
 339 >Actions</A
 340 >, and <A
 341 HREF="actions-file.html"
 342 >action
 343  configuration files</A
 344 >, are explained in depth below.</P
 345 ><P
 346 > Actions are specified in <SPAN
 347 CLASS="APPLICATION"
 348 >Privoxy's</SPAN
 349 > configuration,
 350  followed by one or more URLs to which the action should apply. URLs
 351  can actually be URL type <A
 352 HREF="actions-file.html#AF-PATTERNS"
 353 >patterns</A
 354 > that use
 355  wildcards so they can apply potentially to a range of similar URLs. The
 356  actions, together with the URL patterns are called a section.</P
 357 ><P
 358 > When you connect to a website, the full URL will either match one or more
 359  of the sections as defined in <SPAN
 360 CLASS="APPLICATION"
 361 >Privoxy's</SPAN
 362 > configuration,
 363  or not. If so, then <SPAN
 364 CLASS="APPLICATION"
 365 >Privoxy</SPAN
 366 > will perform the
 367  respective actions. If not, then nothing special happens. Furthermore, web
 368  pages may contain embedded, secondary URLs that your web browser will
 369  use to load additional components of the page, as it parses the
 370  original page's HTML content. An ad image for instance, is just an URL
 371  embedded in the page somewhere. The image itself may be on the same server,
 372  or a server somewhere else on the Internet. Complex web pages will have many
 373  such embedded URLs. <SPAN
 374 CLASS="APPLICATION"
 375 >Privoxy</SPAN
 376 > can deal with each URL individually, so, for
 377  instance, the main page text is not touched, but images from such-and-such
 378  server are blocked.</P
 379 ><P
 380 > The most important actions for basic ad blocking are:  <TT
 381 CLASS="LITERAL"
 382 ><A
 383 HREF="actions-file.html#BLOCK"
 384 >block</A
 385 ></TT
 386 >, <TT
 387 CLASS="LITERAL"
 388 ><A
 389 HREF="actions-file.html#HANDLE-AS-IMAGE"
 390 >handle-as-image</A
 391 ></TT
 392 >,
 393  <TT
 394 CLASS="LITERAL"
 395 ><A
 396 HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
 397 >handle-as-empty-document</A
 398 ></TT
 399 >,and
 400  <TT
 401 CLASS="LITERAL"
 402 ><A
 403 HREF="actions-file.html#SET-IMAGE-BLOCKER"
 404 >set-image-blocker</A
 405 ></TT
 406 >:</P
 407 ><P
 408 ></P
 409 ><UL
 410 ><LI
 411 ><P
 412 >   <TT
 413 CLASS="LITERAL"
 414 ><A
 415 HREF="actions-file.html#BLOCK"
 416 >block</A
 417 ></TT
 418 > - this is perhaps
 419    the single most used action, and is particularly important for ad blocking.
 420    This action stops any contact between your browser and any URL patterns
 421    that match this action's configuration. It can be used for blocking ads,
 422    but also anything that is determined to be unwanted. By itself, it simply
 423    stops any communication with the remote server and sends
 424    <SPAN
 425 CLASS="APPLICATION"
 426 >Privoxy</SPAN
 427 >'s own built-in BLOCKED page instead to
 428    let you now what has happened (with some exceptions, see below).
 429   </P
 430 ></LI
 431 ><LI
 432 ><P
 433 >   <TT
 434 CLASS="LITERAL"
 435 ><A
 436 HREF="actions-file.html#HANDLE-AS-IMAGE"
 437 >handle-as-image</A
 438 ></TT
 439 > -
 440    tells <SPAN
 441 CLASS="APPLICATION"
 442 >Privoxy</SPAN
 443 > to treat this URL as an image.
 444    <SPAN
 445 CLASS="APPLICATION"
 446 >Privoxy</SPAN
 447 >'s default configuration already does this
 448    for all common image types (e.g. GIF), but there are many situations where this
 449    is not so easy to determine. So we'll force it in these cases. This is particularly
 450    important for ad blocking, since  only if we know that it's an image of
 451    some kind, can we replace it with an image of our choosing, instead of the
 452    <SPAN
 453 CLASS="APPLICATION"
 454 >Privoxy</SPAN
 455 > BLOCKED page (which would only result in
 456    a <SPAN
 457 CLASS="QUOTE"
 458 >"broken image"</SPAN
 459 > icon). There are some limitations to this
 460    though. For instance, you can't just brute-force an image substitution for
 461    an entire HTML page in most situations.
 462   </P
 463 ></LI
 464 ><LI
 465 ><P
 466 >   <TT
 467 CLASS="LITERAL"
 468 ><A
 469 HREF="actions-file.html#HANDLE-AS-EMPTY-DOCUMENT"
 470 >handle-as-empty-document</A
 471 ></TT
 472 > -
 473    sends an empty document instead of <SPAN
 474 CLASS="APPLICATION"
 475 >Privoxy's</SPAN
 476 >
 477    normal BLOCKED HTML page. This is useful for file types that are neither
 478    HTML nor images, such as blocking JavaScript files.
 479   </P
 480 ></LI
 481 ><LI
 482 ><P
 483 >   <TT
 484 CLASS="LITERAL"
 485 ><A
 486 HREF="actions-file.html#SET-IMAGE-BLOCKER"
 487 >set-image-blocker</A
 488 ></TT
 489 > - tells
 490    <SPAN
 491 CLASS="APPLICATION"
 492 >Privoxy</SPAN
 493 > what to display in place of an ad image that
 494    has hit a block rule. For this to come into play, the URL must match a
 495    <TT
 496 CLASS="LITERAL"
 497 ><A
 498 HREF="actions-file.html#BLOCK"
 499 >block</A
 500 ></TT
 501 > action somewhere in the
 502    configuration, <SPAN
 503 CLASS="emphasis"
 504 ><I
 505 CLASS="EMPHASIS"
 506 >and</I
 507 ></SPAN
 508 >, it must also match an
 509    <TT
 510 CLASS="LITERAL"
 511 ><A
 512 HREF="actions-file.html#HANDLE-AS-IMAGE"
 513 >handle-as-image</A
 514 ></TT
 515 > action.
 516   </P
 517 ><P
 518 >   The configuration options on what to display instead of the ad are:
 519   </P
 520 ><P
 521 ></P
 522 ><TABLE
 523 BORDER="0"
 524 ><TBODY
 525 ><TR
 526 ><TD
 527 >       <SPAN
 528 CLASS="emphasis"
 529 ><I
 530 CLASS="EMPHASIS"
 531 >pattern</I
 532 ></SPAN
 533 > - a checkerboard pattern, so that an ad
 534     replacement is obvious. This is the default.
 535    </TD
 536 ></TR
 537 ></TBODY
 538 ></TABLE
 539 ><P
 540 ></P
 541 ><P
 542 ></P
 543 ><TABLE
 544 BORDER="0"
 545 ><TBODY
 546 ><TR
 547 ><TD
 548 >       <SPAN
 549 CLASS="emphasis"
 550 ><I
 551 CLASS="EMPHASIS"
 552 >blank</I
 553 ></SPAN
 554 > - A very small empty GIF image is displayed.
 555     This is the so-called <SPAN
 556 CLASS="QUOTE"
 557 >"invisible"</SPAN
 558 > configuration option.
 559    </TD
 560 ></TR
 561 ></TBODY
 562 ></TABLE
 563 ><P
 564 ></P
 565 ><P
 566 ></P
 567 ><TABLE
 568 BORDER="0"
 569 ><TBODY
 570 ><TR
 571 ><TD
 572 >       <SPAN
 573 CLASS="emphasis"
 574 ><I
 575 CLASS="EMPHASIS"
 576 >http://&#60;URL&#62;</I
 577 ></SPAN
 578 > - A redirect to any image anywhere
 579     of the user's choosing (advanced usage).
 580    </TD
 581 ></TR
 582 ></TBODY
 583 ></TABLE
 584 ><P
 585 ></P
 586 ></LI
 587 ></UL
 588 ><P
 589 > Advanced users will eventually want to explore <SPAN
 590 CLASS="APPLICATION"
 591 >Privoxy</SPAN
 592 >
 593  <TT
 594 CLASS="LITERAL"
 595 ><A
 596 HREF="actions-file.html#FILTER"
 597 >filters</A
 598 ></TT
 599 > as well. Filters
 600  are very different from <TT
 601 CLASS="LITERAL"
 602 ><A
 603 HREF="actions-file.html#BLOCK"
 604 >blocks</A
 605 ></TT
 606 >.
 607  A <SPAN
 608 CLASS="QUOTE"
 609 >"block"</SPAN
 610 > blocks a site, page, or unwanted contented. Filters
 611  are a way of filtering or modifying what is actually on the page. An example
 612  filter usage: a text replacement of <SPAN
 613 CLASS="QUOTE"
 614 >"no-no"</SPAN
 615 > for
 616  <SPAN
 617 CLASS="QUOTE"
 618 >"nasty-word"</SPAN
 619 >. That is a very simple example. This process can be
 620  used for ad blocking, but it is more in the realm of advanced usage and has
 621  some pitfalls to be wary off.</P
 622 ><P
 623 > The quickest way to adjust any of these settings is with your browser through
 624  the special <SPAN
 625 CLASS="APPLICATION"
 626 >Privoxy</SPAN
 627 > editor at <A
 628 HREF="http://config.privoxy.org/show-status"
 629 TARGET="_top"
 630 >http://config.privoxy.org/show-status</A
 631 >
 632  (shortcut: <A
 633 HREF="http://p.p/"
 634 TARGET="_top"
 635 >http://p.p/show-status</A
 636 >). This
 637  is an internal page, and does not require Internet access.</P
 638 ><P
 639 > Note that as of <SPAN
 640 CLASS="APPLICATION"
 641 >Privoxy</SPAN
 642 > 3.0.7 beta the
 643  action editor is disabled by default. Check the
 644  <A
 645 HREF="config.html#ENABLE-EDIT-ACTIONS"
 646 TARGET="_top"
 647 >enable-edit-actions
 648   section in the configuration file</A
 649 > to learn why and in which
 650  cases it's safe to enable again.</P
 651 ><P
 652 > If you decided to enable the action editor, select the appropriate
 653  <SPAN
 654 CLASS="QUOTE"
 655 >"actions"</SPAN
 656 > file, and click
 657  <SPAN
 658 CLASS="QUOTE"
 659 >"<SPAN
 660 CLASS="GUIBUTTON"
 661 >Edit</SPAN
 662 >"</SPAN
 663 >. It is best to put personal or
 664  local preferences in <TT
 665 CLASS="FILENAME"
 666 >user.action</TT
 667 > since this is not
 668  meant to be overwritten during upgrades, and will over-ride the settings in
 669  other files. Here you can insert new <SPAN
 670 CLASS="QUOTE"
 671 >"actions"</SPAN
 672 >, and URLs for ad
 673  blocking or other purposes, and make other adjustments to the configuration.
 674  <SPAN
 675 CLASS="APPLICATION"
 676 >Privoxy</SPAN
 677 > will detect these changes automatically.</P
 678 ><P
 679 > A quick and simple step by step example:</P
 680 ><P
 681 ></P
 682 ><UL
 683 ><LI
 684 ><P
 685 >     Right click on the ad image to be blocked, then select
 686      <SPAN
 687 CLASS="QUOTE"
 688 >"<SPAN
 689 CLASS="GUIMENUITEM"
 690 >Copy Link Location</SPAN
 691 >"</SPAN
 692 > from the
 693      pop-up menu.
 694    </P
 695 ></LI
 696 ><LI
 697 ><P
 698 >    Set your browser to
 699     <A
 700 HREF="http://config.privoxy.org/show-status"
 701 TARGET="_top"
 702 >http://config.privoxy.org/show-status</A
 703 >
 704    </P
 705 ></LI
 706 ><LI
 707 ><P
 708 >    Find <TT
 709 CLASS="FILENAME"
 710 >user.action</TT
 711 > in the top section, and click
 712     on <SPAN
 713 CLASS="QUOTE"
 714 >"<SPAN
 715 CLASS="GUIBUTTON"
 716 >Edit</SPAN
 717 >"</SPAN
 718 >:
 719    </P
 720 ><DIV
 721 CLASS="FIGURE"
 722 ><A
 723 NAME="AEN640"
 724 ></A
 725 ><P
 726 ><B
 727 >Figure 1. Actions Files in Use</B
 728 ></P
 729 ><DIV
 730 CLASS="MEDIAOBJECT"
 731 ><P
 732 ><IMG
 733 SRC="files-in-use.jpg"></P
 734 ></DIV
 735 ></DIV
 736 ></LI
 737 ><LI
 738 ><P
 739 >   You should have a section with only
 740    <TT
 741 CLASS="LITERAL"
 742 ><A
 743 HREF="actions-file.html#BLOCK"
 744 >block</A
 745 ></TT
 746 > listed under
 747    <SPAN
 748 CLASS="QUOTE"
 749 >"Actions:"</SPAN
 750 >.
 751    If not, click a <SPAN
 752 CLASS="QUOTE"
 753 >"<SPAN
 754 CLASS="GUIBUTTON"
 755 >Insert new section below</SPAN
 756 >"</SPAN
 757 >
 758    button, and in the new section that just appeared, click the
 759    <SPAN
 760 CLASS="GUIBUTTON"
 761 >Edit</SPAN
 762 > button right under the word <SPAN
 763 CLASS="QUOTE"
 764 >"Actions:"</SPAN
 765 >.
 766    This will bring up a list of all actions. Find
 767    <TT
 768 CLASS="LITERAL"
 769 ><A
 770 HREF="actions-file.html#BLOCK"
 771 >block</A
 772 ></TT
 773 > near the top, and click
 774    in the <SPAN
 775 CLASS="QUOTE"
 776 >"Enabled"</SPAN
 777 > column, then <SPAN
 778 CLASS="QUOTE"
 779 >"<SPAN
 780 CLASS="GUIBUTTON"
 781 >Submit</SPAN
 782 >"</SPAN
 783 >
 784    just below the list.
 785   </P
 786 ></LI
 787 ><LI
 788 ><P
 789 >   Now, in the <TT
 790 CLASS="LITERAL"
 791 ><A
 792 HREF="actions-file.html#BLOCK"
 793 >block</A
 794 ></TT
 795 > actions section,
 796    click the <SPAN
 797 CLASS="QUOTE"
 798 >"<SPAN
 799 CLASS="GUIBUTTON"
 800 >Add</SPAN
 801 >"</SPAN
 802 > button, and paste the URL the
 803    browser got from <SPAN
 804 CLASS="QUOTE"
 805 >"<SPAN
 806 CLASS="GUIMENUITEM"
 807 >Copy Link Location</SPAN
 808 >"</SPAN
 809 >.
 810    Remove the <TT
 811 CLASS="LITERAL"
 812 >http://</TT
 813 > at the beginning of the URL. Then, click
 814    <SPAN
 815 CLASS="QUOTE"
 816 >"<SPAN
 817 CLASS="GUIBUTTON"
 818 >Submit</SPAN
 819 >"</SPAN
 820 > (or
 821    <SPAN
 822 CLASS="QUOTE"
 823 >"<SPAN
 824 CLASS="GUIBUTTON"
 825 >OK</SPAN
 826 >"</SPAN
 827 > if in a pop-up window).
 828   </P
 829 ></LI
 830 ><LI
 831 ><P
 832 >   Now go back to the original page, and press <B
 833 CLASS="KEYCAP"
 834 >SHIFT-Reload</B
 835 >
 836    (or flush all browser caches). The image should be gone now.
 837   </P
 838 ></LI
 839 ></UL
 840 ><P
 841 > This is a very crude and simple example. There might be good reasons to use a
 842  wildcard pattern match to include potentially similar images from the same
 843  site. For a more extensive explanation of <SPAN
 844 CLASS="QUOTE"
 845 >"patterns"</SPAN
 846 >, and
 847  the entire actions concept, see <A
 848 HREF="actions-file.html"
 849 >the Actions
 850  section</A
 851 >.</P
 852 ><P
 853 > For advanced users who want to hand edit their config files, you might want
 854  to now go to the <A
 855 HREF="actions-file.html#ACT-EXAMPLES"
 856 >Actions Files Tutorial</A
 857 >.
 858  The ideas explained therein also apply to the web-based editor.</P
 859 ><P
 860 > There are also various
 861  <A
 862 HREF="actions-file.html#FILTER"
 863 >filters</A
 864 > that can be used for ad blocking
 865  (filters are a special subset of actions). These
 866  fall into the <SPAN
 867 CLASS="QUOTE"
 868 >"advanced"</SPAN
 869 > usage category, and are explained in
 870  depth in later sections.</P
 871 ></DIV
 872 ></DIV
 873 ><DIV
 874 CLASS="NAVFOOTER"
 875 ><HR
 876 ALIGN="LEFT"
 877 WIDTH="100%"><TABLE
 878 SUMMARY="Footer navigation table"
 879 WIDTH="100%"
 880 BORDER="0"
 881 CELLPADDING="0"
 882 CELLSPACING="0"
 883 ><TR
 884 ><TD
 885 WIDTH="33%"
 886 ALIGN="left"
 887 VALIGN="top"
 888 ><A
 889 HREF="whatsnew.html"
 890 ACCESSKEY="P"
 891 >Prev</A
 892 ></TD
 893 ><TD
 894 WIDTH="34%"
 895 ALIGN="center"
 896 VALIGN="top"
 897 ><A
 898 HREF="index.html"
 899 ACCESSKEY="H"
 900 >Home</A
 901 ></TD
 902 ><TD
 903 WIDTH="33%"
 904 ALIGN="right"
 905 VALIGN="top"
 906 ><A
 907 HREF="startup.html"
 908 ACCESSKEY="N"
 909 >Next</A
 910 ></TD
 911 ></TR
 912 ><TR
 913 ><TD
 914 WIDTH="33%"
 915 ALIGN="left"
 916 VALIGN="top"
 917 >What's New in this Release</TD
 918 ><TD
 919 WIDTH="34%"
 920 ALIGN="center"
 921 VALIGN="top"
 922 >&nbsp;</TD
 923 ><TD
 924 WIDTH="33%"
 925 ALIGN="right"
 926 VALIGN="top"
 927 >Starting Privoxy</TD
 928 ></TR
 929 ></TABLE
 930 ></DIV
 931 ></BODY
 932 ></HTML
 933 >