wingtip 0.4.2__tar.gz → 0.6.0__tar.gz

{wingtip-0.4.2 → wingtip-0.6.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wingtip
-Version: 0.4.2
+Version: 0.6.0
 Summary: A static site generator for documentation that is built to be indexed and cited.
 Project-URL: Homepage, https://semanticentity.github.io/WingTip-Static-Site-Generator
 Project-URL: Source, https://github.com/semanticentity/WingTip-Static-Site-Generator
@@ -38,7 +38,7 @@ Description-Content-Type: text/markdown
 
 ![WingTip social card](https://raw.githubusercontent.com/semanticentity/WingTip-Static-Site-Generator/main/social-card.png)
 
-[Live demo](https://semanticentity.github.io/WingTip-Static-Site-Generator) · [Migration guide](docs/migration.md) · [Source](https://github.com/semanticentity/WingTip-Static-Site-Generator) · [Roadmap](docs/roadmap.md)
+[Live demo](https://semanticentity.github.io/WingTip-Static-Site-Generator) · [Migration guide](https://github.com/semanticentity/WingTip-Static-Site-Generator/blob/main/docs/migration.md) · [Source](https://github.com/semanticentity/WingTip-Static-Site-Generator) · [Roadmap](https://github.com/semanticentity/WingTip-Static-Site-Generator/blob/main/docs/roadmap.md)
 
 WingTip turns a repository `README.md` and `docs/` directory into fast, portable static documentation. It generates crawlable HTML, search and discovery metadata, structured data, machine-readable Markdown artifacts, and an offline-capable site without requiring a hosted documentation platform.
 
@@ -57,7 +57,7 @@ Start with zero configuration, customize when needed, and deploy the generated f
 
 ## Moving from hosted documentation?
 
-Use the [migration guide](docs/migration.md) to assess what WingTip supports today, preserve URLs and metadata, validate generated output, and plan a safe cutover. Public repositories and sanitized reproductions can request a [structured migration review](https://github.com/semanticentity/WingTip-Static-Site-Generator/issues/new?template=migration.yml).
+Use the [migration guide](https://github.com/semanticentity/WingTip-Static-Site-Generator/blob/main/docs/migration.md) to assess what WingTip supports today, preserve URLs and metadata, validate generated output, and plan a safe cutover. Public repositories and sanitized reproductions can request a [structured migration review](https://github.com/semanticentity/WingTip-Static-Site-Generator/issues/new?template=migration.yml).
 
 ## Features
 
@@ -71,17 +71,17 @@ Use the [migration guide](docs/migration.md) to assess what WingTip supports tod
 - Published/updated dates with Git-based modified-date fallback
 - Per-page categories and versions, plus generated `categories.json` and `versions.json`
 - Per-page language and translation mappings with `hreflang` and `x-default`
-- Local client-side full-text search with keyboard navigation ([details](docs/search-features.md))
+- Local client-side full-text search with keyboard navigation ([details](https://github.com/semanticentity/WingTip-Static-Site-Generator/blob/main/docs/search-features.md))
 
 ### Documentation experience
 
-- `README.md` becomes `index.html`; top-level `docs/*.md` files become standalone pages
-- Automatic sidebar, table of contents, and previous/next navigation
+- `README.md` becomes `index.html`; `docs/` is discovered recursively with nested paths preserved in URLs (`docs/guides/intro.md` → `guides/intro.html`)
+- Automatic sidebar with collapsible directory groups (`_category.json` for names and ordering, `order` frontmatter for pages), table of contents, and previous/next navigation
 - GitHub “Edit this page” links
 - Responsive layout with light/dark mode and screen-reader/keyboard support
 - Pygments syntax highlighting and copy-to-clipboard controls
 - Tables, footnotes, definition lists, attributes, admonitions, and Markdown inside HTML
-- KaTeX math rendering ([examples](docs/math-examples.md))
+- KaTeX math rendering ([examples](https://github.com/semanticentity/WingTip-Static-Site-Generator/blob/main/docs/math-examples.md))
 - Configurable external-link handling and correct `.md` link rewriting, including fragments and queries
 - Custom Markdown-based `404.html`
 
@@ -94,7 +94,7 @@ Use the [migration guide](docs/migration.md) to assess what WingTip supports tod
 - Optional generated or custom Content Security Policy
 - Plausible, Umami, Fathom, Google Analytics, custom analytics, and global/per-page `<head>` snippets
 - Plugin hooks before/after builds and conversions, plus plugin-provided Python-Markdown extensions
-- Theme variables through `theme.json` and static CSS overrides ([theming guide](docs/theming.md))
+- Theme variables through `theme.json` and static CSS overrides ([theming guide](https://github.com/semanticentity/WingTip-Static-Site-Generator/blob/main/docs/theming.md))
 - Live development server with auto-reload and scroll restoration
 - Post-build auditor for missing local files, unexpected CDN references, required artifacts, and branding leaks
 
@@ -331,9 +331,9 @@ docs/site/
 
 ## Current limitations and roadmap
 
-WingTip currently processes `README.md` and top-level `docs/*.md`; nested documentation trees and grouped/collapsible navigation remain roadmap work. Mermaid diagrams, broad MDX compatibility, and a theme marketplace are not yet built.
+Mermaid diagrams, broad MDX compatibility, an automated hosted-platform importer, and a theme marketplace are not yet built.
 
-See the [roadmap and feature comparison](docs/roadmap.md) for planned work.
+See the [roadmap and feature comparison](https://github.com/semanticentity/WingTip-Static-Site-Generator/blob/main/docs/roadmap.md) for planned work.
 
 ---
 

{wingtip-0.4.2 → wingtip-0.6.0}/README.md

@@ -41,8 +41,8 @@ Use the [migration guide](docs/migration.md) to assess what WingTip supports tod
 
 ### Documentation experience
 
-- `README.md` becomes `index.html`; top-level `docs/*.md` files become standalone pages
-- Automatic sidebar, table of contents, and previous/next navigation
+- `README.md` becomes `index.html`; `docs/` is discovered recursively with nested paths preserved in URLs (`docs/guides/intro.md` → `guides/intro.html`)
+- Automatic sidebar with collapsible directory groups (`_category.json` for names and ordering, `order` frontmatter for pages), table of contents, and previous/next navigation
 - GitHub “Edit this page” links
 - Responsive layout with light/dark mode and screen-reader/keyboard support
 - Pygments syntax highlighting and copy-to-clipboard controls
@@ -297,7 +297,7 @@ docs/site/
 
 ## Current limitations and roadmap
 
-WingTip currently processes `README.md` and top-level `docs/*.md`; nested documentation trees and grouped/collapsible navigation remain roadmap work. Mermaid diagrams, broad MDX compatibility, and a theme marketplace are not yet built.
+Mermaid diagrams, broad MDX compatibility, an automated hosted-platform importer, and a theme marketplace are not yet built.
 
 See the [roadmap and feature comparison](docs/roadmap.md) for planned work.
 

{wingtip-0.4.2 → wingtip-0.6.0}/pyproject.toml

@@ -1,12 +1,12 @@
 [build-system]
-requires = ["hatchling"]
+requires = ["hatchling", "hatch-fancy-pypi-readme"]
 build-backend = "hatchling.build"
 
 [project]
 name = "wingtip"
-version = "0.4.2"
+version = "0.6.0"
 description = "A static site generator for documentation that is built to be indexed and cited."
-readme = "README.md"
+dynamic = ["readme"]
 license = { text = "MIT" }
 authors = [{ name = "SemanticEntity" }]
 keywords = ["documentation", "static-site-generator", "seo", "llms-txt", "markdown", "aeo"]
@@ -62,3 +62,17 @@ artifacts = [
 
 [tool.hatch.build.targets.sdist]
 include = ["wingtip", "README.md", "config.sample.json", "theme.json"]
+
+# PyPI renders the README verbatim with no repo context, so relative links
+# 404 into pypi.org's own namespace. Keep links relative in the repo (GitHub
+# and the demo site resolve them at render time) and absolutize them at
+# build time for the package metadata only.
+[tool.hatch.metadata.hooks.fancy-pypi-readme]
+content-type = "text/markdown"
+
+[[tool.hatch.metadata.hooks.fancy-pypi-readme.fragments]]
+path = "README.md"
+
+[[tool.hatch.metadata.hooks.fancy-pypi-readme.substitutions]]
+pattern = '\]\((?!https?://|#|mailto:)([^)]+)\)'
+replacement = '](https://github.com/semanticentity/WingTip-Static-Site-Generator/blob/main/\1)'