86 lines
3.2 KiB
Python
Executable File
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()
|