********************************************************************************
NAOKO 4.5 CONFIG -- SIDKI 2004-04-11 -- README
********************************************************************************

This config should work with all Gecko Browsers and IE clones > 5.5 , Opera 7.x
(a few config features disabled), Netscape 4.x (many features disabled).
It may well be incompatible with IE 5.x or Opera 6 - I don't have these browsers
installed.
However, most of the time i use it with Firefox (nightly build).

While it might be set up to surf the web and forget about Proxomitron, it's
actually intended for people that are curious about what's happening under the
hood of webpages. Otherwise most of the displayed information can be considered
as overhead.

The set itself is a bit complex and hence likely to be difficult to maintain for
people new to Proxomitron.

********************************************************************************
Thanks!
********************************************************************************

JD for testing filters/configs, discussions, ideas, etc etc...

Mona for quite a few killer ideas and for sharing her config layout.

All who took the time testing the beta.

A great number of ideas came from Paul Rupe's config set:
http://www.geocities.com/u82011729/prox/

Jesse Ruderman's bookmarklets were a valuable resource for the Prox Toolbar:
http://www.squarefree.com/bookmarklets/

********************************************************************************
Installation
********************************************************************************

- Extract the zip into Proxomitron's main directory, preserving the zipped
  directory structure - WinZip, WinRar, 7Zip do that by default.
  No file will be overwritten.

- Load "sidki.ptron" from Proxomitron's main window or the tray menu.

- Adjust the window dimensions to your liking.

- Open "LISTS\sidki\CookieValues.ptxt" and below "IP Address Cookies -- Edit"
  replace the IP and IP alias matches with yours.

- If you use Yahoo! services, edit "Yahoo Login: Form Filler", replace
  "YOUR_NICK" and "YOUR_PW" with your personal data (keep the quotes).
  Activate the filter.

- If you want to use Proxomitron for the FTP protocol you need a proxy (local or
  remote) that "translates" FTP to HTTP. Most ISP proxies do that. Edit the
  "URL: 2 Proxy with FTP and Gopher" header filter, enter the IP address of your
  proxy, and activate that filter.

- In Proxomitron's main window, click File -> Save Config file.

- There is also a file "extras.zip" included. It contains optional replacements
  of default files and extras like bookmarklets etc. See "!extras_ReadMe.txt"
  for details.

- Start surfing!

********************************************************************************
Displaying information about filtered code (or not)
********************************************************************************

By default only important information will be displayed on pages. If you want to
see more, enable these filters:
"!|||||||||||| 4 Set Flag display standard"
"Show Position of removed Comments"
"Show Position of blocked Scripts"

If you don't like to see any information displayed at the bottom of the page,
disable:
"!|||||||||||| 3 Set Flag display important"
"Error Messages to Footer"
"Bottom Add: Print Cookies"

You can always show/hide the filter information with the "Toggle Kills"
bookmarklet or with "toggle kills" in the toolbar.

The majority of filters are set up for optional logging their hits to a file.
There are two levels: Rare or crucial hits are logged to LogRare.log (active by
default). Those and all other hits may also go timestamped to LogMain.log (by
default only active when pressing the "L" key). The responsible header filters
are:
"!|||||||||||| 5 Set Flag Log Main (L-Key) + Rare"
"!|||||||||||| 5 Set Flag Log Main + Rare"

********************************************************************************
The general include/exclude list "IncludeExclude.ptxt"
********************************************************************************

One central part of this config is the list "IncludeExclude.ptxt". It consists
of two main sections: "exclude (bypass)" and "include (block, fake)".
You will sooner or later need to add entries to that list. Each entry needs to
match *just once*.

Say you want to bypass all JavaScript filters on www.somesite.com/mypage/ but
there already is an entry:
www.somesite.com/  $SET(keyword=.prefix.)

Adding...
www.somesite.com/mypage/ $SET(keyword=.prefix.js.)
...won't work because "www.somesite.com/mypage/" is consumed by the first match.

So the correct way goes like:
www.somesite.com/(^mypage/) $SET(keyword=.prefix.)
www.somesite.com/mypage/ $SET(keyword=.prefix.js.)

********************************************************************************
Notes for Mozilla and Opera users
********************************************************************************

Some filters need to know what browser you are using to work properly. So, if
you are using a User-Agent switcher extension with Mozilla, make sure you set it
to the real UA while using this config.

At the time of this writing Opera defaults to content sniffing turned on. That
corresponds to "Determine action by file extension if MIME type is unreliable"
in the "File types" settings.
If you have "Determine action by MIME type" (i.e. "Trust Server Types=1" in
opera6.ini) activated instead, then enable in the Config Control section the
filter "Don't Sniff HTML Content in Opera".
From what I've heard the current Opera 7.5 beta doesn't seem to do content-
sniffing at all. If you use it, please turn on the above filter as well.

********************************************************************************
Random notes
********************************************************************************

Not exactly important but i like it: You can apply user stylesheets.
Scott's page - http://www.geocities.com/srl_list/index.html - is styled as an
example. Three W3C Core Styles are included -- See IncludeExclude.ptxt -> "use a
local stylesheet".

This config set uses non-standard file extensions: .ptron instead of .cfg, .ptxt
instead of .txt. The reason is that you can associate them with your texteditor
and, if it supports it, use Proxomitron-language syntax-highlighting for the two
filetypes. A regfile to open them in an editor and a highlight file for
UltraEdit is included in "extras.zip".

********************************************************************************
Filter abbreviations: name     version (I) [A] (R)
********************************************************************************

Info (I):
--------------------------------------------------------------------------------

!nn		Disabled for Netscape Navigator 4.x.

always		The filter always matches - which does *not* mean that it always
		alters the matched code.

cc!		This filter is controlled by the filters in the "Config Control"
		section.

defer		JavaScript Code that - if run in IE - is executed after the rest
		of the page is completely loaded.

edit!		Either the filter or the list it calls needs
		to be edited to be fully functional.

end		JavaScript Code that is inserted at the bottom of the HTML
		block.

endhdr		JavaScript Code that is inserted at the bottom of the HEAD
		block.

ie		Enabled for Internet Explorer only.

never		This filter doesn't alter the page code, but just sets a
		variable or ads something to a temporary blocklist. Hence it
		is set up to never match as a whole.

moz		Enabled for Mozilla only.

multi		The filter is set up to allow for multiple matches. IOW its
		replacement string can be matched again by the same (except for
		the first char) or other filters.

opera		Enabled for Opera only.

starthdr	JavaScript Code that is inserted at the top of the HEAD block.


Authors [A]:
--------------------------------------------------------------------------------

...		Several authors, mentioned in ProxFunctions.js or the Config
		Control section.
alto		altosax aka reversi
eah		Evgeny aka Homeric
felix
gd		George Dorn
gz		Greg Zumwalt
henk
hp		hpguru
jd		JD5000
jor
mb		Michael Brschgens
mona
pr		Paul Rupe
s		sidki
scojo
snail		The Snail
srl		Scott R. Lemmon
th		TEggHead aka JarC
unk		unknown

Ranking (R):
--------------------------------------------------------------------------------

d.		defaults to on
o.		defaults to off

.r		required for other filters to work
.s		site specific

.0		~zero risk to break pages
.1
.2
.3		considerable risk to break pages

********************************************************************************
Actions for pressed keys
********************************************************************************

B		bypasses all filters.

F		toggles the two cache related header filter combos to force
		getting a fresh copy of all resources for a page.

ALT		bypasses the URL blocking header filters.

L		logs filter hits to LogMain.log.

R		prevents instant meta-refreshes and the auto-submit code in the
		"Yahoo Login: Form Filler" filter


Have fun :)
sidki
