feat: support .mdx files in page resolver and DocTree scanner #43

New issue

Closed

opened 2026-02-12 03:48:04 +00:00 by mik-tf · 0 comments

mik-tf commented

2026-02-12 03:48:04 +00:00

Owner

Problem

Some repos (e.g. znzcybercity/docs_znzcybercity) use .mdx files alongside .md. The current page resolver and DocTree scanner only look for .md extensions, causing:

Warning: Page 'main/main_intro' not found in collection (file exists as main_intro.mdx)
Failed to export 'cybercity': IO error: No such file or directory

Expected behavior

The page resolver should find .mdx files when .md is not present. DocTree scanning should include .mdx files as valid markdown pages.

Files to investigate

src/doctree/core.rs — collection scanning / page discovery
src/book/resolver.rs — page path resolution
src/doctree/utils.rs — file extension checks

Affected repo

https://forge.ourworld.tf/znzcybercity/docs_znzcybercity (collections/cybercity/main/main_intro.mdx, presentation.mdx)

## Problem Some repos (e.g. `znzcybercity/docs_znzcybercity`) use `.mdx` files alongside `.md`. The current page resolver and DocTree scanner only look for `.md` extensions, causing: - `Warning: Page 'main/main_intro' not found in collection` (file exists as `main_intro.mdx`) - `Failed to export 'cybercity': IO error: No such file or directory` ## Expected behavior The page resolver should find `.mdx` files when `.md` is not present. DocTree scanning should include `.mdx` files as valid markdown pages. ## Files to investigate - `src/doctree/core.rs` — collection scanning / page discovery - `src/book/resolver.rs` — page path resolution - `src/doctree/utils.rs` — file extension checks ## Affected repo - https://forge.ourworld.tf/znzcybercity/docs_znzcybercity (`collections/cybercity/main/main_intro.mdx`, `presentation.mdx`)