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
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
cross_docs-0.16.1.tar.gz
(19.7 kB
view details)
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cross_docs-0.16.1.tar.gz.
File metadata
- Download URL: cross_docs-0.16.1.tar.gz
- Upload date:
- Size: 19.7 kB
- Tags: Source
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b0140bcbe8a6efcc63e483bb7055754b193af7af260cbabc29e0c917c3054f7d
|
|
| MD5 |
19cc51540985bfa5fee3f9fe043012d8
|
|
| BLAKE2b-256 |
53e0908f1c3c56ae39637c509aa880123aabb1b426e1a0dbbde0cbca04a0252a
|
File details
Details for the file cross_docs-0.16.1-py3-none-any.whl.
File metadata
- Download URL: cross_docs-0.16.1-py3-none-any.whl
- Upload date:
- Size: 25.7 kB
- Tags: Python 3
- Uploaded using 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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
018db46c172d430807604d37b776bb1ef1068fdd4341bf692463e883a6851844
|
|
| MD5 |
39f7a049f2959cc91c8760ef8806fdbc
|
|
| BLAKE2b-256 |
ba247cc6ca3d3543e767e9d48c14040342587bf9a9147ad97b5b5994dcb0cb05
|
