#!/usr/bin/perl -w # # Bacula Systems - Philippe Chauvat # 27 jul 2012 # 24-apr-2019: Adding font awesome css file # # This script is designed to translate Bacula enterprise LaTeX2HTML # documentation files to something more "tunable" / "adaptable" from a CSS # point of view. # # $1 is an HTML file to analyze and translate # The output is automatically send to $1.out # # - add some ids, class # - re-order some piece of HTML code # # This script is based on HTML::Parser module # # args: # -i: HTML input file # -o: HTML output file # -j: javascript directory # -c: css directory # -p: images (pictures) directory # -n: Manual name # -e: Request a menu extraction # -r: Source directory (ako part of -i arg) # -?: help / usage # -d: debug requested use HTML::Parser ; use HTML::TreeBuilder ; use HTML::PullParser ; use Getopt::Long ; use File::Basename ; use Data::Dumper ; use open qw/:std :utf8/; $edition = 'Bacula Edition' ; sub usage { print "translatedoc.pl -i | --input html-source-file [ -o | --output html-destination-file ] [ -j | --javascript javascript-diretory ] [ -c | --css css-directory ] [ -p | --pictures pictures-directory ] [ -n | --name manual_name ] [ -e | --extract ] [ -d | --debug ] [ -r | --source-directory the_original_root_directory ] [ --help | -? ]\n" ; exit 1 ; } # # Send message to output in case of debug only # ====================== sub debugdump { my ($what,$msg) = @_ ; if ($debug) { print "\n===============================\nBegin of $msg\n" ; $what->dump ; print "\n===============================\nEnd of $msg\n\n" ; } } # # Args to Vars our($inputfile,$outputfile,$help,$debug,$mytree,$extractmenu,$picturesdir, $cssdir,$javascriptdir,$manualname,$sourcedir) ; # # Usage in case of missing arguments usage() unless($#ARGV > -1) ; # # Input file / Output file GetOptions("input|i=s" => \$inputfile, "output|o=s" => \$outputfile, "extract|e" => \$extractmenu, "pictures|p=s" => \$picturesdir, "css|c=s" => \$cssdir, "source-directory|r=s" => \$sourcedir, "javascript|j=s" => \$javascriptdir, "name|n=s" => \$manualname, "debug|d" => \$debug, "help|?" => \$help) or usage() ; usage() if ($help) ; usage() unless (defined $inputfile) ; die "$inputfile does not exists.\n" unless -e $inputfile ; print "Converting file $inputfile\n" ; $outputfile = "./" . basename($inputfile) . ".out" unless defined($outputfile) ; $picturesdir = "../images" unless defined $picturesdir ; $cssdir = "../css" unless defined($cssdir) ; $javascriptdir = "../js" unless defined($javascriptdir) ; $manualname = "main" unless defined($manualname) ; my $MENUFILE="./wholemenu_" . $manualname . ".htm" ; # # Build HTML Tree of existing page $mytree = HTML::TreeBuilder->new ; $mytree->parse_file($inputfile) ; debugdump($mytree,"Read tree") ; # # Find the beginning of the content # Which is also a point where to put # the menu $beginning_of_content = $mytree->look_down('_tag','h1') ; debugdump($beginning_of_content,"Beginning of content H1") ; if (! $beginning_of_content) { $beginning_of_content = $mytree->look_down('_tag','h2') ; debugdump($beginning_of_content,"Beginning of content H2") ; } die "The only thing we could test is a