Changes needed to accomodate changes to the PG POD and sample problem generation.

First, there are some minor tweaks to the POD and sample problem viewers:

* Fix the wording on the sample problem viewer index page for "Sample
Problems by Macro".  It current says, "For many macros, this lists all
sample problems used by the macro."  However, macros do not use sample
problems.  Sample problems use macros.  So the wording is now, "For many
macros, this lists all sample problems that use the macro."

* Update the version of bootstrap in the POD templates to 5.3.7 which is
currently the latest.

* Update the links in the pod templates to wiki.openwebwork.org.

* Remove the `favicon` links.  Those are not explicitly needed.  Browser's
now load the favicon even if the page does not contain the link. The
link only needs to be added if the file is not named favicon.ico.

The following are the actual changes needed to accomodate changes to the
PG POD and sample problem generation:

* Remove files that are now used from the PG repository.

* Remove the PODViewer js and css files, the PODParser.pm and PODtoHTML.pm
modules, and category-index.mt and pod.mt templates, all of which are
now provided by PG.

* Make the necessary changes to the generate-ww-pg-pod.pl script so that
it can use those files from the PG repository.

* Update the SampleProblemParser module usage for its changes and
namespace change.

* The `WeBWorK::PG::SampleProblemParser` module now handles generation of
the actual search data with its `getSearchData` method.  So the
`WeBWorK::ContentGenerator::SampleProblemViewer` just calls that method.

* The `assets/stop-words-en.txt` file is now in the PG repository so that
the `WeBWorK::PG::SampleProblemParser::getSearchData` method can get at
it easily.

* The `htdocs/js/SampleProblemViewer/documentation-search.js` file is now
in the PG repository, and webwork2 uses it from there.  PG also copies
it to the PG docs github pages site in its new workflow. The options are
passed in via the script in `templates/ContentGenerator/SampleProblemViewer.html.ep`.

Author: drgrice1

assets/stop-words-en.txt

@@ -9,17 +9,16 @@ =head1 SYNOPSIS
 generate-ww-pg-pod.pl [options]
 
  Options:
-   -p|--pg-root          Directory containing  a git clone of pg.
-                         If this option is not set, then the environment
-                         variable $PG_ROOT will be used if it is set.
    -o|--output-dir       Directory to save the output files to. (required)
    -b|--base-url         Base url location used on server. (default: /)
                          This is needed for internal POD links to work correctly.
    -v|--verbose          Increase the verbosity of the output.
                          (Use multiple times for more verbosity.)
 
-Note that --pg-root must be provided or the PG_ROOT environment variable set
-if the POD for pg is desired.
+Note that C<pg_dir> must be set in the C<conf/webwork2.mojolicious.yml> file, or
+if that file does not exist then the clone of the PG repository must be located
+at C</opt/webwork/pg> as defined in the C<conf/webwork2.mojolicious.dist.yml>
+file.
 
 =head1 DESCRIPTION
 
@@ -30,37 +29,47 @@ =head1 DESCRIPTION
 use strict;
 use warnings;
 
+my ($webwork_root, $pg_root);
+
+BEGIN {
+	use File::Basename qw(dirname);
+	use Cwd            qw(abs_path);
+	use YAML::XS       qw(LoadFile);
+
+	$webwork_root = abs_path(dirname(dirname(dirname(__FILE__))));
+
+	# Load the configuration file to obtain the PG root directory.
+	my $config_file = "$webwork_root/conf/webwork2.mojolicious.yml";
+	$config_file = "$webwork_root/conf/webwork2.mojolicious.dist.yml" unless -e $config_file;
+	my $config = LoadFile($config_file);
+
+	$pg_root = $config->{pg_dir};
+}
+
 use Getopt::Long qw(:config bundling);
 use Pod::Usage;
 
-my ($pg_root, $output_dir, $base_url);
+my ($output_dir, $base_url);
 my $verbose = 0;
 GetOptions(
-	'p|pg-root=s'    => \$pg_root,
 	'o|output-dir=s' => \$output_dir,
 	'b|base-url=s'   => \$base_url,
 	'v|verbose+'     => \$verbose
 );
 
-$pg_root = $ENV{PG_ROOT} if !$pg_root;
-
-pod2usage(2) unless $output_dir;
+pod2usage(2) unless $output_dir && $pg_root && -d $pg_root;
 
 $base_url = "/" if !$base_url;
 
 use Mojo::Template;
 use IO::File;
 use File::Copy;
-use File::Path     qw(make_path remove_tree);
-use File::Basename qw(dirname);
-use Cwd            qw(abs_path);
-
-use lib dirname(dirname(dirname(__FILE__))) . '/lib';
-use lib dirname(__FILE__);
+use File::Path qw(make_path remove_tree);
 
-use PODtoHTML;
+use lib "$webwork_root/lib";
+use lib "$pg_root/lib";
 
-my $webwork_root = abs_path(dirname(dirname(dirname(__FILE__))));
+use WeBWorK::Utils::PODtoHTML;
 
 for my $dir ($webwork_root, $pg_root) {
 	next unless $dir && -d $dir;
@@ -73,10 +82,10 @@ =head1 DESCRIPTION
 write_index($index_fh);
 
 make_path("$output_dir/assets");
-copy("$webwork_root/htdocs/js/PODViewer/podviewer.css", "$output_dir/assets/podviewer.css");
-print "copying $webwork_root/htdocs/js/PODViewer/podviewer.css to $output_dir/assets/podviewer.css\n" if $verbose;
-copy("$webwork_root/htdocs/js/PODViewer/podviewer.js", "$output_dir/assets/podviewer.js");
-print "copying $webwork_root/htdocs/js/PODViewer/podviewer.css to $output_dir/assets/podviewer.js\n" if $verbose;
+copy("$pg_root/htdocs/js/PODViewer/podviewer.css", "$output_dir/assets/podviewer.css");
+print "copying $pg_root/htdocs/js/PODViewer/podviewer.css to $output_dir/assets/podviewer.css\n" if $verbose;
+copy("$pg_root/htdocs/js/PODViewer/podviewer.js", "$output_dir/assets/podviewer.js");
+print "copying $pg_root/htdocs/js/PODViewer/podviewer.css to $output_dir/assets/podviewer.js\n" if $verbose;
 
 sub process_dir {
 	my $source_dir = shift;
@@ -89,12 +98,15 @@ sub process_dir {
 	remove_tree($dest_dir);
 	make_path($dest_dir);
 
-	my $htmldocs = PODtoHTML->new(
-		source_root  => $source_dir,
-		dest_root    => $dest_dir,
-		template_dir => "$webwork_root/bin/dev_scripts/pod-templates",
-		dest_url     => $base_url,
-		verbose      => $verbose
+	my $htmldocs = WeBWorK::Utils::PODtoHTML->new(
+		source_root        => $source_dir,
+		dest_root          => $dest_dir,
+		template_dir       => "$pg_root/assets/pod-templates",
+		dest_url           => $base_url,
+		home_url           => $base_url,
+		home_url_link_name => 'WeBWorK POD Home',
+		page_url           => $base_url . ($source_dir =~ s|^.*/||r),
+		verbose            => $verbose
 	);
 	$htmldocs->convert_pods;