sphinx-contrib/datatemplates

📊 Datatemplates: Render trang Sphinx từ dữ liệu thật

Sphinx extension sinh RST từ file JSON/YAML/CSV bằng template Jinja2.

sphinxcontrib-datatemplates là extension cho Sphinx, render phần nội dung RST từ file dữ liệu JSON, YAML, CSV. Dùng template có cú pháp Jinja2 để điều khiển cấu trúc xuất ra.

✨ Điểm nổi bật

• Hỗ trợ đa định dạng dữ liệu: JSON, YAML, CSV.
• Template Jinja2: dùng biến, vòng lặp, hàm tùy chỉnh trong template.
• Hàm render bảng: make_list_table, make_list_table_from_mappings.
• Render động: danh sách, bảng lồng nhau từ cấu trúc dữ liệu phức tạp.
• Tích hợp Sphinx: chạy trong quá trình build tài liệu.

💡 Vì sao đáng chú ý

Thay vì viết tay RST cho từng mục, dùng datatemplates sinh nội dung từ file cấu hình hoặc dữ liệu thực. Phù hợp tài liệu kỹ thuật, tài liệu dự án, catalog sản phẩm, hoặc bất kỳ nội dung nào cần đồng bộ từ nguồn dữ liệu.

---

#Sphinx #Python #Jinja2 #OpenSource #TiniX