project/Pod2Html.pm

   1 # $Id$
   2 # URL redirector of &My::Web::a_href Perl template.
   3 # Copyright (C) 2003-2005 Jan Kratochvil <project-www.jankratochvil.net@jankratochvil.net>
   4 #
   5 # This program is free software; you can redistribute it and/or modify
   6 # it under the terms of the GNU General Public License as published by
   7 # the Free Software Foundation; exactly version 2 of June 1991 is required
   8 #
   9 # This program is distributed in the hope that it will be useful,
  10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  12 # GNU General Public License for more details.
  13 #
  14 # You should have received a copy of the GNU General Public License
  15 # along with this program; if not, write to the Free Software
  16 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
  17
  18
  19 package project::Pod2Html;
  20 require 5.6.0;  # at least 'use warnings;' but we need some 5.6.0+ modules anyway
  21 our $VERSION=do { my @r=(q$Revision$=~/\d+/g); sprintf "%d.".("%03d"x$#r),@r; };
  22 our $CVS_ID=q$Id$;
  23 use strict;
  24 use warnings;
  25
  26 use My::Web;
  27
  28
  29 our $HTML_TEST="download";      # FIXME: See below!
  30 our $HTML_TEST_QUERY_STRING="cvs=captive/src/libcaptive/ke/captivesym.pl";
  31
  32 sub handler
  33 {
  34 my $W=My::Web->init(
  35                 "args_check"=>{
  36                                 "cvs"=>'^[\w\d][\w\d/.]*$',
  37                                 },
  38                 # FIXME:
  39                 # Do not: # Do not: "content_type"=>"text/html",
  40                 #         # or whatever as pod2html(1) already produces XHTML.
  41                 #         "header_only"=>"xml",
  42                 # as currently pod2html(1) produces invalid XHTML for: .../captivesym.pl
  43                 "content_type"=>"text/html",
  44                 "header_only"=>1,
  45                 "http_safe"=>0, # lynx(1) downloads.
  46                 );
  47 My::Web->heading();
  48
  49
  50 local *F;
  51 open F,"lynx -source ".$W->{"project_viewcvs"}."*checkout*/".$W->{"args"}{"cvs"}."?rev=HEAD"
  52                 # FIXME: "/tmp" - dangerous, not unique, currently creates: pod2htmd.tmp pod2htmi.tmp
  53                 ." |pod2html --cachedir=/tmp -"
  54                 ." |";
  55 print $_ while <F>;
  56 close F;
  57
  58
  59 exit;
  60 }
  61 1;