Create website

Author: xoofx

.github/workflows/ci.yml

@@ -3,7 +3,7 @@ name: ci
 on:
   push:
     paths-ignore:
-    - 'doc/**'
+    - 'site/**'
     - 'img/**'
     - 'readme.md'
   pull_request:
@@ -16,4 +16,4 @@ jobs:
         uses: xoofx/.github/.github/actions/dotnet-releaser-action@main
         with:
           NUGET_TOKEN: ${{ secrets.NUGET_TOKEN }}
-          GIST_GITHUB_TOKEN: ${{ secrets.GIST_GITHUB_TOKEN }}
+          GIST_GITHUB_TOKEN: ${{ secrets.GIST_GITHUB_TOKEN }}

.gitignore

@@ -370,3 +370,7 @@ tmp/
 
 # Remove artifacts produced by dotnet-releaser
 artifacts-dotnet-releaser/
+
+# Ignore Lunet build output
+.lunet/build
+site/.lunet/build

AGENTS.md

@@ -1,14 +1,14 @@
-# XenoAtom.Logging — Codex Agent Instructions
+# XenoAtom.CommandLine — Codex Agent Instructions
 
 **XenoAtom.CommandLine** is a lightweight, powerful and NativeAOT friendly command line parser for .NET
 
 Paths/commands below are relative to this directory.
 
 ## Orientation
 
-- Library: `src/XenoAtom.Logging/`
-- Tests: `src/XenoAtom.Logging.Tests/` (MSTest)
-- Docs to keep in sync with behavior: `readme.md` and the docs under `doc/` (e.g., `doc/**/*.md`)
+- Library: `src/XenoAtom.CommandLine/`
+- Tests: `src/XenoAtom.CommandLine.Tests/` and `src/XenoAtom.CommandLine.Terminal.Tests/` (MSTest)
+- Docs to keep in sync with behavior: `readme.md` and the docs under `site/docs/` (e.g., `site/docs/**/*.md`)
 
 ## Build & Test
 
@@ -19,6 +19,12 @@ dotnet build -c Release
 dotnet test -c Release
 ```
 
+```sh
+# from the project root (this folder), when site/docs changes
+cd site
+lunet build
+```
+
 All tests must pass and docs must be updated before submitting.
 
 ## Contribution Rules (Do/Don't)

readme.md

@@ -205,30 +205,24 @@ var app = new CommandApp("myexe", config: new CommandConfig
 This package also provides `command.ToHelpVisual(...)` for embedding help in Terminal.UI apps.
 For one-shot rendering, `Terminal.Write(...)` is lazily initialized and does not require an explicit terminal session.
 
-Example of the advanced sample with markup help:
+Example of the advanced sample:
 
-![Example advanced markup](./img/advanced-markup.png)
-
-Example of the advanced sample with visual help:
-
-![Example advanced visual](./img/advanced-visual.png)
-
-Example of the advanced sample with an error:
-
-![Example advanced error](./img/advanced-error-visual.png)
+![Terminal UI help output](https://raw.githubusercontent.com/XenoAtom/XenoAtom.CommandLine/main/site/img/xenoatom-commandline-show.gif)
 
 ## 📃 Documentation
 
 | Guide | Description |
 |---|---|
-| [Getting Started](doc/getting-started.md) | Installation, first application, running and testing |
-| [Options](doc/options.md) | Option prototypes, values, flags, aliases, bundling, key/value pairs, typed parsing |
-| [Commands](doc/commands.md) | Commands, sub-commands, actions, and conditional groups |
-| [Arguments](doc/arguments.md) | Positional arguments, cardinality, remainder arguments |
-| [Validation & Constraints](doc/validation.md) | Value validation, mutually exclusive options, requires constraints |
-| [Help & Output](doc/help-output.md) | Help text, `CommandUsage`, custom output rendering, Terminal package |
-| [Advanced Topics](doc/advanced.md) | Parse API, shell completions, response files, configuration, environment variables, performance |
-| [Migration 2.0](doc/migration-2.0.md) | Breaking changes and upgrade steps |
+| [Getting Started](site/docs/getting-started.md) | Installation, first application, running and testing |
+| [Options](site/docs/options.md) | Option prototypes, values, flags, aliases, bundling, key/value pairs, typed parsing |
+| [Commands](site/docs/commands.md) | Commands, sub-commands, actions, and conditional groups |
+| [Arguments](site/docs/arguments.md) | Positional arguments, cardinality, remainder arguments |
+| [Validation & Constraints](site/docs/validation.md) | Value validation, mutually exclusive options, requires constraints |
+| [Help & Output](site/docs/help-output.md) | Help text, `CommandUsage`, custom output rendering, Terminal package |
+| [Advanced Topics](site/docs/advanced.md) | Parse API, shell completions, response files, configuration, environment variables, performance |
+| [Migration 2.0](site/docs/migration-2.0.md) | Breaking changes and upgrade steps |
+
+Most users migrating from 1.x should have little or no impact; check [Migration 2.0](site/docs/migration-2.0.md) for a quick impact checklist.
 
 ## 🏗️ Build
 

site/.nojekyll

@@ -0,0 +1 @@
+

site/AGENTS.md

@@ -0,0 +1,38 @@
+---
+discard: true # Disable this page for website generation
+---
+
+# Website (lunet) Contribution Instructions
+
+This folder contains the static website for XenoAtom.CommandLine, built with **lunet**.
+
+## Structure
+
+- `site/readme.md` -> home page (`/`)
+- `site/docs/**` -> documentation section (`/docs/**`)
+  - `site/docs/menu.yml` -> sidebar menu for docs pages
+- `site/menu.yml` -> top navigation (navbar)
+- `site/.lunet/**` -> layouts, CSS, JS, and build output
+  - `site/.lunet/layouts/**` -> Scriban HTML layouts
+  - `site/.lunet/css/**` / `site/.lunet/js/**` -> site assets
+  - `site/.lunet/build/**` -> generated output (cache + `www/`)
+
+## Building the website
+
+Install lunet (once):
+
+`dotnet tool install -g lunet`
+
+Build the site (always run this after changing `site/**`):
+
+`lunet build`
+
+Run from the `site` folder.
+
+## Notes for agents
+
+- `readme.md` in a folder becomes the folder's `index.html`. Keep these `readme.md` files compatible with both GitHub and the website.
+- Update menus when adding/moving pages:
+  - `site/menu.yml` (top nav)
+  - `site/docs/menu.yml` (docs sidebar)
+- Specs under `site/docs/specs/**` are internal notes and should stay excluded from website navigation/public output.

site/config.scriban

@@ -0,0 +1,17 @@
+# Use the Lunet template as the base for this documentation site
+extend "XenoAtom/lunet_template@1.0.0"
+
+# -----------------------------------------------------------------------------
+# SITE SECTION (project-specific values only)
+# -----------------------------------------------------------------------------
+
+site_project_name = "XenoAtom.CommandLine"
+site_project_description = "A lightweight, powerful and NativeAOT-friendly command line parser for .NET."
+site_project_logo_path = "/img/XenoAtom.CommandLine.svg"
+site_project_social_banner_path = "/img/advanced-visual.png"
+site_project_banner_background_path = "/img/advanced-markup.png"
+site_project_package_id = "XenoAtom.CommandLine"
+site_project_github_repo = "XenoAtom.CommandLine"
+site_project_basepath = "/commandline"
+
+site_project_init

doc/advanced.md site/docs/advanced.mddoc/advanced.md renamed to site/docs/advanced.md

@@ -1,3 +1,7 @@
+---
+title: "Advanced Topics"
+---
+
 # Advanced Topics
 
 This guide covers advanced features of XenoAtom.CommandLine: the parse API for testing, shell completions, response files, configuration, and performance.
@@ -30,6 +34,7 @@ var result = app.Parse(["--name", "Alice", "--port", "8080"]);
 
 ### ParseResult Properties
 
+{.table}
 | Property | Type | Description |
 |---|---|---|
 | `ResolvedCommand` | `Command` | The command that was resolved |
@@ -192,6 +197,7 @@ myexe @args.txt
 
 ### Response File Syntax
 
+{.table}
 | Feature | Syntax | Example |
 |---|---|---|
 | Whitespace separation | spaces/tabs | `--name John` → `--name`, `John` |
@@ -241,6 +247,7 @@ var config = new CommandConfig
 var app = new CommandApp("myexe", config: config);
 ```
 
+{.table}
 | Property | Default | Description |
 |---|---|---|
 | `StrictOptionParsing` | `true` | Fail on unknown `-`/`--` tokens |
@@ -263,6 +270,7 @@ var runConfig = new CommandRunConfig(Width: 120, OptionWidth: 32)
 await app.RunAsync(args, runConfig);
 ```
 
+{.table}
 | Property | Default | Description |
 |---|---|---|
 | `Width` | `80` | Terminal width for formatting |
@@ -306,7 +314,7 @@ var colors = new List<Color>();
 
 var app = new CommandApp("myexe")
 {
-    { "c|color=", $"Console {{COLOR}} ({EnumWrapper<Color>.Names})",
+    { "c|color=", "Console {COLOR} (" + EnumWrapper<Color>.Names + ")",
         (EnumWrapper<Color> v) => colors.Add(v) },
     (ctx, _) => ValueTask.FromResult(0)
 };
@@ -354,7 +362,7 @@ dotnet publish -c Release -r win-x64 /p:PublishAot=true
 
 The following diagram shows the main types and their relationships:
 
-![Class diagram](XenoAtom.CommandLine.png)
+![Class diagram](../img/architecture.png)
 
 The design is intentionally simple. The main types are:
 
@@ -378,3 +386,4 @@ All these types inherit from `CommandNode`, the base class for all command tree
 - [Arguments](arguments.md) — positional arguments
 - [Validation & Constraints](validation.md) — validate values and constraints
 - [Help & Output](help-output.md) — customize help rendering
+

doc/arguments.md site/docs/arguments.mddoc/arguments.md renamed to site/docs/arguments.md

@@ -1,3 +1,7 @@
+---
+title: "Positional Arguments"
+---
+
 # Positional Arguments
 
 In addition to options (prefixed with `-`, `--`, `/`), XenoAtom.CommandLine supports positional arguments — values passed without any option prefix that are consumed in declaration order.
@@ -31,6 +35,7 @@ Input: file.txt
 
 The suffix on the argument prototype controls how many values are expected:
 
+{.table}
 | Prototype | Cardinality | Meaning |
 |---|---:|---|
 | `<input>` | Exactly 1 | Required — an error is raised if missing |
@@ -204,3 +209,4 @@ This is especially useful when argument values start with `-`.
 - [Options](options.md) — full option reference
 - [Commands](commands.md) — sub-commands and groups
 - [Validation & Constraints](validation.md) — validate argument values
+

doc/commands.md site/docs/commands.mddoc/commands.md renamed to site/docs/commands.md

@@ -1,3 +1,7 @@
+---
+title: "Commands"
+---
+
 # Commands
 
 XenoAtom.CommandLine supports commands and sub-commands, allowing you to build rich multi-command CLIs similar to `git`, `docker`, or `dotnet`.
@@ -317,3 +321,4 @@ If the parser is currently expecting a value for an option, the next token is **
 - [Arguments](arguments.md) — positional arguments and cardinality
 - [Validation & Constraints](validation.md) — validate values and declare option relationships
 - [Help & Output](help-output.md) — customize help rendering
+