Vishesh 'ironeagle' Bangotra
06ffd2febd
Squash-merge lib-standardisation: adopt repo standards across packaging, tooling, docs, and CI. - standardize pyproject.toml (canonical packaging, lint config, extras, GSDFC pydoclint) - add py.typed marker, modernize type hints and Google-style docstrings - nest generated docs under docs/lib and docs/mcp; add hand-written wiki - adopt standard Type A PyPI CI pipeline (tag==version guard + quality gate) - promote generated CHANGELOG.md; bump version to 0.0.7
39 lines
1.0 KiB
Python
39 lines
1.0 KiB
Python
"""
|
||
Navigation layer for doc-forge.
|
||
|
||
The ``docforge.nav`` package manages the relationship between the logical
|
||
documentation structure defined by the user and the physical documentation
|
||
files generated on disk.
|
||
|
||
---
|
||
|
||
Workflow
|
||
--------
|
||
|
||
1. **Specification** – Users define navigation intent in ``docforge.nav.yml``.
|
||
2. **Resolution** – ``resolve_nav`` expands patterns and matches them against
|
||
generated Markdown files.
|
||
3. **Emission** – ``MkDocsNavEmitter`` converts the resolved structure into
|
||
the YAML navigation format required by ``mkdocs.yml``.
|
||
|
||
This layer separates documentation organization from the underlying source
|
||
code layout, enabling flexible grouping, ordering, and navigation structures
|
||
independent of module hierarchy.
|
||
|
||
---
|
||
"""
|
||
|
||
from .spec import NavSpec, load_nav_spec
|
||
from .resolver import ResolvedNav, resolve_nav
|
||
from .mkdocs import MkDocsNavEmitter
|
||
from .wiki import build_wiki_nav
|
||
|
||
__all__ = [
|
||
"NavSpec",
|
||
"ResolvedNav",
|
||
"MkDocsNavEmitter",
|
||
"build_wiki_nav",
|
||
"resolve_nav",
|
||
"load_nav_spec",
|
||
]
|