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