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