import-in-astro.sh: Nav-Stubs für Seiten mit mehreren Elternteilen

Wenn eine Seite in stili-json in mehreren childs-Listen auftaucht (z.B.
*-mojo.html sowohl in plugin-info.html.childs als auch in index.html.childs),
wurde bisher nur der kanonische Ort (aus crumbs/path) berücksichtigt.

Das Skript erstellt jetzt zusätzlich leere Stub-Content-Dateien an allen
nicht-kanonischen Positionen im Verzeichnisbaum. Die Stubs haben denselben
Frontmatter wie die kanonische Datei (inkl. url), aber keinen Body und keine
Routing-Datei. Dadurch erscheint die Seite an mehreren Stellen im Nav-Baum
des Renderers, wobei alle Links auf dieselbe URL zeigen.

CLAUDE.md dokumentiert das Konzept inkl. Beispiel.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Update GitHub Actions: checkout@v5, setup-java@v5 (Node.js 24)

Fixed project-url

Use StILi itself as its own Maven site skin (dogfooding)

site.xml now references ${project.groupId}:${project.artifactId}:${project.version}
instead of maven-fluido-skin. Removes the now-unused maven-fluido-skin.version
property from pom.xml.

Build requires ./mvnw clean install site so the skin is installed to the
local repository before the site phase resolves it as a dependency.

Update pom.xml: SCM and project URL to GitHub

Add GitHub Actions CI workflow (clean install site)

Add LGPL 3.0 LICENSE file

Add CLAUDE.md and AGENTS.md; project docs now live in README.md

New CLAUDE.md contains only AI working rules and regeneration
instructions, and references README.md for project documentation.
AGENTS.md is a short pointer for other AI coding assistants.

Rewrite README.md for GitHub: English, public-facing documentation

Removes AI working instructions; keeps project documentation (What is
StILi, Quick Start, How It Works, Import Scripts, Building). Content is
adapted from the former CLAUDE.md and src/site/markdown/index.md.

Rename CLAUDE.md to README.md

Revert "Align enforcer minimum Maven version with wrapper: 3.8.5 → 3.9.16"

This reverts commit 601136c783bb55d3b3d7b4d3d106571fe9fd47cf.

Align enforcer minimum Maven version with wrapper: 3.8.5 → 3.9.16

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Update Maven Wrapper: 3.9.6 → 3.9.16

Latest stable release as of 2026-06-17 (https://maven.apache.org/download.cgi).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Fix mvnw: pass MAVEN_OPTS as env var, not as command-line args

MAVEN_OPTS contains JVM flags (e.g. -Xms256m -Xmx512m). Passing them
as positional arguments to mvn causes Maven to interpret them as unknown
lifecycle phases. Fix: export MAVEN_OPTS so Maven reads and forwards it
to the JVM itself, as intended.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Fix mvnw: wrong MAVEN_HOME path and unzip overwrites

Two bugs introduced in the initial mvnw script:

1. apache-maven-3.9.6-bin.zip extracts into apache-maven-3.9.6/ (without
   the -bin suffix), but MAVEN_HOME was set to $DISTRIBUTION_ID which
   includes -bin. Fix: strip -bin suffix with ${DISTRIBUTION_ID%-bin}.

2. unzip without -o flag asks interactively when the cache directory
   already contains files from a previous (partial) run. Fix: add -o
   (overwrite silently).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Add Maven Wrapper 3.3.2 with Maven 3.9.6

Adds the standard Maven Wrapper (JAR-less, Apache Maven Wrapper 3.3.2)
so that the project can be built without a pre-installed Maven.
The wrapper downloads Maven 3.9.6 on first use and caches it locally.

- .mvn/wrapper/maven-wrapper.properties: distribution URL for 3.9.6
- mvnw: Unix startup script (executable)
- mvnw.cmd: Windows startup script
- CLAUDE.md: document wrapper usage, version update procedure, and
  the new rule to verify the build after each commit

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

CLAUDE.md: Minimale Diffs als allgemeine Arbeitsregel

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Apply Maven POM best practices: pluginManagement, properties, enforcer

- properties: add reporting.outputEncoding, project.build.outputTimestamp
  (reproducible builds); extract all plugin versions as properties with
  standard {artifactId}.version naming; add maven-fluido-skin.version
  (referenced from site.xml via filtering, so stays in sync)
- pluginManagement: declare explicit versions for all Maven lifecycle
  plugins (clean, resources, compiler, jar, install, deploy) — overrides
  outdated oss-parent:9 defaults — plus enforcer and site plugin with
  their full configuration (moves config out of <plugins> into mgmt)
- maven-enforcer-plugin: require Maven >= 3.8.5 (no Java version rule
  since the project has no Java sources)
- maven-resources-plugin: upgrade 2.7 → 3.3.1; remove explicit
  maven-filtering:1.3 dependency (no longer needed in 3.x); rename
  execution id copy-resources → filter-site-resources for clarity
- site.xml: use ${maven-fluido-skin.version} property (filtered at
  pre-site phase, single source of truth in pom.xml properties)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Remove scm and dependency-info reports (Doxia 1.11.x incompatibility)

Both reports fail at runtime with NoSuchMethodError: Sink.verbatim()
because maven-project-info-reports-plugin 3.7.0 uses an older
maven-reporting-impl that calls the no-arg verbatim() variant, which
was removed in Doxia 1.11.x (shipped with maven-site-plugin 3.12.1).

The information covered by these reports (SCM URLs, Maven coordinates)
is already documented in index.md and visible in the POM.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Fix maven-site-plugin/fluido-skin version incompatibility

maven-fluido-skin 1.12.0 requires Doxia Sitetools [1.11.1, 2.0.0-M1),
but maven-site-plugin 3.9.1 only ships 1.9.2.

Upgrade maven-site-plugin 3.9.1 → 3.12.1 (ships Doxia Sitetools 1.11.1)
and align doxia-module-markdown to 1.11.1 accordingly.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Add Maven site documentation generated from CLAUDE.md

Replace outdated XHTML stubs (copied from a different project) with
proper Markdown documentation covering the StILi architecture and both
import scripts. CLAUDE.md is the SSOT; the site docs are regenerated
from it on demand, not automatically before each release.

Changes:
- src/site/site.xml: rewrite for StILi (maven-fluido-skin, clean nav)
- src/site/markdown/index.md: overview, name origin, quick start,
  community extensibility model
- src/site/markdown/architecture.md: site.vm mechanics, stili-json
  format, page types, body extraction
- src/site/markdown/import-in-hugo.md: full Hugo script reference
- src/site/markdown/import-in-astro.md: full Astro script reference
- src/site/xhtml/: remove four legacy XHTML stubs from Thymeleaf skin
- pom.xml: add doxia-module-markdown dependency, update
  maven-project-info-reports-plugin 2.9 → 3.7.0 with explicit report
  set (index, summary, licenses, team, scm, dependency-info, plugins)
- CLAUDE.md: add documentation section with SSOT contract, file
  mapping, regeneration rules and minimal-diff principle

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Rename sili → StILi: update all identifiers and documentation

The project identifier is renamed from the informal "sili" to "StILi"
((St)atic (I)mport site (Li)berator), which makes the purpose explicit
and sounds like the German/Italian word for "style".

- pom.xml: artifactId maven-siteliberator-skin → maven-stili-skin,
  updated name, description, and SCM URLs
- site.vm: HTML IDs sili-title/sili-body/sili-json → stili-*
- import scripts: stili-json pattern, mention StILi skin in usage text,
  add --base option to import-in-astro.sh (general-purpose support)
- CLAUDE.md: rewritten with name origin, community architecture model,
  and updated stili-* references throughout

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Fix three regressions introduced by the previous simplification

1. URL normalization: "/${VAR##//}" strips the leading slash when the
   input already starts with "/". Fix: strip trailing and leading slash
   separately, then prepend "/": VAR="${2%%/}"; VAR="/${VAR##/}".
   Affects --current, --archived, and --canonical in both scripts.
   Consequences: missing leading "/" in frontmatter url/canonical fields
   (Hugo+Astro) and in the static-copy destination path (Hugo).

2. Root page title (Hugo+Astro): TITLE_YAML was unified to use
   $PAGE | jq '.name' for all pages. For index.html the Maven project
   name must come from $JSON | jq '.project', not from the site.xml
   page name. Moved TITLE_YAML assignment into the if/else branches.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Clean up and align import-in-hugo.sh and import-in-astro.sh

Both scripts now share identical structure for argument parsing,
validation, JSON extraction, and the HTML file loop:
- CURRENT_BOOL variable (was: CURRENT converted to string in-place)
- jq-quoted TITLE_YAML for safe YAML output
- Skip files with no page entry (WARN + continue) in both scripts
- Consistent output messages (Content:/Static:/Routing:)
- Summary block at the end of both scripts

import-in-hugo.sh fixes:
- Remove debug output per file (echo "Found $FILE:", jq -C per entry)
- Fix URL bug in directory redirect pages ($URL was last HTML file's URL)
- Fix basename usage: basename "$SOURCE" not basename $SOURCE $SCRIPT_DIR
- Quote all variable expansions
- Fix inconsistent indentation in error blocks
- Redirect page HTML: use properly quoted echo with single/double quotes

import-in-astro.sh cleanup:
- Remove inline comments that belong in CLAUDE.md
- Simplify URL_BASE derivation to if/elif/else
- Remove ENTRY_ID intermediate variable (inline into printf directly)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Add CLAUDE.md documenting skin architecture and import scripts

Covers site.vm behavior, sili-json structure, page types, body
extraction, and both import scripts with their target-system specifics.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Add import-in-astro.sh for importing Maven site output into Astro

Replaces import-in-hugo.sh for the new Astro-based website. Key
differences vs. the Hugo version:
- Content → src/content/projects/PROJECT/VERSION/ (HTML + YAML frontmatter)
- Routing → src/pages/PROJECT/ (current) or src/pages/projects/P/V/ (archived)
- Static  → public/projects/PROJECT/VERSION/
- No Hugo shortcode transformation for <pre> blocks
- Relative generated-doc dir links (apidocs/, xref/ etc.) are rewritten
  to absolute /projects/X/Y/DIR/index.html URLs, because these dirs always
  live under /projects/ regardless of whether the content page is served
  from the visible (/<project>/) or archived (/projects/X/Y/) URL

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Reworked Hugo-script: refined/simplified cli-switches

Added a switch to overwrite the artifact-id

Added additional `params` in the front-matter for the redirect-pages

Fixed the `url`-parameter for the redirect-pages in front-matter

Fixed path for the redirect-pages beneath `project/reports/*`

Refined usage-description in `import-in-hugo.sh`

`import-in-hugo.sh` renders _only_ current _or_ archived

* The artifact-id and the version of the project are _always_ added to the
  specified base-path.
* If a *current* version is copied the version is dropped from the path
  that is added as `url` to front-matter.
* If a *archived* version is copied, the path of the current version is
  added as `params.canonical` to front-matter.

`import-in-hugo.sh` renders current vs. archived

`import-in-hugo.sh` converts code-blocks back into valid markdown

`import-in-hugo.sh` prints out the found pages

`import-in-hugo.sh` adds `article` as fixed layout in front-matter

`import-in-hugo.sh` uses the project-name for the entry-page

The import for Hugo adds page-weights

Added a script `import-in-hugo.sh` that imports the site into Hugo

Added `index.html` as root of the site-hierarchy

Refined logging (logging is optional and done through HTML-comments)

Added backward-compatibility for Doxia < 2.x

Only valid HTML is rendered into the generated pages

- The *page title* is rendered inside a `<h1>`-tag at the beginning of a
  generated page. This tag can be easily referenced from CSS and HTML by
  its `id`-attribute *sili-title*, or replaced with the help of `sed` in
  a post-processing script.
- The *page body* is rendered insied a `<div>`-tag with the `id`
  *sili-body*.
- The generated JSON, that captures the project meta-data and the site
  structure, is rendered insiede a `<script>`-tag with the `id`
  *sili-json*.

Removed all indentation and blank lines from the velocity-markup

Removed hugo-specific markup and moved the project meta-data into JSON

Added hardcoded adjustments for Mojo-helppages of a maven-plugin

Added the attribute `path` to the calculated page-data

Menu-entries for generated pages can be renamed, when linked in the menu

Refactored (and renamed) the Skin for the Hugo site-generator

Released version 1.1.2

Fixed the generation of the canonical links in `_canonical`

Added a parameter "flat" to generate all links as canonical links

Released version 1.1.1

Added the entry "_canonical" with mappings from uris to canonical links

Added a parameter "prefix" that is added to non-canonical uris

Added a default and a warning an undefined command

Fixed the URI-path for the documentation

Prepared for feature release 1.1.1

Released version 1.1.0

Added usage documentation

Made the thymeleaf-command that decorates the template configurable

Added the variants of the page-uri as selectable content

Added title and short title as selectable content

The JSON is rendered in the page and picked up there by thymeleaf

Upgraded maven-site-plugin from 3.5.1 to 3.9.1

Shortend the name and description of the the artifact

Prevented the override of the entry-page with the changed title "About"

* The maven-site-plugin includes an entry for the index.html in the root
  of the documentation in the subdirectory "Project Info".
* This entry must be droped, because it overrides the correct definition
  for that page with a false title ("About") and path (the page is added
  as a child of the submenu "Project Info").

The index.html from the documentation-root is explicitly added as page

* Before, it was only added to the stack as a starting point for the
  computation of all available pages
* The effective entry for the page was only generated, becaus the
  maven-site-plugin also adds this page as part of the submenu "Project Info"

Updated signature of fragement-replacment

Prepared for feature release 1.0.x

Released version 1.0.1

Normal links are renderd with a version-subdirectory - canonical without

Supressed duplicate entries in breadcrumbs

Prepared for bugfix-release 1.0.1

Released version 1.0.0

Replaced layout-decorator the according build-in feature of thymeleaf 3.x

Also:

* Refactored the generated JSON
* Made the JSON-generation more readable with the help of indentation

Fixed possible NullPointerException during link-calculation

Fixed problems with the page-title

The <title>-tag of the page is taken from the velocity-variable tile, if
the variable shortTitle is set. For XHTML-templates, this is the case, if
the <title>-tag on the input-xhtml is set. If the variable is not set, the
page-title is constructed from the project-name and the name of the page,
that was found in the menu-data.

A leading head in the content is not generated automatically, because the
pages, that are generated automatically by maven differ to much. Hence, the
leading head in the content must be specified by hand in the content.

Shortened process-debugging comments

The comments were shortened, because the thymeleaf-parser was stumbeling
over the uncut version.

Added information about the linked project

Added information about the used license

Added information about the organization

Convertet project into a sonatype oss-project

Added minimal documentation

Fixed supplement-breadcrumbs: the path contained one entry too much

JSON is handed to the thymeleaf-layout-template via th:with

The page-data is handed to the template via th:with als variable "json".

Added child-pages to home-page

Commented out the processing-comments for thymeleaf

Fixed the URI and the name of the home-page in the breadcrumb-path

This page must have the URI "index.html" and should be named after the
project.

Added the project-site itself to the breadcrumb-path

Added convenient links to browse and check the generated templates

Fixed XML-syntax: comments must not cotain "--"

Relative URI's and breadcrumb-paths can be converted into absolute ones

Defined custom variables custom.path and custom.crumbs in site.xml, that
can be used to convert the relative URI's and breadcrumb-paths into absolute
ones.

Read in extra-info from site.xml

The attributes "title", "alt" and "img" for the tags <menu> and <item>
of the site.xml are read in. For <item>-tags, these entries are made
available in the page-definition. For the manually defined menu (the one
without a name!), as top-level variables "site_title", "site_alt" and
"site_img".

Added start-page to the breadcrumb-path

Rendering page-data as JSON

 * The JSON-data is now generated from the read in page-data.
 * The data is passed to the thymeleaf-dialect "juplo:variables".
 * The old breadcrumb-macro was removed.

Reworked the processing of the page-data (again)

Breadcrumb-paths are generated for all pages.

Reworked the processing of the page-data

Automatically generated pages can be overwriten in the manually defined
menu. Overwriting a URI will result in the changing of the name of the
page. Child-pages be kept in place, if present. If an automatically
generated page is overwriten in the manually defined menu, it will not
be removed form the original menu, but its breadcrumb-data will reflect
the position of the manually defined entry.

Implementation:
The data is read into a map. The unnamed menus will be read in last,
because this are usually the manually defined menus. If an URI is encountered
again, the last read version of the defined page will win and overwrite the
previously read definition, but the defined child-pages will not be touched.

Integrated page-data