#!/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())