#!/usr/bin/env python3 """Преобразование Markdown в HTML-страницу.""" from __future__ import annotations import argparse import html from pathlib import Path import markdown TEMPLATE = """ {title} {css}
{body}
""" def render(source: Path, title: str | None, css: str | None) -> str: text = source.read_text(encoding="utf-8") body = markdown.markdown(text, extensions=["extra", "sane_lists", "toc"]) page_title = title or source.stem.replace("-", " ").replace("_", " ") style = f'' if css else "" return TEMPLATE.format(title=html.escape(page_title), css=style, body=body) def main() -> int: parser = argparse.ArgumentParser(description="Собрать HTML из Markdown") parser.add_argument("--path", type=Path, required=True, help="Файл или папка") parser.add_argument("--glob", default="*.md", help="Маска файлов") parser.add_argument("--output-dir", type=Path, default=Path("html-out"), help="Папка для HTML") parser.add_argument("--title", help="Заголовок страницы для одного файла") parser.add_argument("--css", help="Путь к внешнему CSS") parser.add_argument("--force", action="store_true", help="Перезаписать HTML") args = parser.parse_args() root = args.path.expanduser().resolve() if not root.exists(): parser.error(f"Путь не найден: {root}") if args.title and not root.is_file(): parser.error("--title можно использовать только с одним файлом") out_dir = args.output_dir.expanduser().resolve() files = [root] if root.is_file() else sorted(path for path in root.rglob(args.glob) if path.is_file()) written = 0 for source in files: relative = source.relative_to(root) if root.is_dir() else Path(source.name) target = out_dir / relative.with_suffix(".html") if target.resolve() == source.resolve(): print(f"Пропуск, выходной путь совпадает с входным: {source}") continue if target.exists() and not args.force: print(f"Пропуск, файл уже есть: {target}") continue target.parent.mkdir(parents=True, exist_ok=True) target.write_text(render(source, args.title, args.css), encoding="utf-8") written += 1 print(f"Сохранено: {target}") print(f"Страниц собрано: {written}") return 0 if __name__ == "__main__": raise SystemExit(main())