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_QUERY_STRING=[
  30         "cvs=captive/src/libcaptive/ke/captivesym.pl",
  31         "cvs=macros/AutoGen.pm",
  32         ];
  33
  34 sub handler
  35 {
  36 my $W=My::Web->init(
  37                 "args_check"=>{
  38                                 "cvs"=>'^[\w\d][\w\d/.]*$',
  39                                 },
  40                 # Requires: Pod::Html patch from: Perl Bug # 37250
  41                 # From: <rt-3.0.11-37250-122352.19.7520280058314@perl.org>
  42                 # Do not: "content_type"=>"text/html",
  43                 # or whatever as pod2html(1) already produces XHTML.
  44                 # Do not: "header_only"=>"xml",
  45                 # as pod2html(1) already provides the <?xml ?> header.
  46                 "header_only"=>1,
  47                 # Match the pod2html(1) <meta/> tag.
  48                 "charset"=>"utf-8",
  49                 "http_safe"=>0, # lynx(1) downloads.
  50                 );
  51 My::Web->heading();
  52
  53
  54 local *F;
  55 open F,"lynx -source ".$W->{"project_viewcvs"}."*checkout*/".$W->{"args"}{"cvs"}."?rev=HEAD"
  56                 # FIXME: "/tmp" - dangerous, not unique, currently creates: pod2htmd.tmp pod2htmi.tmp
  57                 ." |pod2html --cachedir=/tmp -"
  58                 ." |";
  59 my $first=<F>;
  60 $first=undef() if $first && $W->{"content_type"} eq "text/html" && $first=~/^\Q<?xml\E\b.*\Q?>\E\s*$/s;
  61 print $first if $first;
  62 print $_ while <F>;
  63 close F;
  64
  65
  66 exit;
  67 }
  68 1;