w3mfix(1)
NAME
w3mfix - fixup program for w3mir
SYNOPSIS
w3mfix [options] [configuration-file]
DESCRIPTION
w3mfix is the companion program to w3mir. It can be used
for several URL editing operations usefull in different
situations.
When starting w3mfix will read it's configuration file.
It's name is either .w3mirc (w3mir.ini on win32) or speci
fied on the commandline.
w3mfix is controlled by the 'Fixup' directive of the con
figuration file (described in the w3mir documentation).
w3mfix is also affected by 'Index-name' and the one spe
cial commandline option it knows, as well as the direc
tives/options controlling verbosity and debugging informa
tion.
DESCRIPTION
w3mfix can rewrite URLs in these ways:
- * Rewrite URLs that resutled in redirects to point to the
place redirected to. This is needed in all cases and will
always be fixed by w3mfix.
* Change URLs ending in .../ into .../index.html (or
.../Welcome.html). This is, probably, not needed when the
mirror is meant do be used with a web-server. It is use
full for browsing directly from disk or CDROM, but in this
case it's, most often, required. To disable this specify
the noindex option with the 'Fixup' directive. - The default is to transform URLs ending in .../ into
.../index.html. - To controll the name of the index file use the Indexname directive as documented in w3mir
- * Change URL links to documents outside the mirror to
point to some local document. Could be usefull if the
mirror is destined for a CDROM to be used on a unconnected
machine. - THIS IS NOT YET IMPLEMENTED
- * Change URL links to documents that w3mir was unable/for
bidden to retrive to point to some local document. Point
ing these to a nice informative document is probably bet
ter than random error messages from the browser. - THIS IS NOT YET IMPLEMENTED
- * And, least, but far from last, w3mfix can be used to
prepare an established mirror for enlargement. - This feature is used thus: Add the new site or subsite
to be mirrored on the configuration file (by adding
Also: and Also-quene: directives). Then run w3mfix with the -editref option. When the -editref option is specified w3mfix will not perform any other editing
tasks. - E.g.; To add
http://www.yahoo.com/Science/Artificial_Life/ to your mirror add something like
Also: http://www.yahoo.com/Science/Artificial_Life/ yahoo - to the configuration file, then run w3mfix:
w3mfix -editref www.yahoo.com/Science/Arti- ficial_Life
- This will cause all references to www.yahoo.com/Sci_ ence/Artificial_Life (and under) to be edited so they point to within the mirror. After w3mfix has finished you can run w3mir in the normal manner.
BUGS
Naah.
SEE ALSO
w3mir
AUTHORS
w3mirs authors can be reached at w3mir-core@usit.uio.no.
w3mirs home page is at http://www.math.uio.no/~janl/w3mir/
__END__ # -*- perl -*- There must be a blank line here:
NAME
w3mfix - fixup program for w3mir
SYNOPSIS
w3mfix [options] [configuration-file]
DESCRIPTION
w3mfix is the companion program to w3mir. It can be used
for several URL editing operations usefull in different
situations.
When starting w3mfix will read it's configuration file.
It's name is either .w3mirc (w3mir.ini on win32) or speci
fied on the commandline.
w3mfix is controlled by the 'Fixup' directive of the con
figuration file (described in the w3mir documentation).
w3mfix is also affected by 'Index-name' and the one spe
cial commandline option it knows, as well as the direc
tives/options controlling verbosity and debugging informa
tion.
DESCRIPTION
w3mfix can rewrite URLs in these ways:
- * Rewrite URLs that resutled in redirects to point to the
place redirected to. This is needed in all cases and will
always be fixed by w3mfix.
* Change URLs ending in .../ into .../index.html (or
.../Welcome.html). This is, probably, not needed when the
mirror is meant do be used with a web-server. It is use
full for browsing directly from disk or CDROM, but in this
case it's, most often, required. To disable this specify
the noindex option with the 'Fixup' directive. - The default is to transform URLs ending in .../ into
.../index.html. - To controll the name of the index file use the Indexname directive as documented in w3mir
- * Change URL links to documents outside the mirror to
point to some local document. Could be usefull if the
mirror is destined for a CDROM to be used on a unconnected
machine. - THIS IS NOT YET IMPLEMENTED
- * Change URL links to documents that w3mir was unable/for
bidden to retrive to point to some local document. Point
ing these to a nice informative document is probably bet
ter than random error messages from the browser. - THIS IS NOT YET IMPLEMENTED
- * And, least, but far from last, w3mfix can be used to
prepare an established mirror for enlargement. - This feature is used thus: Add the new site or subsite
to be mirrored on the configuration file (by adding
Also: and Also-quene: directives). Then run w3mfix with the -editref option. When the -editref option is specified w3mfix will not perform any other editing
tasks. - E.g.; To add http://www.yahoo.com/Science/Artifi_
cial_Life/ to your mirror add something like
Also: http://www.yahoo.com/Science/Artificial_Life/ yahoo - to the configuration file, then run w3mfix:
w3mfix -editref www.yahoo.com/Science/Arti- ficial_Life
- This will cause all references to www.yahoo.com/Sci_ ence/Artificial_Life (and under) to be edited so they point to within the mirror. After w3mfix has finished you can run w3mir in the normal manner.
BUGS
Naah.
SEE ALSO
w3mir
AUTHORS
- w3mirs authors can be reached at w3mir-core@usit.uio.no.
w3mirs home page is at http://www.math.uio.no/~janl/w3mir/