add rakudoc-table plugin to render procedural tables

CHANGELOG.md

@@ -2,6 +2,11 @@
 >Change log
 
 
+# 2024-01-04 v4.10.1
+*  add rakudoc-table to plugins
+
+	*  the plugin adds procedural tables as defined in RakuDoc v2 to HTML2 only
+
 # 2023-12-22 v4.10.0
 *  modify rewrite-target to produce Raku/doc   markup targets
 
@@ -501,4 +506,4 @@ change testing
 
 
 ----
-Rendered from CHANGELOG at 2023-12-22T14:10:17Z
+Rendered from CHANGELOG at 2024-01-04T23:40:02Z

META6.json

@@ -1,7 +1,7 @@
 {
   "name": "Raku::Pod::Render",
   "description": "A generic Pod6 Renderer with custom Pod::Blocks, FormatCodes for one or more files using templates, provides HTML and MarkDown.",
-  "version": "4.10.0",
+  "version": "4.10.1",
   "perl": "6.d",
   "authors": [
     "Richard Hainsworth"
@@ -87,6 +87,15 @@
     "move-assets/cleanup.raku",
     "move-assets/templates.raku",
     "move-assets/README.rakudoc",
+    "rakudoc-table/config.raku",
+    "rakudoc-table/rakudoc-table-templates.raku",
+    "rakudoc-table/README.rakudoc",
+    "rakudoc-table/css/rakudoc-table-dark.css",
+    "rakudoc-table/css/rakudoc-table-light.css",
+    "rakudoc-table/scss/rakudoc-table-dark.scss",
+    "rakudoc-table/scss/rakudoc-table-light.scss",
+    "rakudoc-table/scss/_rakudoc-table.scss",
+    "rakudoc-table/scss/_themes-colors.scss",
     "styling/config.raku",
     "styling/_highlights.scss",
     "styling/rakudoc-styling.scss",

doc/CHANGELOG.rakudoc

@@ -2,6 +2,10 @@
 =TITLE Raku::Pod::Render
 =SUBTITLE Change log
 
+=head1 2024-01-04 v4.10.1
+=item add rakudoc-table to plugins
+=item2 the plugin adds procedural tables as defined in RakuDoc v2 to HTML2 only
+
 =head1 2023-12-22 v4.10.0
 =item modify rewrite-target to produce Raku/doc X<> markup targets
 =item2 Raku has `X<text|Head,item;Head2,item>` type markup

lib/Pod/To/HTML2.rakumod

@@ -57,7 +57,7 @@ class Pod::To::HTML2 is ProcessedPod {
     submethod TWEAK(
             :$highlight-code,
             :$type = 'rakuclosure',
-            :$plugins = <styling simple-extras graphviz latex-render images font-awesome>,
+            :$plugins = <styling simple-extras graphviz latex-render images font-awesome rakudoc-table>,
             :$add-plugins = '',
             :$def-dir
             # this option is for testing purposes

lib/Pod/To/MarkDown2.rakumod

@@ -1,5 +1,6 @@
 use ProcessedPod;
 use RenderPod::Exceptions;
+use JSON::Fast;
 
 unit class Pod::To::MarkDown2 is ProcessedPod;
 has $.def-ext is rw;

resources/rakudoc-table/README.rakudoc

@@ -0,0 +1,6 @@
+=begin pod
+=TITLE grid-block is a plugin for Collection
+
+The plugin is to render the enhanced C<=table> block
+
+=end pod

resources/rakudoc-table/config.raku

@@ -0,0 +1,13 @@
+%(
+	:auth<collection>,
+	:authors(
+		"finanalyst",
+	),
+	:custom-raku(),
+	:license<Artistic-2.0>,
+	:name<rakudoc-table>,
+	:render,
+	:css<css/rakudoc-table-light.css>,
+	:template-raku<rakudoc-table-templates.raku>,
+	:version<0.1.2>,
+)

resources/rakudoc-table/css/rakudoc-table-dark.css

@@ -0,0 +1,28 @@
+/* Basic code colors */
+.rakudoc-table .rakudoc-cell-center, .rakudoc-table .rakudoc-cell-centre {
+  text-align: center;
+}
+.rakudoc-table .rakudoc-cell-left {
+  text-align: left;
+}
+.rakudoc-table .rakudoc-cell-right {
+  text-align: right;
+}
+.rakudoc-table .rakudoc-cell-top {
+  vertical-align: top;
+}
+.rakudoc-table .rakudoc-cell-bottom {
+  vertical-align: bottom;
+}
+.rakudoc-table .rakudoc-cell-middle {
+  vertical-align: middle;
+}
+.rakudoc-table .rakudoc-cell-label {
+  text-align: left;
+  vertical-align: middle;
+  font-weight: 600;
+}
+.rakudoc-table.table tbody th {
+  text-align: center;
+  vertical-align: middle;
+}

resources/rakudoc-table/css/rakudoc-table-light.css

@@ -0,0 +1,28 @@
+/* Basic code colors */
+.rakudoc-table .rakudoc-cell-center, .rakudoc-table .rakudoc-cell-centre {
+  text-align: center;
+}
+.rakudoc-table .rakudoc-cell-left {
+  text-align: left;
+}
+.rakudoc-table .rakudoc-cell-right {
+  text-align: right;
+}
+.rakudoc-table .rakudoc-cell-top {
+  vertical-align: top;
+}
+.rakudoc-table .rakudoc-cell-bottom {
+  vertical-align: bottom;
+}
+.rakudoc-table .rakudoc-cell-middle {
+  vertical-align: middle;
+}
+.rakudoc-table .rakudoc-cell-label {
+  text-align: left;
+  vertical-align: middle;
+  font-weight: 600;
+}
+.rakudoc-table.table tbody th {
+  text-align: center;
+  vertical-align: middle;
+}

resources/rakudoc-table/rakudoc-table-templates.raku

@@ -0,0 +1,50 @@
+#!/usr/bin/env raku
+use v6.d;
+%(
+    'table' => sub (%prm, %tml) {
+        if %prm<procedural> {
+            my $rv = "\n<table class=\"table is-bordered centered rakudoc-table { %prm<class> // '' }\">";
+            $rv ~= "\n<caption>$_\</caption>" with %prm<caption>;
+            for %prm<grid>.list -> @row {
+                $rv ~= "\n<tr>";
+                for @row -> $cell {
+                    next if $cell<no-cell>;
+                    my $content;
+                    $content ~= ' colspan="' ~ $cell<span>[0] ~'"' if $cell<span>:exists and $cell<span>[0] != 1;
+                    $content ~= ' rowspan="' ~ $cell<span>[1] ~'"' if $cell<span>:exists and $cell<span>[1] != 1;
+                    $content ~= ' class="';
+                    with $cell<align> { for .list {
+                        $content ~= "rakudoc-cell-$_ "
+                    } }
+                    $content ~= 'rakudoc-cell-label' if $cell<label>;
+                    $content ~= '">' ~ $cell<data>;
+                    if $cell<header> {
+                        $rv ~= "<th$content\</th>"
+                    }
+                    else {
+                        $rv ~= "<td$content\</td>"
+                    }
+                }
+                $rv ~= "</tr>"
+            }
+            $rv ~= "</table>\n";
+        }
+        else {
+            '<table class="table is-bordered centered'
+                    ~ ((%prm<class>.defined and %prm<class> ne '') ?? (' ' ~ %tml<escaped>.(%prm<class>)) !! '')
+                    ~ '">'
+                    ~ ((%prm<caption>.defined and %prm<caption> ne '') ?? ('<caption>' ~ %prm<caption> ~ '</caption>') !! '')
+                    ~ ((%prm<headers>.defined and %prm<headers> ne '') ??
+            ("\t<thead>\n"
+                    ~ [~] %prm<headers>.map({ "\t\t<tr><th>" ~ .<cells>.join('</th><th>') ~ "</th></tr>\n" })
+                            ~ "\t</thead>"
+            ) !! '')
+                    ~ "\t<tbody>\n"
+                    ~ ((%prm<rows>.defined and %prm<rows> ne '') ??
+            [~] %prm<rows>.map({ "\t\t<tr><td>" ~ .<cells>.join('</td><td>') ~ "</td></tr>\n" })
+            !! '')
+                    ~ "\t</tbody>\n"
+                    ~ "</table>\n"
+        }
+    },
+)

resources/rakudoc-table/scss/_rakudoc-table.scss

@@ -0,0 +1,29 @@
+.rakudoc-table {
+    .rakudoc-cell-center, .rakudoc-cell-centre {
+        text-align: center;
+    }
+    .rakudoc-cell-left {
+        text-align: left;
+    }
+    .rakudoc-cell-right {
+        text-align: right;
+    }
+    .rakudoc-cell-top {
+        vertical-align: top;
+    }
+    .rakudoc-cell-bottom {
+        vertical-align: bottom;
+    }
+    .rakudoc-cell-middle {
+        vertical-align: middle;
+    }
+    .rakudoc-cell-label {
+        text-align: left;
+        vertical-align: middle;
+        font-weight: 600;
+    }
+    &.table tbody th {
+        text-align: center;
+        vertical-align: middle;
+    }
+}

resources/rakudoc-table/scss/_themes-colors.scss

@@ -0,0 +1,25 @@
+// Common theme colors
+
+$black:         #030303;
+$black-bis:     #1B1D1E;
+$black-ter:     #212426;
+
+$grey-darker:   #3A3D4E;
+$grey-dark:     #83858D;
+$grey:          #cccccc;
+$grey-light:    #d8d8d8;
+$grey-lighter:  #e5e5e5;
+$grey-lightest: #f2f2f2;
+
+$white-ter:     #f5f5f5;
+$white-bis:     #f7f7f7;
+$white:         #fafafa;
+
+$orange:       hsl(14,  100%, 53%);
+$yellow:       #EED891;
+$green:        #1C6301;
+$turquoise:    #005C43;
+$cyan:         hsl(204, 71%,  53%);
+$blue:         #004FB3;
+$purple:       #5503B3;
+$red:          #A30031;

resources/rakudoc-table/scss/rakudoc-table-dark.scss

@@ -0,0 +1,5 @@
+/* Basic code colors */
+@import '_themes-colors.scss';
+
+
+@import '_rakudoc-table.scss';

resources/rakudoc-table/scss/rakudoc-table-light.scss

@@ -0,0 +1,4 @@
+/* Basic code colors */
+@import '_themes-colors.scss';
+
+@import '_rakudoc-table.scss';