bin/pod2x

   1 #!/usr/bin/perl -w
   2
   3 use strict;
   4 use WWW::Mediawiki::Client;
   5 #sub WWW::Mediawiki::Client::pagename_to_url {
   6 #    my ($self, $name, $action) = @_;
   7 #    WWW::Mediawiki::Client::URLConstructionException->throw(
   8 #            error => 'No action supplied.',
   9 #        ) unless $action;
  10 #    WWW::Mediawiki::Client::URLConstructionException->throw(
  11 #            error => "Page name $name ends with '.wiki'.",
  12 #        ) if $name =~ /.wiki$/;
  13 #    my $char = $self->space_substitute;
  14 #    $name =~ s/ /$char/;
  15 #    my $lang = $self->language_code;
  16 #    my $host = $self->host;
  17 #    $host =~ s/__LANG__/$lang/g;
  18 #    my $wiki_path = $self->wiki_path;
  19 #    $wiki_path =~ s/__LANG__/$lang/g;
  20 #    my $protocol = $self->protocol;
  21 #    return "$protocol://$host/$wiki_path?" . ACTION . "=$action&" . TITLE . "=$name" . '&wpRecreate=1';
  22 #}
  23
  24 my $mw_username = 'ivan';
  25 chomp( my $mw_password = `cat .mw-password` );
  26
  27 my $site_perl = "./FS";
  28 my $html = "Freeside:1.7:Documentation:Developer";
  29
  30 foreach my $dir (
  31   $html,
  32   map "$html/$_", qw( bin FS FS/UI FS/part_export FS/part_pkg
  33                       FS/ClientAPI FS/Cron FS/Misc FS/Report FS/Report/Table
  34                       FS/TicketSystem FS/UI
  35                       FS/SelfService
  36                     )
  37 ) {
  38   -d $dir or mkdir $dir;
  39 }
  40
  41 $|=1;
  42
  43 die "Can't find $site_perl" unless -d $site_perl;
  44 #die "Can't find $catman" unless -d $catman;
  45 -d $html or mkdir $html;
  46
  47 my $count = 0;
  48
  49 #make some useless links
  50 foreach my $file (
  51   glob("$site_perl/bin/freeside-*"),
  52 ) {
  53   next if $file =~ /\.pod$/;
  54   #symlink $file, "$file.pod"; # or die "link $file to $file.pod: $!";
  55   #system("cp $file $file.pod");
  56   -e "$file.pod" or system("cp $file $file.pod");
  57 }
  58
  59 my $mvs = WWW::Mediawiki::Client->new(
  60             'host'           => 'www.freeside.biz',
  61             'wiki_path'      => 'mediawiki/index.php',
  62             'username'       => $mw_username,
  63             'password'       => $mw_password,
  64             #'commit_message' => 'import from POD'
  65           );
  66
  67 $mvs->do_login;
  68
  69 my @files;
  70 if ( @ARGV ) {
  71   @files = @ARGV;
  72 } else {
  73   @files = (
  74     glob("$site_perl/*.pm"),
  75     glob("$site_perl/*/*.pm"),
  76     glob("$site_perl/*/*/*.pm"),
  77     glob("$site_perl/*/*/*/*.pm"),
  78     glob("$site_perl/bin/*.pod"),
  79     glob("./fs_selfservice/FS-SelfService/*.pm"),
  80     glob("./fs_selfservice/FS-SelfService/*/*.pm"),
  81   ) ;
  82 }
  83
  84 foreach my $file (@files) {
  85   next if $file =~ /(^|\/)blib\//;
  86   next if $file =~ /(^|\/)CVS\//;
  87   #$file =~ /\/([\w\-]+)\.pm$/ or die "oops file $file";
  88   my $name;
  89   if ( $file =~ /fs_\w+\/FS\-\w+\/(.*)\.pm$/ ) {
  90     $name = "FS/$1";
  91   } elsif ( $file =~ /$site_perl\/(.*)\.(pm|pod)$/ ) {
  92     $name = $1;
  93   } else {
  94     die "oops file $file";
  95   }
  96
  97   #exit if $count++ == 10;
  98
  99   my $htmlroot = join('/', map '..',1..(scalar($file =~ tr/\///)-2)) || '.';
 100
 101   system "pod2wiki  --style mediawiki $file >$html/$name.rawwiki";
 102
 103   if ( -e "$html/$name.rawwiki" ) {
 104     print "processing $name\n";
 105   } else {
 106     print "skipping $name\n";
 107     next;
 108   };
 109
 110   $mvs->do_update("$html/$name.wiki");
 111
 112   open(RAW, "<$html/$name.rawwiki") or die $!;
 113   open(WIKI,">$html/$name.wiki"   ) or die $!;
 114   while (<RAW>) {
 115     s/\[\[([^#p][^\]]*)\]\]/"[[$html\/". w_e($1). "|$1]]"/ge;
 116     print WIKI $_;
 117   }
 118   close RAW;
 119   close WIKI;
 120
 121   print "  uploading to ". $mvs->filename_to_pagename("$html/$name.wiki"). "\n";
 122   $mvs->commit_message( 'import from POD' );
 123   $mvs->do_commit("$html/$name.wiki");
 124
 125 }
 126
 127 sub w_e {
 128   my $s = shift;
 129   $s =~ s/_/ /g;
 130   $s =~ s/::/\//g;
 131   $s =~ s/^freeside-/bin\/freeside-/g;
 132   $s;
 133 }
 134
 135
 136 ##  system "pod2text $file >$catman/$name.txt";
 137 ##
 138 #  system "pod2html --podroot=$site_perl --podpath=./FS:./FS/UI:.:./bin --norecurse --htmlroot=$htmlroot $file >$html/$name.html";
 139 #  #system "pod2html --podroot=$site_perl --htmlroot=$htmlroot $file >$html/$name.html";
 140 ##  system "pod2html $file >$html/$name.html";
 141 ##
 142
 143 #remove the useless links
 144 unlink glob("$site_perl/bin/*.pod");
 145