Files

86 lines
3.2 KiB
Python
Executable File

#!/usr/bin/env python3
"""Индекс документации: 946 файлов → одна навигация.
Для каждого .md собирает: первую строку-заголовок, размер, дату изменения.
Группирует по каталогу. Пишет ops/INDEX.md.
Запуск: python3 ops/scripts/build_docs_index.py
"""
import datetime
import os
import re
ROOT = "/root/buryan-infra"
OUT = os.path.join(ROOT, "ops/INDEX.md")
SKIP_DIRS = {".git", "node_modules", "__pycache__", "rag", ".venv"}
def title_of(path):
try:
with open(path, encoding="utf-8", errors="ignore") as f:
for line in f:
s = line.strip()
if s.startswith("#"):
return re.sub(r"^#+\s*", "", s)[:90]
if s and not s.startswith(("---", "```")):
return s[:90]
except Exception:
pass
return ""
def main():
groups = {}
total = 0
for dirpath, dirnames, filenames in os.walk(os.path.join(ROOT, "ops")):
dirnames[:] = [d for d in dirnames if d not in SKIP_DIRS]
for fn in filenames:
if not fn.endswith(".md"):
continue
p = os.path.join(dirpath, fn)
rel = os.path.relpath(p, ROOT)
if rel == "ops/INDEX.md":
continue
try:
st = os.stat(p)
except OSError:
continue
groups.setdefault(os.path.relpath(dirpath, ROOT), []).append({
"rel": rel,
"title": title_of(p),
"size": st.st_size,
"mtime": st.st_mtime,
})
total += 1
lines = ["# Индекс документации",
"",
"Сгенерировано: %s · файлов: **%d** · генератор: `ops/scripts/build_docs_index.py`"
% (datetime.datetime.now().strftime("%Y-%m-%d %H:%M"), total),
"",
"Навигация по каталогам. Свежие файлы — сверху."]
for d in sorted(groups):
items = sorted(groups[d], key=lambda x: -x["mtime"])
fresh = sum(1 for i in items if i["mtime"] > datetime.datetime.now().timestamp() - 7 * 86400)
lines.append("")
lines.append("## %s — %d файлов (%d за неделю)" % (d, len(items), fresh))
lines.append("")
lines.append("| Документ | О чём | Изменён |")
lines.append("|---|---|---|")
for i in items[:40]:
date = datetime.datetime.fromtimestamp(i["mtime"]).strftime("%d.%m")
name = i["rel"].split("/")[-1]
lines.append("| [%s](%s) | %s | %s |"
% (name, i["rel"], (i["title"] or "—").replace("|", "/")[:70], date))
if len(items) > 40:
lines.append("| … ещё %d | | |" % (len(items) - 40))
open(OUT, "w", encoding="utf-8").write("\n".join(lines) + "\n")
print("записано:", OUT)
print("файлов:", total, "| каталогов:", len(groups))
print("размер индекса:", os.path.getsize(OUT) // 1024, "КБ")
if __name__ == "__main__":
main()