-.SH "SAMPLE CONFIGURATION"
-.PP
-A brief example of what a simple \fIdefault.action\fR
-configuration might look like:
-
-.nf
- # Define a few useful custom aliases for later use
- {{alias}}
-
- # Useful aliases that combine more than one action
- +crunch-cookies = +crunch-incoming-cookies +crunch-outgoing-cookies
- -crunch-cookies = -crunch-incoming-cookies -crunch-outgoing-cookies
- +block-as-image = +block +handle-as-image
-
- # Fragile sites should have the minimum changes
- fragile = -block -deanimate-gifs -fast-redirects -filter \\
- -hide-referer -prevent-cookies -kill-popups
-
- ## Turn some actions on ################################
- ## NOTE: Actions are off by default, unless explictily turned on
- ## otherwise with the '+' operator.
-
-{ \\
--add-header \\
--block \\
--content-type-overwrite \\
--crunch-client-header \\
--crunch-if-none-match \\
--crunch-outgoing-cookies \\
--crunch-incoming-cookies \\
--crunch-server-header \\
-+deanimate-gifs{last} \\
--downgrade-http-version \\
--fast-redirects \\
--filter{js-annoyances} \\
--filter{js-events} \\
--filter{html-annoyances} \\
--filter{content-cookies} \\
-+filter{refresh-tags} \\
--filter{unsolicited-popups} \\
--filter{all-popups} \\
--filter{img-reorder} \\
--filter{banners-by-size} \\
--filter{banners-by-link} \\
-+filter{webbugs} \\
--filter{tiny-textforms} \\
-+filter{jumping-windows} \\
--filter{frameset-borders} \\
--filter{demoronizer} \\
--filter{shockwave-flash} \\
--filter{quicktime-kioskmode} \\
--filter{fun} \\
--filter{crude-parental} \\
-+filter{ie-exploits} \\
--filter{site-specifics} \\
--filter{google} \\
--filter{yahoo} \\
--filter{msn} \\
--filter{blogspot} \\
--filter{xml-to-html} \\
--filter{html-to-xml} \\
--filter-client-headers \\
--filter-server-headers \\
--force-text-mode \\
--handle-as-empty-document
--handle-as-image \\
--hide-accept-language \\
--hide-content-disposition \\
--hide-if-modified-since \\
-+hide-forwarded-for-headers \\
-+hide-from-header{block} \\
-+hide-referrer{forge} \\
--hide-user-agent \\
--inspect-jpegs \\
--kill-popups \\
--limit-connect \\
--overwrite-last-modified \\
--redirect \\
-+prevent-compression \\
--send-vanilla-wafer \\
--send-wafer \\
-+session-cookies-only \\
-+set-image-blocker{pattern} \\
--treat-forbidden-connects-like-blocks \\
-}
-/ # '/' Match *all* URL patterns
-
-
- # Block all URLs that match these patterns
- { +block }
- ad.
- ad[sv].
- .*ads.
- banner?.
- /.*count(er)?\\.(pl|cgi|exe|dll|asp|php[34]?)
- .hitbox.com
- media./.*(ads|banner)
-
- # Block, and treat these URL patterns as if they were 'images'.
- # We would expect these to be ads.
- { +block-as-image }
- .ad.doubleclick.net
- .a[0-9].yimg.com/(?:(?!/i/).)*$
- ad.*.doubleclick.net
-
- # Make exceptions for these harmless ones that would be
- # caught by our +block patterns just above.
- { -block }
- adsl.
- adobe.
- advice.
- .*downloads.
- # uploads or downloads
- /.*loads
-.fi
-.PP
-Then for a \fIuser.action\fR, we would put local,
-narrowly defined exceptions:
-
-.nf
- # Re-define aliases as needed here
- {{alias}}
-
- # Useful aliases
- -crunch-cookies = -crunch-incoming-cookies -crunch-outgoing-cookies
-
- # Set personal exceptions to the policies in default.action #######
-
- # Sites where we want persistent cookies, so allow *all* cookies
- { -crunch-cookies -session-cookies-only }
- .redhat.com
- .sun.com
- .msdn.microsoft.com
-
- # These sites breaks easily. Use our "fragile" alias here.
- { fragile }
- .forbes.com
- mybank.example.com
-
- # Replace example.com's style sheet with one of my choosing
- { +redirect{http://localhost/css-replacements/example.com.css} }
- example.com/stylesheet.css
-.fi
-.PP
-See the comments in the configuration files themselves, or the
-\fIUser Manual\fR
-for full explanations of the above syntax, and other \fBPrivoxy\fR
-configuration options.