mirror of
https://github.com/xroche/httrack.git
synced 2026-07-23 17:19:17 +03:00
db31be5a6c
* Add a task-oriented command-line guide to the offline docs The command-line docs so far are the option list and the generated manual page: exhaustive, but organized by flag, not by task. Newcomers arrive expecting wget/curl syntax and hit the same walls (only the index came down, filters that do the opposite of what they read, an update that deletes files), because the reference answers "what does -X do", not "how do I do the thing I want". cmdguide.html is a task-oriented layer on top of the manual page: quick start, scope, filters, limits, naming, links, identity/login, proxy, update/cache, scripting, then eleven copy-ready recipes with the one gotcha each. It foregrounds the defaults that actually surprise people (the ~100 KB/s rate cap, the -c/-A/-%c security clamps, --update purge semantics, the depth off-by-one, mime filters running after headers) and links the manual page for per-option detail. Linked from cmddoc.html and the index. Every documented default and behavior was checked against the engine source. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Signed-off-by: Xavier Roche <roche@httrack.com> * Correct four scope/option descriptions in the guide Adversarial review against the engine source caught four mislabels: -d is "same principal domain" and -l is "same TLD" (not "same directory" and "same domain"); -U goes up only and -B goes both ways (the guide had -U as up-and-down and -B as "anywhere"); -%M archives the whole mirror into one index.mht, not each page; and -t HEAD-tests links outside scope rather than reporting "what a scope would reach". The rest of the guide's documented behavior verified against code. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Signed-off-by: Xavier Roche <roche@httrack.com> * Fix the PDF recipe, prefer long options, drop the section rules Review feedback from Xavier: - The "grab every PDF" recipe was wrong. `-* +*.pdf` blocks the HTML pages that carry the PDF links, so the crawl only keeps PDFs linked from the entry page (verified on a local fixture). There is no PDF-only crawl: HTTrack finds PDFs by parsing HTML. Reworded to let the site traverse, with the off-host case handled by a `+host/*.pdf` rule. - Recipes now use long options throughout. `-%!` in particular is replaced by `--disable-security-limits`: the bare `!` triggers shell history expansion and is easy to fumble, and the long name says what it does. - Dropped the per-section `<hr>` rules; the sibling doc pages don't use them and the section headings already separate the content. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Signed-off-by: Xavier Roche <roche@httrack.com> * Key the reference tables by long option name, short in parens Follows the recipe conversion: every table row now leads with the long option (--depth, --stay-on-same-domain, ...) and carries the short flag in parentheses. The guru %-flags that have no long form (-%g, -%j, -%o, -%y, -%z, -%G, -%t, -%N) stay short. Also switches the remaining inline command snippets in descriptions to long form (--assume, --structure, --user-agent ""). Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Signed-off-by: Xavier Roche <roche@httrack.com> --------- Signed-off-by: Xavier Roche <roche@httrack.com> Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
158 lines
5.6 KiB
HTML
158 lines
5.6 KiB
HTML
<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>Command-Line Documentation</em></h2>
|
|
|
|
<br>
|
|
|
|
The command-line version
|
|
|
|
<ul>
|
|
<li><a href="cmdguide.html">Command-line Guide</a></li>
|
|
<br>A task-oriented guide: how to do the common things, and the defaults that surprise newcomers<br><br>
|
|
<li><a href="options.html">Command line Options</a></li>
|
|
<br>List of all powerful command line options<br><br>
|
|
<li>How to use httrack command-line version:</li>
|
|
<ul>
|
|
<li>Open a shell window</li>
|
|
<br>
|
|
<br>
|
|
<li>Type in <tt>httrack</tt> (or the complete path to the httrack executable)</li>
|
|
<br><small><tt>httrack</tt></small>
|
|
<br>
|
|
<br>
|
|
<li>Add the URLs, separated by a blank space</li>
|
|
<br><small><tt>httrack www.example.com/foo/</tt></small>
|
|
<br>
|
|
<br>
|
|
<li>If you need, add some options (see the <a href="options.html">option list</a>)</li>
|
|
<br><small><tt>httrack www.example.com/foo/ -O "/webs" -N4 -P proxy.myhost.com:3128</tt></small>
|
|
<br>
|
|
<br>
|
|
<li>Launch the command line, and wait until the mirror is finishing</li>
|
|
<br><small>You can (especially on the Unix release) press ^C to stop the mirror or put httrack in background</small>
|
|
<br>
|
|
<br>
|
|
</ul>
|
|
</ul>
|
|
|
|
<!-- ==================== 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>© 1998-2026 Xavier Roche & other contributors - Web Design: Leto Kauler.</small></td>
|
|
</tr>
|
|
</table>
|
|
|
|
</body>
|
|
|
|
</html>
|
|
|