-.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
-
- ## Turn some actions on ################################
- ## NOTE: Actions are off by default, unless explictily turned on
- ## otherwise with the '+' operator.
-
-{ \\
-+change-x-forwarded-for{block} \\
-+deanimate-gifs{last} \\
-+filter{refresh-tags} \\
-+filter{img-reorder} \\
-+filter{banners-by-size} \\
-+filter{webbugs} \\
-+filter{jumping-windows} \\
-+filter{ie-exploits} \\
-+hide-from-header{block} \\
-+hide-referrer{conditional-block} \\
-+session-cookies-only \\
-+set-image-blocker{pattern} \\
-}
-/ # '/' 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 break 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.