Initial CI test of new CI setup

lizmat · lizmat · commit 2be04300f846 · 2025-11-06T13:52:40.000+01:00
And some doc tweaks
diff --git a/.github/workflows/linux.yml b/.github/workflows/linux.yml
@@ -0,0 +1,28 @@
+name: Linux
+
+on:
+  push:
+    branches:
+      - '*'
+    tags-ignore:
+      - '*'
+  pull_request:
+
+jobs:
+  raku:
+    strategy:
+      matrix:
+        os:
+          - ubuntu-latest
+        raku-version:
+          - 'latest'
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v3
+      - uses: Raku/setup-raku@v1
+        with:
+          raku-version: ${{ matrix.raku-version }}
+      - name: Install Dependencies
+        run: zef install --/test --test-depends --deps-only .
+      - name: Run Special Tests
+        run: raku run-tests -i
diff --git a/.github/workflows/macos.yml b/.github/workflows/macos.yml
@@ -0,0 +1,28 @@
+name: MacOS
+
+on:
+  push:
+    branches:
+      - '*'
+    tags-ignore:
+      - '*'
+  pull_request:
+
+jobs:
+  raku:
+    strategy:
+      matrix:
+        os:
+          - macos-latest
+        raku-version:
+          - 'latest'
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v3
+      - uses: Raku/setup-raku@v1
+        with:
+          raku-version: ${{ matrix.raku-version }}
+      - name: Install Dependencies
+        run: zef install --/test --test-depends --deps-only .
+      - name: Run Special Tests
+        run: raku run-tests -i
diff --git a/.github/workflows/test.yaml b/.github/workflows/test.yaml
diff --git a/.github/workflows/windows.yml b/.github/workflows/windows.yml
@@ -0,0 +1,28 @@
+name: Windows
+
+on:
+  push:
+    branches:
+      - '*'
+    tags-ignore:
+      - '*'
+  pull_request:
+
+jobs:
+  raku:
+    strategy:
+      matrix:
+        os:
+          - windows-latest
+        raku-version:
+          - 'latest'
+    runs-on: ${{ matrix.os }}
+    steps:
+      - uses: actions/checkout@v3
+      - uses: Raku/setup-raku@v1
+        with:
+          raku-version: ${{ matrix.raku-version }}
+      - name: Install Dependencies
+        run: zef install --/test --test-depends --deps-only .
+      - name: Run Special Tests
+        run: raku run-tests -i
diff --git a/.gitignore b/.gitignore
@@ -1,3 +1,3 @@
-precomp/
+.precomp/
 /Pod-To-HTML-*
 *.rakucov
diff --git a/META6.json b/META6.json
@@ -3,6 +3,8 @@
   "authors": [
     "Raku Community modules"
   ],
+  "build-depends": [
+  ],
   "depends": {
     "runtime": {
       "requires": [
@@ -31,9 +33,14 @@
     "templates/main.mustache",
     "css/github.css"
   ],
+  "source-url": "https://github.com/raku-community-modules/Pod-To-HTML.git",
   "support": {
     "bugtracker": null,
     "source": "git://github.com/Raku/Pod-To-HTML.git"
   },
+  "tags": [
+  ],
+  "test-depends": [
+  ],
   "version": "v0.8.1"
 }
diff --git a/README.md b/README.md
@@ -1,8 +1,7 @@
-Pod::To::HTML v0.8.1
-====================
-
-[![Test in a Raku container](https://github.com/Raku/Pod-To-HTML/actions/workflows/test.yaml/badge.svg)](https://github.com/Raku/Pod-To-HTML/actions/workflows/test.yaml)
+[![Actions Status](https://github.com/raku-community-modules/Pod-To-HTML/actions/workflows/linux.yml/badge.svg)](https://github.com/raku-community-modules/Pod-To-HTML/actions) [![Actions Status](https://github.com/raku-community-modules/Pod-To-HTML/actions/workflows/macos.yml/badge.svg)](https://github.com/raku-community-modules/Pod-To-HTML/actions) [![Actions Status](https://github.com/raku-community-modules/Pod-To-HTML/actions/workflows/windows.yml/badge.svg)](https://github.com/raku-community-modules/Pod-To-HTML/actions)
 
+Pod::To::HTML
+=============
 
 Raku module to render Pod as HTML.
 
@@ -11,45 +10,43 @@ Synopsis
 
 From the command line:
 
-    raku --doc=HTML lib/FancyModule.rakumod > FancyModule.html
+    $ raku --doc=HTML lib/FancyModule.rakumod > FancyModule.html
 
 From within Raku:
 
-    use Pod::To::HTML:auth<github:Raku>;
+```raku
+use Pod::To::HTML;
 
-    # Pod file
-    say render(
-        'your/file.pod'.IO,
-        title => 'My Own Title',
-        subtitle => 'On the Art of Making Titles',
-        lang => 'en',
-    );
+# Pod file
+say render(
+    'your/file.pod'.IO,
+    title => 'My Own Title',
+    subtitle => 'On the Art of Making Titles',
+    lang => 'en',
+);
+```
 
 Installation
 ------------
 
 From the [Raku ecosystem](https://modules.raku.org):
 
-    $ zef install Pod::To::HTML:author<github:Raku>
+    $ zef install Pod::To::HTML
 
 From source:
 
-    $ git clone https://github.com/Raku/Pod-To-HTML.git
+    $ git clone https://github.com/raku-community-modules/Pod-To-HTML.git
     $ cd Pod-To-HTML/
     $ zef install .
 
-**Note**: Perl 6 2018.06 introduces changes on how non-breaking whitespace was handled; this is now included in the tests. If the installation fails, please upgrade to Perl 6 >= 2018.06 or simply disregard the test and install with `--force` if that particular feature is of no use to you.
-
-**Note 2**: Perl6 2018.11 introduced handling of Definition blocks, `Defn`. Please upgrade if you are using that feature in the documentation.
-
 Description
 -----------
 
 `Pod::To::HTML` takes a Pod tree and outputs correspondingly formatted HTML using a default or provided Mustache template. There are two ways of accomplishing this:
 
-* from the command line, using `raku --doc=HTML`, which extracts the Pod from the document and feeds it to `Pod::To::HTML`.
+  * from the command line, using `raku --doc=HTML`, which extracts the Pod from the document and feeds it to `Pod::To::HTML`.
 
-* from within a Raku program via the exported `render` subroutine, which creates a complete HTML document from the Pod. This allows more customization (`title`, `subtitle`, and `lang` can override Pod's corresponding semantics, different Mustache template (possibly with partials), additional template variables for the template, etc.) than simply rendering the Pod via `raku --doc=HTML` which just use the default template.
+  * from within a Raku program via the exported `render` subroutine, which creates a complete HTML document from the Pod. This allows more customization (`title`, `subtitle`, and `lang` can override Pod's corresponding semantics, different Mustache template (possibly with partials), additional template variables for the template, etc.) than simply rendering the Pod via `raku --doc=HTML` which just use the default template.
 
 Exported subroutines
 --------------------
@@ -79,20 +76,22 @@ Template information
 
   * `footnotes`: The Pod document's [footnotes](https://docs.raku.org/language/pod#Notes).
 
-Additional information can be made available to the Mustache template by supplying to `render` as named arguments. For example, `css-url => https://design.raku.org/perl.css` will be available to the template as `css-url`.
+Additional information can be made available to the Mustache template by supplying to `render` as named arguments.
 
 ### Semantic Blocks
 
 Semantic blocks are treated as metadata and supplied as such to a Mustache template. For example, from the Pod document:
 
-    =begin pod
-    =TITLE Classes and objects
-    =SUBTITLE A tutorial about creating and using classes in Raku
-    =LANG English
-    =DATE January 01, 2020
-    =end pod
+```raku
+=begin pod
+=TITLE Classes and objects
+=SUBTITLE A tutorial about creating and using classes in Raku
+=LANG English
+=DATE January 01, 2020
+=end pod
+```
 
-the template variables `title`, `subtitle`, `lang`, and `date` are made available to a Mustache template. Both `title` and `subtitle` can be overridden via the `render` subroutine.
+The template variables `title`, `subtitle`, `lang`, and `date` are made available to a Mustache template. Both `title` and `subtitle` can be overridden via the `render` subroutine.
 
 **Note**: Pod's semantic blocks can be overridden via `render` by using a variable of the same name.
 
@@ -104,13 +103,49 @@ Check the [examples](resources/examples/README.md) directory (which should have
 Debugging
 ---------
 
-You can set the `P6DOC_DEBUG` environmental variable to make the module produce some debugging information.
+You can set the `RAKUDOC_DEBUG` environmental variable to make the module produce some debugging information.
+
+    RAKUDOC_DEBUG=1 raku --doc=HTML lib/FancyModule.rakumod > FancyModule.html
+
+AUTHORS
+=======
+
+  * Anthony Parsons
+
+  * Moritz Lenz
+
+  * Timo Paulssen
+
+  * Alex Moquin
+
+  * Wenzel P. P. Peppmeyer
+
+  * Zoffix Znet
 
-    P6DOC_DEBUG=1 raku --doc=HTML lib/FancyModule.rakumod > FancyModule.html
+  * Alex Chen
 
-License
--------
+  * JJ Merelo
 
-You can use and distribute this module under the terms of the The Artistic License 2.0. See the LICENSE file included in this distribution for complete details.
+  * Jonathan Stowe
+
+  * Richard Hainsworth
+
+  * Antonio Gamiz
+
+  * Oleksander Kiryuhin
+
+  * Elizabeth Mattijsen
+
+And many other Raku Community members.
+
+Source can be located at: https://github.com/raku-community-modules/Pod-To-HTML . Comments and Pull Requests are welcome.
+
+COPYRIGHT AND LICENSE
+=====================
+
+Copyright 2011-2025 Raku Community
+
+This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.
 
 The `META6.json` file of this distribution may be distributed and modified without restrictions or attribution.
+
diff --git a/dist.ini b/dist.ini
@@ -0,0 +1,11 @@
+name = Pod::To::HTML
+
+[ReadmeFromPod]
+filename = doc/Pod-To-HTML.rakudoc
+
+[UploadToZef]
+
+[Badges]
+provider = github-actions/linux.yml
+provider = github-actions/macos.yml
+provider = github-actions/windows.yml
diff --git a/doc/Pod-To-HTML.rakudoc b/doc/Pod-To-HTML.rakudoc
