a5a1ec5970
- Удалён mkdocs.yml и вся сгенерированная site/ директория - pydoc-markdown.yml теперь использует markdown renderer напрямую - Скрипт gen_docs.py генерирует docs/api_reference.md без MkDocs - Обновлён pre-commit hook для использования pydoc-markdown - Убраны зависимости MkDocs из конфигурации Теперь документация генерируется только через pydoc-markdown.
42 lines
999 B
Python
42 lines
999 B
Python
#!/usr/bin/env python3
|
|
"""Generate API documentation using pydoc-markdown."""
|
|
|
|
import subprocess
|
|
import sys
|
|
from pathlib import Path
|
|
|
|
|
|
def main():
|
|
"""Generate API documentation."""
|
|
project_root = Path(__file__).parent.parent
|
|
docs_dir = project_root / "docs"
|
|
|
|
docs_dir.mkdir(exist_ok=True)
|
|
|
|
print("📝 Generating API documentation...")
|
|
result = subprocess.run(
|
|
["pydoc-markdown"],
|
|
cwd=project_root,
|
|
capture_output=False,
|
|
)
|
|
|
|
if result.returncode != 0:
|
|
print("❌ Failed to generate documentation")
|
|
return 1
|
|
|
|
# Move generated file to docs/
|
|
generated = project_root / "api_reference.md"
|
|
if generated.exists():
|
|
generated.rename(docs_dir / "api_reference.md")
|
|
print("✅ Documentation generated: docs/api_reference.md")
|
|
else:
|
|
print("❌ api_reference.md not found")
|
|
return 1
|
|
|
|
print("\n✨ Done!")
|
|
return 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
sys.exit(main())
|