<html xmlns="http://www.w3.org/1999/xhtml" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
<meta name="description" content="HTTrack is an easy-to-use website mirror utility. It allows you to download a World Wide website from the Internet to a local directory,building recursively all structures, getting html, images, and other files from the server to your computer. Links are rebuiltrelatively so that you can freely browse to the local site (works with any browser). You can mirror several sites together so that you can jump from one toanother. You can, also, update an existing mirror site, or resume an interrupted download. The robot is fully configurable, with an integrated help" />
<meta name="keywords" content="httrack, HTTRACK, HTTrack, winhttrack, WINHTTRACK, WinHTTrack, offline browser, web mirror utility, aspirateur web, surf offline, web capture, www mirror utility, browse offline, local site builder, website mirroring, aspirateur www, internet grabber, capture de site web, internet tool, hors connexion, unix, dos, windows 95, windows 98, solaris, ibm580, AIX 4.0, HTS, HTGet, web aspirator, web aspirateur, libre, GPL, GNU, free software" />
<title>HTTrack Website Copier - Offline Browser</title>
<style type="text/css">
<!--
body {
margin: 0; padding: 0; margin-bottom: 15px; margin-top: 8px;
background: #77b;
}
body, td {
font: 14px "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif;
}
#subTitle {
background: #000; color: #fff; padding: 4px; font-weight: bold;
}
#siteNavigation a, #siteNavigation .current {
font-weight: bold; color: #448;
}
#siteNavigation a:link { text-decoration: none; }
#siteNavigation a:visited { text-decoration: none; }
#siteNavigation .current { background-color: #ccd; }
#siteNavigation a:hover { text-decoration: none; background-color: #fff; color: #000; }
#siteNavigation a:active { text-decoration: none; background-color: #ccc; }
a:link { text-decoration: underline; color: #00f; }
a:visited { text-decoration: underline; color: #000; }
a:hover { text-decoration: underline; color: #c00; }
a:active { text-decoration: underline; }
#pageContent {
clear: both;
border-bottom: 6px solid #000;
padding: 10px; padding-top: 20px;
line-height: 1.65em;
background-image: url(images/bg_rings.gif);
background-repeat: no-repeat;
background-position: top right;
}
#pageContent, #siteNavigation {
background-color: #ccd;
}
.imgLeft { float: left; margin-right: 10px; margin-bottom: 10px; }
.imgRight { float: right; margin-left: 10px; margin-bottom: 10px; }
hr { height: 1px; color: #000; background-color: #000; margin-bottom: 15px; }
h1 { margin: 0; font-weight: bold; font-size: 2em; }
h2 { margin: 0; font-weight: bold; font-size: 1.6em; }
h3 { margin: 0; font-weight: bold; font-size: 1.3em; }
h4 { margin: 0; font-weight: bold; font-size: 1.18em; }
.blak { background-color: #000; }
.hide { display: none; }
.tableWidth { min-width: 400px; }
.tblRegular { border-collapse: collapse; }
.tblRegular td { padding: 6px; background-image: url(fade.gif); border: 2px solid #99c; }
.tblHeaderColor, .tblHeaderColor td { background: #99c; }
.tblNoBorder td { border: 0; }
// -->
</style>
</head>
<table width="76%" border="0" align="center" cellspacing="0" cellpadding="0" class="tableWidth">
<tr>
<td><img src="images/header_title_4.gif" width="400" height="34" alt="HTTrack Website Copier" title="" border="0" id="title" /></td>
</tr>
</table>
<table width="76%" border="0" align="center" cellspacing="0" cellpadding="3" class="tableWidth">
<tr>
<td id="subTitle">Open Source offline browser</td>
</tr>
</table>
<table width="76%" border="0" align="center" cellspacing="0" cellpadding="0" class="tableWidth">
<tr class="blak">
<td>
<table width="100%" border="0" align="center" cellspacing="1" cellpadding="0">
<tr>
<td colspan="6">
<table width="100%" border="0" align="center" cellspacing="0" cellpadding="10">
<tr>
<td id="pageContent">
<!-- ==================== End prologue ==================== -->
<h2 align="center"><em>Filters: Advanced</em></h2>
<br>
See also: The <a href="faq.html#VF1">FAQ</a><br>
<br>
<i>You have to know that once you have defined
starts links, the default mode is to mirror these links - i.e. if one of your start page is
www.someweb.com/test/index.html, all links starting with www.someweb.com/test/ will be
accepted. But links directly in www.someweb.com/.. will not be accepted, however, because
they are in a higher strcuture. This prevent HTTrack from mirroring the whole site. (All
files in structure levels equal or lower than the primary links will be retrieved.)<br>
</i>
<br>
<b>But</b> you may want to download files that are not directly in the subfolders, or on the
contrary refuse files of a particular type. That is the purpose of filters.
<br>
<br>
To accept a family of links (for example, all links with a specific name or type), you just have to add
an authorization filter, like <b><tt>+*.gif</tt></b>. The pattern is a plus (this one: <b><tt>+</tt></b>),
followed by a pattern composed of letters and wildcards (this one: <b><tt>*</tt></b>).
<br><br>
To forbide a family of links, define
an authorization filter, like <b><tt>-*.gif</tt></b>. The pattern is a dash (this one: <b><tt>-</tt></b>),
followed by a the same kind of pattern as for the authorization filter.
<br><br>
Example: +*.gif will accept all files finished by .gif<br>
Example: -*.gif will refuse all files finished by .gif<br>
<br>
<br>
<u>Let's talk a little more about patterns:</u>
<br>
Filters are analyzed by HTTrack from the first filter to the last one. The complete URL
name is compared to filters defined by the user or added automatically by HTTrack. <br><br>
A link has an higher priority than the one before it - hierarchy is important: <br>
<br>
<table BORDER="1" CELLPADDING="2">
<tr><td>
<tt>+*.gif -image*.gif</tt>
</td><td>
Will accept all gif files BUT image1.gif,imageblue.gif,imagery.gif and so on
</tr>
<tr><td>
<tt>-image*.gif +*.gif</tt>
</td><td>
Will accept all gif files, because the second pattern is prioritary (because it is defined AFTER the first one)
</tr>
</table>
<br>
<br>
We saw that patterns are composed of letters and wildcards (<b><tt>*</tt></b>), as in */image*.gif
<p align="JUSTIFY"><br>
Special wild cards can be used for specific characters: (*[..])</p>
<table BORDER="1" CELLPADDING="2">
<tr>
<td><tt>*</tt></td>
<td>any characters (the most commonly used)</td>
</tr>
<tr>
<td><tt>*[file] or *[name]</tt></td>
<td>any filename or name, e.g. not /,? and ; characters</td>
</tr>
<tr>
<td><tt>*[path]</tt></td>
<td>any path (and filename), e.g. not ? and ; characters</td>
</tr>
<tr>
<td><tt>*[a,z,e,r,t,y]</tt></td>
<td>any letters among a,z,e,r,t,y</td>
</tr>
<tr>
<td><tt>*[a-z]</tt></td>
<td>any letters</td>
</tr>
<tr>
<td><tt>*[0-9,a,z,e,r,t,y]</tt></td>
<td>any characters among 0..9 and a,z,e,r,t,y</td>
</tr>
<tr>
<td><tt>*[]</tt></td>
<td>no characters must be present after</a></td>
</tr>
<tr>
<td><tt>*[<NN]</tt></td>
<td>the file size must be smaller than NN KB
<br>(note: this may cause broken files during the download)</td>
</tr>
<tr>
<td><tt>*[>NN]</tt></td>
<td>the file size must be greater than NN KB
<br>(note: this may cause broken files during the download)</td>
</tr>
<tr>
<td><tt>*[<NN>MM]</tt></td>
<td>the file size must be smaller than NN KB and greater than MM KB
<br>(note: this may cause broken files during the download)</td>
</tr>
</table>
<p align="JUSTIFY"><br>
Here are some examples of filters: (that can be generated automatically using the
interface)</p>
<table BORDER="1" CELLPADDING="2">
<tr>
<td><tt>www.thisweb.com* </tt></td>
<td>This will refuse/accept this web site (all links located in it will be rejected)</td>
</tr>
<tr>
<td><tt>*.com/*</tt></td>
<td>This will refuse/accept all links that contains .com in them</td>
</tr>
<tr>
<td><tt>*cgi-bin* </tt></td>
<td>This will refuse/accept all links that contains cgi-bin in them</td>
</tr>
<tr>
<td><tt>www.*[path].com/*[path].zip </tt></td>
<td>This will refuse/accept all zip files in .com addresses</td>
</tr>
<tr>
<td><tt>*someweb*/*.tar*</tt></td>
<td>This will refuse/accept all tar (or tar.gz etc.) files in hosts containing someweb</td>
</tr>
<tr>
<td><tt>*/*somepage*</tt></td>
<td>This will refuse/accept all links containing somepage (but not in the address)</td>
</tr>
<tr>
<td><tt>*.html</tt></td>
<td>This will refuse/accept all html files. <br>
Warning! With this filter you will accept ALL html files, even those in other addresses.
(causing a global (!) web mirror..) Use www.someweb.com/*.html to accept all html files from
a web.</td>
</tr>
<tr>
<td><tt>*.html*[]</tt></td>
<td>Identical to <tt>*.html</tt>, but the link must not have any supplemental characters
at the end (links with parameters, like <tt>www.someweb.com/index.html?page=10</tt>, will be
refused)</td>
</tr>
</table>
<br>
<!-- ==================== Start epilogue ==================== -->
</td>
</tr>
</table>
</td>
</tr>
</table>
</td>
</tr>
</table>
<table width="76%" border="0" align="center" valign="bottom" cellspacing="0" cellpadding="0">
<tr>
<td id="footer"><small>© 2003 Xavier Roche & other contributors - Web Design: Leto Kauler.</small></td>
</tr>
</table>
</body>
</html>
