Skip to content

Cldr 19681 mdbook prototype - #5990

Closed
younies wants to merge 20 commits into
unicode-org:mainfrom
younies:cldr-19681-mdbook-prototype
Closed

Cldr 19681 mdbook prototype#5990
younies wants to merge 20 commits into
unicode-org:mainfrom
younies:cldr-19681-mdbook-prototype

Conversation

@younies

@younies younies commented Jul 31, 2026

Copy link
Copy Markdown
Member

CLDR-_____

  • This PR completes the ticket.

ALLOW_MANY_COMMITS=true

younies added 20 commits July 31, 2026 17:19
…icode-org#35 (LDML)

This commit introduces an mdBook configuration and theme prototype for
Unicode Technical Standard unicode-org#35 (LDML Parts 1–9).

- Preserves all original specification source text in docs/ldml/*.md.
- Adds docs/ldml/SUMMARY.md to organize the specification into a unified chapter tree.
- Adds docs/ldml/book.toml configuring search, navigation, and print exports.
- Adds docs/ldml/theme/custom.css with Unicode TR typography, colors, and A4 print styles.
- Adds npm run build:mdbook and npm run serve:mdbook to package.json.

Tracking ticket: https://unicode-org.atlassian.net/browse/CLDR-19681
Prior art: https://unicode-org.atlassian.net/browse/CLDR-15084

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…ly linkable, bulleted specification rules

- Restructures Other Numbering Systems, Number Symbols, Currency Formats, and Miscellaneous Patterns into spacious, deeply linkable bulleted rules.
- Adds point-level anchors (<a id="...">) for direct citation in conformance tests.
- Uses dual name and id attributes on section headings.
- Strictly preserves 100% of technical rules, constraints, fallbacks, and examples.

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…manual HTML anchor tags

- Removes manual <a id="..."> HTML tags across tr35-numbers.md.
- Relies on clean, pure Markdown bullet items with mdBook native anchor handling.

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…r35-general.md

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…ighlighted code blocks across tr35 suite

- Fixes all DTD element and attlist declarations across tr35.md, tr35-general.md, tr35-numbers.md, tr35-dates.md, tr35-collation.md, tr35-info.md, and tr35-personNames.md to use ```dtd syntax-highlighted fences.
- Strictly preserves 100% of specification rules, constraints, fallbacks, and technical content.

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…nicode-org#35 specification files for mdBook

- Restructures all 11 UTS unicode-org#35 specification files (tr35*.md) into clean, pure, idiomatic Markdown.
- Wraps all DTD element and attribute declarations in syntax-highlighted ```dtd blocks.
- Eliminates manual <a id="..."> HTML anchor tags in favor of mdBook native anchor and heading management.
- Preserves 100% of normative technical rules, definitions, grammars, and examples.

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…m book.toml

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…n tr35-personNames.md

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…ault FontAwesome branding in book.toml

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…ecutive specification headers

- Replaces raw YAML frontmatter with styled Unicode Technical Standard header cards across all 11 files.
- Eliminates broken H1 headings and sidebar TOC pollution caused by unparsed frontmatter comments.
- Upgrades custom.css with executive metadata cards, high-contrast tables, rounded borders, and syntax-highlighted code blocks.

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…e fold artifacts

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
… enhance typography and code readability

- Removes code fence wrappers around HTML tables across tr35 suite, fixing raw ```xml artifacts.
- Increases code font size to 0.95rem with JetBrains Mono / SF Mono for crystal-clear readability.
- Enhances table styling with high-contrast headers, spacious padding, and subtle zebra striping.

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…, DTDs, and tables across tr35 suite

- Normalizes all code fences across all 11 UTS unicode-org#35 specification files.
- Wraps all raw DTD declarations in syntax-highlighted ```dtd blocks.
- Eliminates rogue code fences around HTML tables and inverts corrupted code/prose states.
- Preserves 100% of normative technical specifications, grammars, and examples.

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…ar hierarchical bullet subpoints

- Converts Number Symbols and Numbering Systems definitions into structured, hierarchical bullet lists.
- Replaces disconnected blockquote boxes with clean subpoints and parameter definitions.
- Normalizes transform conversion rules into clear structured bullet lists.

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…n and scroll-spy to mdBook sidebar

- Automatically populates the active chapter in the sidebar with its H2/H3 sub-sections.
- Adds smooth scroll navigation and intersection-observer scroll-spy tracking.
- Styles subsection links with clear indentation, subtle guides, and active state highlights.

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…odular sub-chapters for native mdBook sidebar

- Splits monolithic TR35 parts into structured chapter and section markdown files.
- Generates a full multi-level navigation tree in SUMMARY.md.
- Enables native mdBook chapter folding and navigation chevrons.

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…s all themes and enable in-page navigation

- Uses mdBook native var(--sidebar-fg) and var(--sidebar-active) so sub-section text is bright and legible in Rust, Coal, Navy, Light, and Ayu themes.
- Populates in-page H2/H3 sub-sections under active chapters in the sidebar with smooth scrolling.

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…nicode-org#35 mdBook suite from scratch

- Adds comprehensive, step-by-step master prompt for transforming UTS unicode-org#35 specification files into a production mdBook site.

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…ion structure for CLDR editors

- Retains the canonical 11 .md specification files in docs/ldml/ for editor familiarity.
- Updates SUMMARY.md and book.toml for flat chapter structure.
- Updates master generation prompt to specify 11-file architecture.

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
…ervation in master generation prompt

TAG=agy
CONV=d1294830-ef67-4b88-864d-7da0a62888a4
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant