Indonesian CGIProxy:   [ UP ]   [Manage cookies]
mod_perl logo perl icon
previous page: Changes File Specspage up: How to Contribute to the Documentationnext page: Document Template

Site Maintenance






mod_perl Pocket Reference

mod_perl Pocket Reference

By Andrew Ford
Writing Apache Modules with Perl and C

Writing Apache Modules with Perl and C

By Lincoln Stein, Doug MacEachern
Embedding Perl in HTML with Mason

Embedding Perl in HTML with Mason

By Dave Rolsky, Ken Williams
mod_perl2 User's Guide

mod_perl2 User's Guide

By Stas Bekman, Jim Brandt
Practical mod_perl

Practical mod_perl

By Stas Bekman, Eric Cholet
The mod_perl Developer's Cookbook

The mod_perl Developer's Cookbook

By Geoffrey Young, Paul Lindner, Randy Kobes


Table of Contents

Description

This document explains how to keep the site clean.



TOP

Validation Tasks

We start from a site which is absolutely clean. Please keep it that way.

  • Validate internal and external links. For example use: the checklink.pl from ( http://validator.w3.org/checklink ) I usually run the check as:

      % checklink.pl --summary --recursive --broken --quiet \
        --html -D 10 http://localhost/modperl-site > report.html

    Internal links validation also applies to POD documents. It's easy to do this, just rebuild the site with the -l argument to bin/build:

      % bin/build -lf
  • Validate the correctness of the documents. The broken HTML can come from the broken source HTML document or bad templates. One of the tools that can be used is sgmlcheck. e.g.:

      % sgmlcheck dst_html/index.html

    META: anyone knows a better tool that can recursively check the whole site (ala checklink.pl) and generate an nice report?






TOP
previous page: Changes File Specspage up: How to Contribute to the Documentationnext page: Document Template