diff --git a/Dockerfile b/Dockerfile index 5556969c19f..e6abb286c99 100644 --- a/Dockerfile +++ b/Dockerfile @@ -1,6 +1,6 @@ # This Dockerfile is for testing only. -FROM bpssysadmin/rt-base-debian:RT-5.0.6-bullseye-20240430 +FROM bpssysadmin/rt-base-debian:RT-5.0.6-bullseye-20240506 ENV RT_TEST_PARALLEL 1 ENV RT_TEST_DEVEL 1 diff --git a/devel/tools/rt-static-docs b/devel/tools/rt-static-docs index 18e9dfd6883..3830ec0d743 100755 --- a/devel/tools/rt-static-docs +++ b/devel/tools/rt-static-docs @@ -144,22 +144,32 @@ else { # the known contents. for my $file () { (my $name = $file) =~ s{^.+/}{}; - my $dest = "$opts{to}/$name.html"; - - open my $source, "<", $file - or warn "Can't open $file: $!", next; my $str = ""; - $str .= encode_entities(decode_utf8($_)) while <$source>; - close $source; - $str = "
$str
"; - $str =~ s{\bdocs/([a-z_/-]+)\.pod\b}{docs/$1.pod}ig; - $str =~ s{\betc/(RT_Config)\.pm\b}{etc/$1.pm}g; - $str =~ s{\betc/(UPRGADING\.mysql)\b}{etc/$1}g; - $str =~ s{\b(https?://(?!rt\.example\.com)[.a-z0-9/_:-]+(?$1}ig; - $str =~ s{\b([\w-]+\@(lists\.)?bestpractical.com)\b}{$1}g; + if ( $name =~ s/\.md$// ) { + require Markdown::Render; + my $md = Markdown::Render->new( infile => $file ); + $str = $md->render_markdown->get_html; + $str =~ s{\bdocs/images/}{images/}g; + $str = qq{
$str
}; + } + else { + open my $source, "<", $file + or warn "Can't open $file: $!", next; + + $str .= encode_entities( decode_utf8($_) ) while <$source>; + close $source; + + $str = "
$str
"; + $str =~ s{\bdocs/([a-z_/-]+)\.pod\b}{docs/$1.pod}ig; + $str =~ s{\betc/(RT_Config)\.pm\b}{etc/$1.pm}g; + $str =~ s{\betc/(UPRGADING\.mysql)\b}{etc/$1}g; + $str =~ s{\b(https?://(?!rt\.example\.com)[.a-z0-9/_:-]+(?$1}ig; + $str =~ s{\b([\w-]+\@(lists\.)?bestpractical.com)\b}{$1}g; + } + my $dest = "$opts{to}/$name.html"; open my $html, ">", $dest or warn "Can't open $dest: $!", next; print $html $str; diff --git a/docs/extensions.pod b/docs/extensions.pod index ce607af7c48..f171d046136 100644 --- a/docs/extensions.pod +++ b/docs/extensions.pod @@ -17,9 +17,9 @@ L RT extensions should be installed by downloading the C<.tar.gz> file for the extensions, extracting it (with C), and -following the instructions in its included F. +following the instructions in its included C. -The instructions under C in the F always take +The instructions under C in the C always take precedence over those found here. In general, however, the process is as follows: diff --git a/docs/writing_extensions.pod b/docs/writing_extensions.pod index a69b2e41474..9c05f802cfb 100644 --- a/docs/writing_extensions.pod +++ b/docs/writing_extensions.pod @@ -352,7 +352,7 @@ When you have your extension ready and want to release it to the world, you can do so with a few simple steps. Assuming you have run C and you created the F -directory as described above, a F file will be created for you. You can +directory as described above, a C file will be created for you. You can now type: make manifest diff --git a/etc/cpanfile b/etc/cpanfile index 67df95875aa..0c5d6451814 100644 --- a/etc/cpanfile +++ b/etc/cpanfile @@ -145,6 +145,7 @@ on 'develop' => sub { requires 'Try::Tiny'; requires 'WWW::Mechanize', '>= 1.80'; requires 'XML::Simple'; + requires 'Markdown::Render'; };