cross-docs
Python backend utilities for Cross-Docs documentation framework.
Installation
uv add cross-docs
# or
pip install cross-docs
Usage
from pathlib import Path
from fastapi import FastAPI, Request
from cross_docs import (
generate_nav,
create_docs_handler,
strip_trailing_slash_middleware,
)
from cross_inertia.fastapi import InertiaDep
app = FastAPI()
app.middleware("http")(strip_trailing_slash_middleware)
CONTENT_DIR = Path("content")
NAV = generate_nav(CONTENT_DIR / "docs")
docs_handler = create_docs_handler(CONTENT_DIR, NAV)
@app.get("/docs")
async def docs_index(request: Request, inertia: InertiaDep):
return await docs_handler(request, inertia)
@app.get("/docs/{path:path}")
async def docs_page(path: str, request: Request, inertia: InertiaDep):
return await docs_handler(request, inertia, path=path)
API
Markdown Utilities
parse_frontmatter(content: str)- Parse YAML frontmatterload_markdown(content_dir: Path, path: str)- Load and parse markdownload_raw_markdown(content_dir: Path, path: str)- Load raw markdown
Navigation
generate_nav(docs_dir, base_path, section_order, index_page)- Generate nav from files
Middleware
strip_trailing_slash_middleware- Redirect trailing slasheswants_markdown(request)- Check Accept header for markdown
Routes
create_docs_handler(...)- Create a docs route handler
License
MIT
1 maintainer
Release files for cross-docs 0.16.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cross_docs-0.16.1.tar.gz | 19.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cross_docs-0.16.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 45.4 kB
Release files / cross_docs-0.16.1.tar.gz
| Download URL | cross_docs-0.16.1.tar.gz |
|---|---|
| Size | 19.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
b0140bcbe8a6efcc63e483bb7055754b193af7af260cbabc29e0c917c3054f7d
|
|
BLAKE2b-256 checksum How to use checksums |
53e0908f1c3c56ae39637c509aa880123aabb1b426e1a0dbbde0cbca04a0252a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / cross_docs-0.16.1-py3-none-any.whl
| Download URL | cross_docs-0.16.1-py3-none-any.whl |
|---|---|
| Size | 25.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
018db46c172d430807604d37b776bb1ef1068fdd4341bf692463e883a6851844
|
|
BLAKE2b-256 checksum How to use checksums |
ba247cc6ca3d3543e767e9d48c14040342587bf9a9147ad97b5b5994dcb0cb05
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
uv/0.12.3 {"installer":{"name":"uv","version":"0.12.3","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
