tr_blck(1)

NAME

       tr_blck -- check for broken relative links in html pages

SYNOPSIS

           tr_blck [-AhW] [-d docroot] [-r regexp] html-files

DESCRIPTION

       tr_blck searches html files for broken links. I searches only the rela-
       tive links and does not need a web-server. As it does not need web-
       access it is very fast. The output of tr_blck  is of the same format as
       gcc error messages and can therefore be interpreted by many common
       editors  (e.g emacs  or  vim).   After editing a some html pages you
       can just type: tr_blck page1.html ../somewhere/page2.html and tr_blck
       will check that the links in these pages are correct.

       tr_blck checks the relative filesystem links.  These are links of the
       form: href="index.html" href="../somepage.html#anchor1" etc...

       but not href="/notchecked.html" href="http://server.somewhere/some-
       thing.html" href="javascript:history.back();"

       All tags containg relative links with  href=...,  src=..., and back-
       ground=...  are checked.

OPTIONS

       -h short help message

       -a print all links that were not checked (proto://) and do not check
       for any broken links. This output can be processed further with
       httpcheck.

       -A do not open any other files than the files given on the

       -d document root directory to check abs. filesystem links e.g -d
       /home/httpd/html

       -r warn about absolut links matching the given perl regexp E.g: -w
       \'www.linuxfocus.org|chem.pitt.edu\' This match is not case sensitive
       and only applied to links starting with proto:// (=absolut links).

       -W do not print warnings about html errors (not terminated tags etc
       ...).

EXAMPLE

       Check links in html files in the web server root directory
       (/home/httpd/html) and in all directories one level down: (cd
       /home/httpd/html; tr_blck *.html */*.html)

       Check links in all html files on the server: (cd  /home/httpd/html;
       tr_blck  `find  . -name '*.htm*' -print` | sort)

       You  can  use  the  vim  editor  Quickfix  mode   or   the emacs/xemacs
       M-x compile to parse the output of tr_blck.  Vim: :cf
       file_with_err_messages, :cn to go to the next message emacs: M-x com-
       pile, compile command: cat file_with_err_messages

       This gives you the possibility to open the  concerned  web page  and
       jump directly to the line where the broken link is.  To do this you can
       write a Makefile that looks e.g as follows:

       all:
           tr_blck `find . -name '*.htm*' -print` | sort

AUTHOR

       tr_blck is part of the HTML::TagReader package and was written by Guido
       Socher [guido(at)linuxfocus.org]

perl v5.8.8                       2006-06-22                        TR_BLCK(1)