478 lines
26 KiB
HTML
478 lines
26 KiB
HTML
<?xml version="1.0" encoding="US-ASCII" ?>
|
|
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.1//EN"
|
|
"http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">
|
|
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en">
|
|
<head>
|
|
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII" />
|
|
<meta http-equiv="Content-Style-Type" content="text/css" />
|
|
<meta http-equiv="Content-Script-Type" content="text/javascript" />
|
|
<meta name="author" content="imacat" />
|
|
<meta name="copyright" content="© 2003-2008 imacat." />
|
|
<meta name="keywords" content="link checker, broken links" />
|
|
<link rel="alternate" type="application/xhtml+xml" href="chklinks.zh-tw.html"
|
|
hreflang="zh-tw" title="正體中文" />
|
|
<link rel="alternate" type="application/xhtml+xml" href="chklinks.zh-cn.html"
|
|
hreflang="zh-cn" title="简体中文" />
|
|
<link rel="copyright" type="text/plain" href="fdl.txt" />
|
|
<link rel="author" href="mailto:imacat@mail.imacat.idv.tw" />
|
|
<style type="text/css">
|
|
h2, em {
|
|
text-transform: uppercase;
|
|
}
|
|
.accessguide {
|
|
font-size: 0.5em;
|
|
float: left;
|
|
width: 0.5em;
|
|
}
|
|
</style>
|
|
<title>chklinks Version 3.09</title>
|
|
</head>
|
|
<body>
|
|
|
|
<div class="langs" title="Language Switching Area">
|
|
<span xml:lang="zh-tw"><a href="chklinks.zh-tw.html"
|
|
title="切換到本頁的正體中文版。"
|
|
hreflang="zh-tw">正體中文</a></span> |
|
|
<span xml:lang="zh-cn"><a href="chklinks.zh-cn.html"
|
|
title="切换到本页的简体中文版。"
|
|
hreflang="zh-cn">简体中文</a></span> |
|
|
<span>English</span>
|
|
</div>
|
|
<hr />
|
|
|
|
|
|
<div id="body" class="body" title="Page Content Area">
|
|
<div class="accessguide"><a accesskey="C"
|
|
href="#body" title="Page Content Area">:::</a></div>
|
|
|
|
<h1><samp>chklinks</samp> Version 3.09</h1>
|
|
|
|
|
|
<h2>What’s New?</h2>
|
|
|
|
|
|
<dl>
|
|
|
|
<dt>2007-12-06</dt>
|
|
|
|
<dd>
|
|
<p><samp>chklinks</samp> version 3.09 is released. Fixed the bug on systems like <abbr title="Microsoft">MS</abbr>-Windows that does not have <samp>getpwuid()</samp>. <a href="ftp://ftp.imacat.idv.tw/pub/chklinks/chklinks-3.09.tar.gz" type="application/x-gzip">Download <samp>chklinks</samp> version 3.09</a>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2007-12-05</dt>
|
|
|
|
<dd>
|
|
<p><samp>chklinks</samp> version 3.08 is released. There are several documentation fixes. <a href="ftp://ftp.imacat.idv.tw/pub/chklinks/chklinks-3.08.tar.gz" type="application/x-gzip">Download <samp>chklinks</samp> version 3.08</a>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2007-12-05</dt>
|
|
|
|
<dd>
|
|
<p><samp>chklinks</samp> version 3.07 is released. Required <acronym title="Practical Extraction and Reporting Language">Perl</acronym> version number compatible to older versions, to work with the <acronym title="Practical Extraction and Reporting Language">Perl</acronym> 5.10 warning. License updated to <a href="http://www.gnu.org/licenses/gpl-3.0.html"><abbr title="GNU General Public License version 3">GPLv3</abbr></a>. <a href="ftp://ftp.imacat.idv.tw/pub/chklinks/chklinks-3.07.tar.gz" type="application/x-gzip">Download <samp>chklinks</samp> version 3.07</a>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2007-06-08</dt>
|
|
|
|
<dd>
|
|
<p><samp>chklinks</samp> version 3.06 is released. Test suite fixes. <a href="ftp://ftp.imacat.idv.tw/pub/chklinks/chklinks-3.06.tar.gz" type="application/x-gzip">Download <samp>chklinks</samp> version 3.06</a>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2007-06-07</dt>
|
|
|
|
<dd>
|
|
<p><samp>chklinks</samp> version 3.05 is released. Fixed problem with <acronym title="Practical Extraction and Reporting Language">Perl</acronym> version earlier than 5.8 where <abbr title="unicode translation format">UTF</abbr>-8 mode is not available. <a href="ftp://ftp.imacat.idv.tw/pub/chklinks/chklinks-3.05.tar.gz" type="application/x-gzip">Download <samp>chklinks</samp> version 3.05</a>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2007-06-06</dt>
|
|
|
|
<dd>
|
|
<p><samp>chklinks</samp> version 3.04 is released. Documentation fixes. <a href="ftp://ftp.imacat.idv.tw/pub/chklinks/chklinks-3.04.tar.gz" type="application/x-gzip">Download <samp>chklinks</samp> version 3.04</a>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2007-06-06</dt>
|
|
|
|
<dd>
|
|
<p><samp>chklinks</samp> version 3.03 is released. Fixed the raw <abbr title="unicode translation format">UTF</abbr>-8 warning with <a href="http://search.cpan.org/dist/HTML-Parser/"><samp>HTML::Parser</samp></a>. Added support for building with <a href="http://search.cpan.org/dist/Module-Build/"><samp>Module::Build</samp></a>. <a href="ftp://ftp.imacat.idv.tw/pub/chklinks/chklinks-3.03.tar.gz" type="application/x-gzip">Download <samp>chklinks</samp> version 3.03</a>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2006-06-02</dt>
|
|
|
|
<dd>
|
|
<p><samp>chklinks</samp> version 3.02 is released. The digital signature is corrected. <a href="ftp://ftp.imacat.idv.tw/pub/chklinks/chklinks-3.02.tar.gz" type="application/x-gzip">Download <samp>chklinks</samp> version 3.02</a>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2006-05-31</dt>
|
|
|
|
<dd>
|
|
<p><samp>chklinks</samp> version 3.01 is released. This fixed a missing prerequisites in <samp>Makefile.PL</samp>. <abbr title="HyperText Markup Language">HTML</abbr> documents are returned. <a href="ftp://ftp.imacat.idv.tw/pub/chklinks/chklinks-3.01.tar.gz" type="application/x-gzip">Download <samp>chklinks</samp> version 3.01</a>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2006-05-30</dt>
|
|
|
|
<dd>
|
|
<p><samp>chklinks</samp> version 3.00 is released. It uses <a href="http://search.cpan.org/dist/HTML-Parser/"><samp>HTML::LinkExtor</samp></a> to parse the page and <a href="http://search.cpan.org/dist/libwww-perl/"><samp>LWP::RobotUA</samp></a> to make requests. More <abbr title="Uniform Resource Locator">URL</abbr> schemes other than <samp>http</samp> are supported. Cookies are supported. <samp>robots.txt</samp> rules are respected. <a href="ftp://ftp.imacat.idv.tw/pub/chklinks/chklinks-3.00.tar.gz" type="application/x-gzip">Download <samp>chklinks</samp> version 3.00</a>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2005-10-02</dt>
|
|
|
|
<dd>
|
|
<p>Website style adjustment. <abbr title="Web Content Accessibility Guidelines">WCAG</abbr> Accessibility designs are added. <code><hr /></code>s are replaced by <abbr title="Cascading StyleSheets">CSS</abbr> borders for accessibility reason.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2005-04-27</dt>
|
|
|
|
<dd>
|
|
<p>The text <q xml:lang="zh-tw">繁體中文</q> on the website is corrected to <q xml:lang="zh-tw">正體中文</q>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2003-05-26</dt>
|
|
|
|
<dd>
|
|
<p><samp>chklinks</samp> version 2.02 is released. The default changed from one-level to recursive. This is more desirable in most cases. <a href="ftp://ftp.imacat.idv.tw/pub/chklinks/chklinks-2.02.tar.gz" type="application/x-gzip">Download <samp>chklinks</samp> version 2.02</a>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2003-05-25</dt>
|
|
|
|
<dd>
|
|
<p><samp>chklinks</samp> version 2.01 is released. An installer, accessary files and a <abbr title="plain old document">POD</abbr> document are added. <a href="ftp://ftp.imacat.idv.tw/pub/chklinks/chklinks-2.01.tar.gz" type="application/x-gzip">Download <samp>chklinks</samp> version 2.01</a>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2003-05-25</dt>
|
|
|
|
<dd>
|
|
<p><samp>chklinks</samp> version 2.0.0 is released. This is the first public release uploaded onto SourceForge. Only the main script file is available. <a href="ftp://ftp.imacat.idv.tw/pub/chklinks/chklinks-2.0.0.tar.gz" type="application/x-gzip">Download <samp>chklinks</samp> version 2.0.0</a>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2003-05-19</dt>
|
|
|
|
<dd>
|
|
<p>SourceForge project space approved.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>2003-05-18</dt>
|
|
|
|
<dd>
|
|
<p>Requesting a SourceForge project space.</p>
|
|
</dd>
|
|
|
|
</dl>
|
|
|
|
|
|
<h2>Description</h2>
|
|
|
|
<p><dfn><samp>chklinks</samp></dfn> is a non-threaded <acronym title="Practical Extraction and Reporting Language">Perl</acronym> link checker. It helps finding broken links on your website.</p>
|
|
|
|
<p><samp>chklinks</samp> differs from <a href="http://linkchecker.sourceforge.net/"><samp>linkchecker</samp></a> in that <samp>chklinks</samp> is non-threaded. It does not raises many simultaneously connections for its job. It won’t run out of the resources and crash your system in a moment. This is certainly more desirable for most webmasters and users.</p>
|
|
|
|
<p><samp>chklinks</samp> follows <samp>robots.txt</samp> rules. If you disallow robots from your website and experience problems, you need to allow <samp>chklinks</samp>. Add the following lines to your <samp>robots.txt</samp> file to allow <samp>chklinks</samp>:</p>
|
|
|
|
<blockquote><pre>
|
|
User-agent: chklinks
|
|
Disallow:
|
|
</pre></blockquote>
|
|
|
|
<p><samp>chklinks</samp> uses <a href="http://search.cpan.org/dist/libwww-perl/"><samp>LWP::RobotUA</samp></a> and support the following schemes: <samp>http</samp>, <samp>https</samp>, <samp>ftp</samp>, <samp>gopher</samp> and <samp>file</samp>. You can also specify a local file. (To use <samp>https</samp>, you need to install <a href="http://search.cpan.org/dist/Crypt-SSLeay/"><samp>Crypt::SSLeay</samp></a>. This is the requirement of
|
|
<a href="http://search.cpan.org/dist/libwww-perl/"><samp>LWP::RobotUA</samp></a>.)</p>
|
|
|
|
<p><samp>chklinks</samp> supports cookies.</p>
|
|
|
|
|
|
<h2>System Requirement</h2>
|
|
|
|
<ol>
|
|
<li><p><acronym title="Practical Extraction and Reporting Language">Perl</acronym>, version 5.6 or above. I have not successfully run this on earlier versions. Please tell me if you can. You can run <q><samp>perl -v</samp></q> to see your current <acronym title="Practical Extraction and Reporting Language">Perl</acronym> version. <acronym title="Practical Extraction and Reporting Language">Perl</acronym> is distributed with most Unix now. If not, or if you have an older version of <acronym title="Practical Extraction and Reporting Language">Perl</acronym>, you can download and install/upgrade it from <a href="http://www.perl.com/"><acronym title="Practical Extraction and Reporting Language">Perl</acronym> website</a>. If you are using <abbr title="Microsoft">MS</abbr>-Windows, you can download and install <a href="http://www.activestate.com/">ActiveState ActivePerl</a>.</p></li>
|
|
|
|
<li><p>Required <acronym title="Practical Extraction and Reporting Language">Perl</acronym> modules:</p>
|
|
|
|
<dl>
|
|
<dt><a href="http://search.cpan.org/dist/URI/"><samp>URI</samp></a></dt>
|
|
|
|
<dd>
|
|
<p>This is used to parse and process the found <abbr title="uniform resource locator">URL</abbr>s. You can <a href="http://search.cpan.org/dist/URI/">download and install <samp>URI</samp> from the <acronym title="Comprehensive Perl Archive Network" xml:lang="en">CPAN</acronym> archive</a>, or install it with the <samp>CPAN</samp> shell by running <q><samp>cpan URI</samp></q>, or install it with the <samp>CPANPLUS</samp> shell by running <q><samp>cpanp i URI</samp></q>. Debian/Ubandu Linux users can install it by running <q><samp>apt-get install liburi-perl</samp></q>. Red Hat/Fedora/CentOS Linux users can install it by running <q><samp>yum install perl-URI</samp></q>. FreeBSD users can install it by running <q><samp>ports install p5-URI</samp></q>. ActivePerl users can install it by running <q><samp>ppm install URI</samp></q>.</p>
|
|
</dd>
|
|
|
|
<dt><a href="http://search.cpan.org/dist/HTML-Parser/"><samp>HTML::LinkExtor</samp></a></dt>
|
|
|
|
<dd>
|
|
<p>This is used to extract links from the web pages. <samp>HTML::LinkExtor</samp> is contained in the <a href="http://search.cpan.org/dist/HTML-Parser/">HTML-Parser</a> distribution. You can <a href="http://search.cpan.org/dist/HTML-Parser/">download and install <samp>HTML::LinkExtor</samp> from the <acronym title="Comprehensive Perl Archive Network" xml:lang="en">CPAN</acronym> archive</a>, or install it with the <samp>CPAN</samp> shell by running <q><samp>cpan HTML::LinkExtor</samp></q>, or install it with the <samp>CPANPLUS</samp> shell by running <q><samp>cpanp i HTML::LinkExtor</samp></q>. Debian/Ubandu Linux users can install it by running <q><samp>apt-get install libhtml-parser-perl</samp></q>. Red Hat/Fedora/CentOS Linux users can install it by running <q><samp>yum install perl-HTML-Parser</samp></q>. FreeBSD users can install it by running <q><samp>ports install p5-HTML-Parser</samp></q>. ActivePerl users can install it by running <q><samp>ppm install HTML::LinkExtor</samp></q>.</p>
|
|
</dd>
|
|
|
|
<dt><a href="http://search.cpan.org/dist/libwww-perl/"><samp>LWP::RobotUA</samp></a></dt>
|
|
|
|
<dd>
|
|
<p>This is used to request web pages. <samp>LWP::RobotUA</samp> is contained in the <a href="http://search.cpan.org/dist/libwww-perl/">libwww-perl</a> distribution. You can <a href="http://search.cpan.org/dist/libwww-perl/">download and install <samp>LWP::RobotUA</samp> from the <acronym title="Comprehensive Perl Archive Network" xml:lang="en">CPAN</acronym> archive</a>, or install it with the <samp>CPAN</samp> shell by running <q><samp>cpan LWP::RobotUA</samp></q>, or install it with the <samp>CPANPLUS</samp> shell by running <q><samp>cpanp i LWP::RobotUA</samp></q>. Debian/Ubandu Linux users can install it by running <q><samp>apt-get install libwww-perl</samp></q>. Red Hat/Fedora/CentOS Linux users can install it by running <q><samp>yum install perl-libwww-perl</samp></q>. FreeBSD users can install it by running <q><samp>ports install p5-libwww</samp></q>. ActivePerl users can install it by running <q><samp>ppm install LWP::RobotUA</samp></q>.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
<p>If you install <samp>chklinks</samp> with the <samp>CPAN</samp> or <samp>CPAN</samp> shell, the above shall be automatically installed.</p>
|
|
</li>
|
|
|
|
|
|
<li><p>Optional <acronym title="Practical Extraction and Reporting Language">Perl</acronym> modules:</p>
|
|
|
|
<dl>
|
|
<dt><a href="http://search.cpan.org/dist/Crypt-SSLeay/"><samp>Crypt::SSLeay</samp></a></dt>
|
|
|
|
<dd>
|
|
<p>This is needed for <a href="http://search.cpan.org/dist/libwww-perl/"><samp>LWP::RobotUA</samp></a> to support <abbr title="Hypertext Transfer Protocol over Secure Socket Layer">HTTPS</abbr>. You can <a href="http://search.cpan.org/dist/Config-General/">download and install <samp>Config::General</samp> from the <acronym title="Comprehensive Perl Archive Network" xml:lang="en">CPAN</acronym> archive</a>, or install it with the <samp>CPAN</samp> shell by running <q><samp>cpan Config::General</samp></q>, or install it with the <samp>CPANPLUS</samp> shell by running <q><samp>cpanp i Config::General</samp></q>. Debian/Ubandu Linux users can install it by running <q><samp>apt-get install libconfig-general-perl</samp></q>. Red Hat/Fedora/CentOS Linux users can install it by running <q><samp>yum install perl-Config-General</samp></q>. FreeBSD users can install it by running <q><samp>ports install p5-Config-General</samp></q>. <a href="http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/Repository">ActiveState does not host the <abbr title="Perl Package Manager">PPM</abbr> build of <samp>Crypt::SSLeay</samp> for ActivePerl due to the Canadian Federal Government requirement.</a> However, ActivePerl users can still install it from another repository, by running <q><samp>ppm install http://theoryx5.uwinnipeg.ca/ppms/Crypt-SSLeay.ppd</samp></q>.</p>
|
|
</dd>
|
|
</dl>
|
|
</li>
|
|
</ol>
|
|
|
|
|
|
<h2>Download</h2>
|
|
|
|
<p><samp>chklinks</samp>’s official websites is at…</p>
|
|
|
|
<ul>
|
|
<li><p><a href="http://chklinks.sourceforge.net/"><samp>chklinks</samp> web site at SourceForge</a>.</p></li>
|
|
<li><p><a href="http://sourceforge.net/projects/chklinks/"><samp>chklinks</samp> project page at SourceForge</a>.</p></li>
|
|
<li><p><a href="http://search.cpan.org/dist/chklinks/"><samp>chklinks</samp> project page at <abbr title="Comprehensive Perl Archive Network">CPAN</abbr></a>.</p></li>
|
|
<li><p><a href="http://www.imacat.idv.tw/tech/chklinks.html"><samp>chklinks</samp> page at Tavern IMACAT’s</a>.</p></li>
|
|
</ul>
|
|
|
|
<p>You can always download the newest version of <samp>chklinks</samp> from…</p>
|
|
|
|
<ul>
|
|
<li><p><a href="https://sourceforge.net/project/showfiles.php?group_id=81431"><samp>chklinks</samp> download page at SourceForge</a>.</p></li>
|
|
<li><p><a href="http://search.cpan.org/dist/chklinks/"><samp>chklinks</samp>’s project page at <abbr title="Comprehensive Perl Archive Network">CPAN</abbr></a>.</p></li>
|
|
<li><p><a href="ftp://ftp.imacat.idv.tw/pub/chklinks/">Tavern IMACAT’s <abbr title="File Transfer Protocol">FTP</abbr> directory</a>.</p></li>
|
|
</ul>
|
|
|
|
<p>imacat’s <abbr title="Pretty Good Privacy">PGP</abbr> public key is at…</p>
|
|
|
|
<ul>
|
|
<li><p><a href="http://chklinks.sourceforge.net/pgpkey.asc" type="application/pgp-keys">imacat’s <abbr title="Pretty Good Privacy">PGP</abbr> key at <samp>chklinks</samp> SourceForge web site</a>.</p></li>
|
|
<li><p><a href="http://www.imacat.idv.tw/me/pgpkey.asc" type="application/pgp-keys">imacat’s <abbr title="Pretty Good Privacy">PGP</abbr> key at Tavern IMACAT’s</a>.</p></li>
|
|
</ul>
|
|
|
|
|
|
<h2>Install</h2>
|
|
|
|
<h3>Install with <a href="http://search.cpan.org/dist/ExtUtils-MakeMaker/"><samp>ExtUtils::MakeMaker</samp></a></h3>
|
|
|
|
<p><samp>chklinks</samp> uses standard <acronym title="Practical Extraction and Reporting Language">Perl</acronym> installation with <a href="http://search.cpan.org/dist/ExtUtils-MakeMaker/"><samp>ExtUtils::MakeMaker</samp></a>. Follow these steps:</p>
|
|
|
|
<blockquote><pre>
|
|
% perl Makefile.PL
|
|
% make
|
|
% make test
|
|
% make install
|
|
</pre></blockquote>
|
|
|
|
<p>When running <q><samp>make install</samp></q>, make sure you have the priviledge to write to the installation location. This usually requires the <samp>root</samp> priviledge.</p>
|
|
|
|
<p>If you are using ActivePerl under <abbr title="Microsoft">MS</abbr>-Windows, you should use <samp>nmake</samp> instead of <samp>make</samp>. <a href="ftp://ftp.microsoft.com/Softlib/MSLFILES/nmake15.exe" type="application/x-dosexec"><samp>nmake</samp> can be obtained from the Microsoft <abbr title="File Transfer Protocol">FTP</abbr> site.</a></p>
|
|
|
|
<p>If you want to install into another location, you can set the <samp>PREFIX</samp>. For example, to install into your home when you are not <samp>root</samp>:</p>
|
|
|
|
<blockquote><pre>
|
|
% perl Makefile.PL PREFIX=/home/jessica
|
|
</pre></blockquote>
|
|
|
|
<p>Refer to the docuemntation of <a href="http://search.cpan.org/dist/ExtUtils-MakeMaker/" hreflang="en" xml:lang="en"><samp>ExtUtils::MakeMaker</samp></a> for more installation options (by running <q><samp>perldoc ExtUtils::MakeMaker</samp></q>).</p>
|
|
|
|
|
|
<h3>Install with <a href="http://search.cpan.org/dist/Module-Build/"><samp>Module::Build</samp></a></h3>
|
|
|
|
<p>You can install with <a href="http://search.cpan.org/dist/Module-Build/"><samp>Module::Build</samp></a> instead, if you prefer. Follow these steps:</p>
|
|
|
|
<blockquote><pre>
|
|
% perl Build.PL
|
|
% ./Build
|
|
% ./Build test
|
|
% ./Build install
|
|
</pre></blockquote>
|
|
|
|
<p>When running <q><samp>./Build install</samp></q>, make sure you have the priviledge to write to the installation location. This usually requires the <samp>root</samp> priviledge.</p>
|
|
|
|
<p>If you want to install into another location, you can set the <samp>--prefix</samp>. For example, to install into your home when you are not <samp>root</samp>:</p>
|
|
|
|
<blockquote><pre>
|
|
% perl Build.PL --prefix=/home/jessica
|
|
</pre></blockquote>
|
|
|
|
<p>Refer to the docuemntation of <a href="http://search.cpan.org/dist/Module-Build/"><samp>Module::Build</samp></a> for more installation options (by running <q><samp>perldoc Module::Build</samp></q>).</p>
|
|
|
|
|
|
<h2>Options</h2>
|
|
|
|
<pre>
|
|
./chklinks [options] <var>URL1</var> [<var>URL2</var> [<var>URL3</var> …]]
|
|
./chklinks [-h|-v]
|
|
</pre>
|
|
|
|
|
|
<dl>
|
|
<dt>-1,--onelevel</dt>
|
|
|
|
<dd>
|
|
<p>Check the links on this page and stops.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>-r,--recursive</dt>
|
|
|
|
<dd>
|
|
<p>Recursively check through this website. This is the default.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>-b,--below</dt>
|
|
|
|
<dd>
|
|
<p>Only check the links below this directory. This is the default.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>-p,--parent</dt>
|
|
|
|
<dd>
|
|
<p>Trace back to the parent directories.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>-l,--local</dt>
|
|
|
|
<dd>
|
|
<p>Only check the links on this same host.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>-s,--span</dt>
|
|
|
|
<dd>
|
|
<p>Check the links to other hosts (without recursion). This is the default.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>-e,--exclude <var>path</var></dt>
|
|
|
|
<dd>
|
|
<p>Exclude this path. Check for their existence but not check the links on them, just like they are on a foreign site. Multiple <samp>--exclude</samp> are <acronym title="okay">OK</acronym>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>-i,--include <var>path</var></dt>
|
|
|
|
<dd>
|
|
<p>Include this path. An opposite of <samp>--exclude</samp> that cancels its effect. The latter specified has a higher priority.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>-d,--debug</dt>
|
|
|
|
<dd>
|
|
<p>Display debug messages. Multiple <samp>--debug</samp> to debug more.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>-q,--quiet</dt>
|
|
|
|
<dd>
|
|
<p>Disable debug messages. An opposite that cancels the effect of <samp>--debug</samp>.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>-h, --help</dt>
|
|
|
|
<dd>
|
|
<p>Display the help message and exit.</p>
|
|
</dd>
|
|
|
|
|
|
<dt>-v, --version</dt>
|
|
|
|
<dd>
|
|
<p>Output version information and exit.</p>
|
|
</dd>
|
|
|
|
|
|
<dt><var>URL1</var>, <var>URL2</var>, <var>URL3</var></dt>
|
|
|
|
<dd>
|
|
<p>The <abbr title="Uniform Resource Locator">URL</abbr>s of the websites to check against.</p>
|
|
</dd>
|
|
</dl>
|
|
|
|
|
|
<h2>Notes</h2>
|
|
|
|
<ul>
|
|
<li><p><samp>chklinks</samp> does not obey <a href="http://help.yahoo.com/help/us/ysearch/slurp/slurp-03.html"><samp>Crawl-delay:</samp></a> in <samp>robots.txt</samp> yet. This is a problem in <a href="http://search.cpan.org/dist/libwww-perl/"><samp>WWW::RobotRules</samp></a>, but not <samp>chklinks</samp> itself.</p></li>
|
|
|
|
<li><p>If you encounter warnings like this:</p>
|
|
|
|
<blockquote>
|
|
<pre>Parsing of undecoded UTF-8 will give garbage when decoding entities at /usr/share/perl5/LWP/Protocol.pm line 114.</pre>
|
|
</blockquote>
|
|
|
|
<p>This is an issue of <a href="http://search.cpan.org/dist/libwww-perl/"><samp>LWP::Protocol</samp></a> version ≤ 1.43 (in <samp>libwww-perl</samp> version ≤ 5.805) when working with <a href="http://search.cpan.org/dist/HTML-Parser/"><samp>HTML::Parser</samp></a> version ≥ 3.40 and <acronym title="Practical Extraction and Reporting Language">Perl</acronym> version ≥ 5.8. This issue is solved in <a href="http://search.cpan.org/dist/libwww-perl/"><samp>LWP::Protocol</samp></a> version ≥ 1.46 (in <samp>libwww-perl</samp> version ≥ 5.806). You can upgrade your <a href="http://search.cpan.org/dist/libwww-perl/"><samp>LWP::Protocol</samp></a> to the current version. If you cannot upgrade it, see <a href="http://rt.cpan.org/Public/Bug/Display.html?id=20274"><acronym title="Comprehensive Perl Archive Network">CPAN</acronym> RT Bug#20274</a> for an <a href="http://search.cpan.org/dist/libwww-perl/"><samp>LWP::Protocol</samp></a> patch on this.</p>
|
|
</li>
|
|
</ul>
|
|
|
|
|
|
<h2>See Also</h2>
|
|
|
|
<p><a href="http://search.cpan.org/dist/libwww-perl/"><samp>LWP::UserAgent</samp></a>, <a href="http://search.cpan.org/dist/libwww-perl/"><samp>LWP::RobotUA</samp></a>, <a href="http://search.cpan.org/dist/libwww-perl/"><samp>WWW::RobotRules</samp></a>, <a href="http://search.cpan.org/dist/URI/"><samp>URI</samp></a>, <a href="http://search.cpan.org/dist/HTML-Parser/"><samp>HTML::LinkExtor</samp></a>, Bastian Kleineidam’s <a href="http://linkchecker.sourceforge.net/"><samp>linkchecker</samp></a> and W3C-LinkChecker <a href="http://validator.w3.org/checklink"><samp>checklink</samp></a>.</p>
|
|
|
|
|
|
<h2>Copyright</h2>
|
|
|
|
<p>Copyright © 2003-2007 imacat. All rights reserved.</p>
|
|
|
|
<p>This program is free software: you can redistribute it and/or modify it under the terms of the <cite><acronym title="GNU’s Not UNIX">GNU</acronym> General Public License</cite> as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.</p>
|
|
|
|
<p>This program is distributed in the hope that it will be useful, but <em>without any warranty</em>; without even the implied warranty of <em>merchantability</em> or <em>fitness for a particular purpose</em>. See the <cite><acronym title="GNU’s Not UNIX">GNU</acronym> General Public License</cite> for more details.</p>
|
|
|
|
<p>You should have received a copy of the <cite><acronym title="GNU’s Not UNIX">GNU</acronym> General Public License</cite> along with this program. If not, see <samp><<a href="http://www.gnu.org/licenses/">http://www.gnu.org/licenses/</a>></samp>.</p>
|
|
|
|
|
|
<h2>Release Notes</h2>
|
|
|
|
<p>Please read the <samp>NEWS</samp> for the new functions and bug fixes.</p>
|
|
|
|
|
|
<h2>Support</h2>
|
|
|
|
<p><samp>chklinks</samp> is hosted on <a href="https://sourceforge.net/">SourceForge</a>, <a href="http://www.cpan.org/"><acronym title="Comprehensive Perl Archive Network">CPAN</acronym></a> and <a href="http://www.imacat.idv.tw/">Tavern IMACAT’s</a>. For the latest infomation, see</p>
|
|
|
|
<ul>
|
|
<li><p><a href="http://chklinks.sourceforge.net/"><samp>chklinks</samp> web site at SourceForge</a>.</p></li>
|
|
<li><p><a href="http://sourceforge.net/projects/chklinks/"><samp>chklinks</samp> project page at SourceForge</a>.</p></li>
|
|
<li><p><a href="http://search.cpan.org/dist/chklinks/"><samp>chklinks</samp> project page at <abbr title="Comprehensive Perl Archive Network">CPAN</abbr></a>.</p></li>
|
|
<li><p><a href="http://www.imacat.idv.tw/tech/chklinks.html"><samp>chklinks</samp> page at Tavern IMACAT’s</a>.</p></li>
|
|
</ul>
|
|
|
|
<p>There is a <a href="mailto:chklinks-users@lists.sourceforge.net"><samp>chklinks</samp> mailing list</a> hosted at <a href="https://sourceforge.net/">SourceForge</a>. Please submit your questions, suggestions or bug reports there. It is a <a href="http://www.list.org/">Mailman</a> mailing list. For more information, see the <a href="https://lists.sourceforge.net/lists/listinfo/chklinks-users"><samp>chklinks</samp> mailing list page</a>. Alternatively, you can send a mail to the <a href="mailto:chklinks-users-request@lists.sourceforge.net"><acronym title="electronic mail">e-mail</acronym> command mailbox</a> with the subject <samp>help</samp> for a list of available <acronym title="electronic mail">e-mail</acronym> commands.</p>
|
|
|
|
</div>
|
|
|
|
|
|
<hr />
|
|
<div id="footer" class="footer" title="Page Footer Area">
|
|
<address>By <a href="mailto:imacat@mail.imacat.idv.tw">imacat</a>, first version 2003-05-25, last updated 2008-11-17</address>
|
|
|
|
<address>Copyright © 2003-2008 imacat. Please read the <a href="fdl.txt">copyright</a> before copying.</address>
|
|
</div>
|
|
|
|
</body>
|
|
</html>
|