mirror of
https://github.com/openmlsys/openmlsys-zh.git
synced 2026-04-01 09:50:23 +08:00
9d75cdc6c3
Move the English root site to mdBook, keep the Chinese site as a sub-book, and update CI/deploy to publish .mdbook outputs to docs/ and docs/cn/. Also add regression coverage for placeholder skipping, publish-tree assembly, and shared resource setup.
98 lines
2.6 KiB
Python
98 lines
2.6 KiB
Python
from __future__ import annotations
|
|
|
|
import argparse
|
|
import shutil
|
|
from pathlib import Path
|
|
|
|
|
|
def remove_path(path: Path) -> None:
|
|
if path.is_symlink() or path.is_file():
|
|
path.unlink()
|
|
return
|
|
if path.is_dir():
|
|
shutil.rmtree(path)
|
|
|
|
|
|
def copy_site(source: Path, destination: Path) -> None:
|
|
source = source.resolve()
|
|
if not source.is_dir():
|
|
raise FileNotFoundError(f"Site source does not exist or is not a directory: {source}")
|
|
|
|
remove_path(destination)
|
|
destination.parent.mkdir(parents=True, exist_ok=True)
|
|
shutil.copytree(source, destination)
|
|
|
|
|
|
def assemble_publish_tree(
|
|
destination_root: Path,
|
|
docs_subdir: str = "docs",
|
|
en_source: Path | None = None,
|
|
zh_source: Path | None = None,
|
|
) -> tuple[Path, Path | None]:
|
|
if en_source is None and zh_source is None:
|
|
raise ValueError("At least one site source must be provided.")
|
|
|
|
destination_root = destination_root.resolve()
|
|
docs_root = (destination_root / docs_subdir).resolve()
|
|
|
|
remove_path(docs_root)
|
|
docs_root.parent.mkdir(parents=True, exist_ok=True)
|
|
|
|
if en_source is not None:
|
|
copy_site(en_source, docs_root)
|
|
else:
|
|
docs_root.mkdir(parents=True, exist_ok=True)
|
|
|
|
zh_destination: Path | None = None
|
|
if zh_source is not None:
|
|
zh_destination = docs_root / "cn"
|
|
copy_site(zh_source, zh_destination)
|
|
|
|
return docs_root, zh_destination
|
|
|
|
|
|
def parse_args() -> argparse.Namespace:
|
|
parser = argparse.ArgumentParser(
|
|
description="Assemble the publish tree expected by openmlsys.github.io."
|
|
)
|
|
parser.add_argument(
|
|
"--destination-root",
|
|
type=Path,
|
|
required=True,
|
|
help="Root of the checked-out deployment repository.",
|
|
)
|
|
parser.add_argument(
|
|
"--docs-subdir",
|
|
default="docs",
|
|
help="Subdirectory inside the destination root that hosts the site.",
|
|
)
|
|
parser.add_argument(
|
|
"--en-source",
|
|
type=Path,
|
|
help="Built site to publish at docs/.",
|
|
)
|
|
parser.add_argument(
|
|
"--zh-source",
|
|
type=Path,
|
|
help="Built site to publish at docs/cn/.",
|
|
)
|
|
return parser.parse_args()
|
|
|
|
|
|
def main() -> int:
|
|
args = parse_args()
|
|
docs_root, zh_root = assemble_publish_tree(
|
|
destination_root=args.destination_root,
|
|
docs_subdir=args.docs_subdir,
|
|
en_source=args.en_source,
|
|
zh_source=args.zh_source,
|
|
)
|
|
print(f"Assembled root site at {docs_root}")
|
|
if zh_root is not None:
|
|
print(f"Assembled Chinese site at {zh_root}")
|
|
return 0
|
|
|
|
|
|
if __name__ == "__main__":
|
|
raise SystemExit(main())
|