sync update from LAN repo (source master @ ca48c4ec)
This commit is contained in:
1 parent
8bc8b0e082
commit
ea9dcff9c0
873 files changed
+107866
-14011
No files matched your search
+372
@@ -0,0 +1,372 @@
|
||||
#!/usr/bin/env python3
|
||||
"""Generate a complete CNN-style Chinese page from a high-level JSON spec."""
|
||||
|
||||
from __future__ import annotations
|
||||
|
||||
import argparse
|
||||
import copy
|
||||
import json
|
||||
import sys
|
||||
from collections.abc import Mapping
|
||||
from pathlib import Path
|
||||
|
||||
import render_cnn_page as renderer
|
||||
|
||||
LATEST_VISUALS = ("coast", "city", "deep-sea")
|
||||
VIDEO_VISUALS = ("night-city", "space", "music")
|
||||
WORLD_VISUALS = ("trade", "market", "payments", "energy")
|
||||
|
||||
|
||||
def _read_spec(path: Path) -> dict[str, object]:
|
||||
try:
|
||||
value = json.loads(path.read_text(encoding="utf-8"))
|
||||
except json.JSONDecodeError as exc:
|
||||
raise renderer.DataValidationError(f"Invalid spec JSON: {exc}") from exc
|
||||
if not isinstance(value, dict):
|
||||
raise renderer.DataValidationError("Spec JSON must be an object")
|
||||
return value
|
||||
|
||||
|
||||
def _string(value: object, path: str, *, required: bool = False) -> str:
|
||||
if value is None and not required:
|
||||
return ""
|
||||
if not isinstance(value, str) or (required and not value.strip()):
|
||||
suffix = "a non-empty string" if required else "a string"
|
||||
raise renderer.DataValidationError(f"{path} must be {suffix}")
|
||||
return value.strip()
|
||||
|
||||
|
||||
def _strings(value: object, path: str, *, limit: int) -> list[str]:
|
||||
if value is None:
|
||||
return []
|
||||
if not isinstance(value, list) or not 1 <= len(value) <= limit:
|
||||
raise renderer.DataValidationError(f"{path} must contain between 1 and {limit} strings")
|
||||
result: list[str] = []
|
||||
for index, item in enumerate(value):
|
||||
text = _string(item, f"{path}[{index}]", required=True)
|
||||
_require_chinese(text, f"{path}[{index}]")
|
||||
result.append(text)
|
||||
return result
|
||||
|
||||
|
||||
def _require_chinese(value: str, path: str) -> None:
|
||||
if not any("\u3400" <= char <= "\u9fff" for char in value):
|
||||
raise renderer.DataValidationError(f"{path} must contain Simplified Chinese reader-visible text")
|
||||
|
||||
|
||||
def _optional_chinese(spec: Mapping[str, object], key: str) -> str:
|
||||
value = _string(spec.get(key), key)
|
||||
if value:
|
||||
_require_chinese(value, key)
|
||||
return value
|
||||
|
||||
|
||||
def _media(value: object) -> dict[str, object] | None:
|
||||
if value is None:
|
||||
return None
|
||||
if not isinstance(value, Mapping):
|
||||
raise renderer.DataValidationError("media must be an object or null")
|
||||
media_type = _string(value.get("type"), "media.type") or "image"
|
||||
if media_type not in {"image", "video", "webpage"}:
|
||||
raise renderer.DataValidationError("media.type must be image, video, or webpage")
|
||||
media: dict[str, object] = {"type": media_type}
|
||||
if media_type == "webpage":
|
||||
media["pageUrl"] = _string(
|
||||
value.get("pageUrl"),
|
||||
"media.pageUrl",
|
||||
required=True,
|
||||
)
|
||||
media["title"] = _string(
|
||||
value.get("title"),
|
||||
"media.title",
|
||||
required=True,
|
||||
)
|
||||
if value.get("description"):
|
||||
media["description"] = _string(
|
||||
value.get("description"),
|
||||
"media.description",
|
||||
)
|
||||
media["embed"] = bool(value.get("embed", False))
|
||||
else:
|
||||
media["mediaUrl"] = _string(
|
||||
value.get("url"),
|
||||
"media.url",
|
||||
required=True,
|
||||
)
|
||||
media["alt"] = _string(value.get("alt"), "media.alt") or "用户提供的新闻媒体"
|
||||
if value.get("pageUrl"):
|
||||
media["pageUrl"] = _string(value.get("pageUrl"), "media.pageUrl")
|
||||
if media_type == "video" and value.get("posterUrl"):
|
||||
media["posterUrl"] = _string(
|
||||
value.get("posterUrl"),
|
||||
"media.posterUrl",
|
||||
)
|
||||
return media
|
||||
|
||||
|
||||
def _replace_story_titles(
|
||||
defaults: list[dict[str, object]],
|
||||
titles: list[str],
|
||||
*,
|
||||
prefix: str,
|
||||
visuals: tuple[str, ...],
|
||||
include_summary: bool,
|
||||
topic: str,
|
||||
) -> list[dict[str, object]]:
|
||||
items: list[dict[str, object]] = []
|
||||
for index, title in enumerate(titles):
|
||||
item = copy.deepcopy(defaults[index % len(defaults)])
|
||||
item["id"] = f"{prefix}-{index + 1:02d}"
|
||||
item["title"] = title
|
||||
item["visual"] = visuals[index % len(visuals)]
|
||||
if include_summary:
|
||||
item["kicker"] = "专题"
|
||||
item["summary"] = f"围绕{topic}整理的中文示意报道,页面内容可在设置中继续编辑。"
|
||||
item["time"] = f"{index + 1} 小时前 · 示意"
|
||||
elif "meta" in item:
|
||||
item["meta"] = "视频示意"
|
||||
item["duration"] = f"0{index + 3}:1{index}"
|
||||
else:
|
||||
item["kicker"] = "观察"
|
||||
item["time"] = f"{index + 1} 小时前 · 示意"
|
||||
items.append(item)
|
||||
return items
|
||||
|
||||
|
||||
def build_document(spec: dict[str, object]) -> dict[str, object]:
|
||||
allowed = {
|
||||
"topic",
|
||||
"headline",
|
||||
"headlineSummary",
|
||||
"breaking",
|
||||
"pageTitle",
|
||||
"description",
|
||||
"theme",
|
||||
"kicker",
|
||||
"byline",
|
||||
"latestHeadlines",
|
||||
"videoHeadlines",
|
||||
"worldHeadlines",
|
||||
"sideHeadlines",
|
||||
"updates",
|
||||
"analysisTitle",
|
||||
"analysisText",
|
||||
"media",
|
||||
}
|
||||
unknown = sorted(set(spec) - allowed)
|
||||
if unknown:
|
||||
raise renderer.DataValidationError("Unknown spec keys: " + ", ".join(unknown))
|
||||
|
||||
topic = _string(spec.get("topic"), "topic", required=True)
|
||||
headline = _optional_chinese(spec, "headline") or f"{topic}发布最新计划,中文专题页面同步上线"
|
||||
headline_summary = _optional_chinese(spec, "headlineSummary") or (f"本页面围绕{topic}整理品牌动态、内容观察与社区反馈,所有新闻和数据均为中文示意内容。")
|
||||
breaking = _optional_chinese(spec, "breaking") or f"{topic}成为今日中文专题关注焦点"
|
||||
page_title = _optional_chinese(spec, "pageTitle") or f"CNN 中文专题 · {topic}"
|
||||
description = _optional_chinese(spec, "description") or f"围绕{topic}制作的 CNN 风格中文新闻示意页面。"
|
||||
kicker = _optional_chinese(spec, "kicker") or "特别报道 · 中文示意"
|
||||
byline = _string(spec.get("byline"), "byline") or "CNN 中文编辑台"
|
||||
theme = _string(spec.get("theme"), "theme") or "light"
|
||||
if theme not in renderer.THEMES:
|
||||
raise renderer.DataValidationError("theme must be auto, light, or dark")
|
||||
|
||||
latest_titles = _strings(spec.get("latestHeadlines"), "latestHeadlines", limit=12) or [
|
||||
f"{topic}推出新计划,首批体验活动正式启动",
|
||||
f"从创意到产品:{topic}团队分享设计思路",
|
||||
f"社区观察:用户如何参与{topic}内容共创",
|
||||
]
|
||||
video_titles = _strings(spec.get("videoHeadlines"), "videoHeadlines", limit=8) or [
|
||||
f"现场直击:走进{topic}的创作空间",
|
||||
f"三分钟了解{topic}最新进展",
|
||||
f"幕后故事:{topic}团队讲述项目历程",
|
||||
]
|
||||
world_titles = _strings(spec.get("worldHeadlines"), "worldHeadlines", limit=16) or [
|
||||
f"{topic}跨区域合作计划公布",
|
||||
f"市场观察:{topic}相关讨论持续升温",
|
||||
f"数字内容让{topic}触达更多社区",
|
||||
f"可持续实践成为{topic}下一阶段重点",
|
||||
]
|
||||
side_titles = _strings(spec.get("sideHeadlines"), "sideHeadlines", limit=4) or [
|
||||
f"{topic}如何把创意转化为日常体验",
|
||||
f"团队访谈:{topic}背后的设计选择",
|
||||
]
|
||||
update_titles = _strings(spec.get("updates"), "updates", limit=12) or [
|
||||
f"{topic}专题页面完成首轮内容更新",
|
||||
"中文示意报道与栏目内容已同步",
|
||||
"读者可通过设置按钮继续编辑页面数据",
|
||||
]
|
||||
analysis_title = _optional_chinese(spec, "analysisTitle") or f"{topic}为何能够持续获得关注?"
|
||||
analysis_text = _optional_chinese(spec, "analysisText") or (f"{topic}把清晰的内容表达、稳定的视觉识别和持续的社区互动结合起来。真正的考验在于后续内容能否保持一致,并形成可持续的参与机制。")
|
||||
|
||||
data = renderer._read_json(renderer.DEFAULT_DATA_PATH)
|
||||
data["site"].update(
|
||||
{
|
||||
"pageTitle": page_title,
|
||||
"description": description,
|
||||
"theme": theme,
|
||||
"date": "中文示意页面 · 非实时新闻",
|
||||
"utilityLinks": ["专题", "新闻简报"],
|
||||
"marketSummary": [
|
||||
{"label": "关注度", "value": "示意", "direction": "flat"},
|
||||
{"label": "讨论度", "value": "非实时", "direction": "flat"},
|
||||
],
|
||||
"weather": "页面内容为中文示意",
|
||||
"frontLabel": f"头版 · {topic}",
|
||||
}
|
||||
)
|
||||
data["navigation"]["drawerFooter"] = "CNN 中文专题 · 概念页面"
|
||||
data["breaking"].update({"label": "快讯", "text": breaking, "time": "刚刚 · 示意"})
|
||||
|
||||
primary = data["lead"]["primary"]
|
||||
primary.update(
|
||||
{
|
||||
"kicker": kicker,
|
||||
"title": headline,
|
||||
"summary": headline_summary,
|
||||
"byline": byline,
|
||||
"updated": "更新于刚刚 · 示意",
|
||||
"readingTime": "阅读 5 分钟",
|
||||
"visualLabel": f"{topic}中文专题示意视觉",
|
||||
"tag": "专题",
|
||||
"credit": "CNN / 中文示意视觉",
|
||||
}
|
||||
)
|
||||
if "media" in spec:
|
||||
media = _media(spec.get("media"))
|
||||
if media is None:
|
||||
primary.pop("media", None)
|
||||
else:
|
||||
primary["media"] = media
|
||||
|
||||
data["lead"]["sideStories"] = [
|
||||
{
|
||||
"kicker": "延伸阅读",
|
||||
"title": title,
|
||||
"summary": f"从不同角度理解{topic}的内容表达与用户体验。",
|
||||
"visual": "train" if index == 0 else None,
|
||||
}
|
||||
for index, title in enumerate(side_titles)
|
||||
]
|
||||
data["lead"]["updatesTitle"] = "专题更新"
|
||||
data["lead"]["updates"] = [{"time": f"0{9 + index}:0{index}", "text": text} for index, text in enumerate(update_titles)]
|
||||
|
||||
data["latest"]["title"] = "最新报道"
|
||||
data["latest"]["items"] = _replace_story_titles(
|
||||
data["latest"]["items"],
|
||||
latest_titles,
|
||||
prefix="latest",
|
||||
visuals=LATEST_VISUALS,
|
||||
include_summary=True,
|
||||
topic=topic,
|
||||
)
|
||||
data["video"].update(
|
||||
{
|
||||
"title": "视频与现场",
|
||||
"modalTitle": "CNN 中文视频",
|
||||
"liveTitle": "专题视频",
|
||||
"liveSubtitle": f"正在播放:{topic}",
|
||||
"modalNote": "视频内容为互动示意,可通过上传按钮替换素材。",
|
||||
}
|
||||
)
|
||||
data["video"]["items"] = _replace_story_titles(
|
||||
data["video"]["items"],
|
||||
video_titles,
|
||||
prefix="video",
|
||||
visuals=VIDEO_VISUALS,
|
||||
include_summary=False,
|
||||
topic=topic,
|
||||
)
|
||||
data["world"]["title"] = f"{topic}与相关观察"
|
||||
data["world"]["items"] = _replace_story_titles(
|
||||
data["world"]["items"],
|
||||
world_titles,
|
||||
prefix="world",
|
||||
visuals=WORLD_VISUALS,
|
||||
include_summary=False,
|
||||
topic=topic,
|
||||
)
|
||||
data["world"]["analysis"].update(
|
||||
{
|
||||
"kicker": "CNN 中文分析 · 示意",
|
||||
"title": analysis_title,
|
||||
"text": analysis_text,
|
||||
"author": "中文专题编辑部",
|
||||
"role": "页面内容策划",
|
||||
"initial": "编",
|
||||
}
|
||||
)
|
||||
data["markets"].update(
|
||||
{
|
||||
"title": "趋势快照 · 示意数据",
|
||||
"moreLabel": "非实时数据 →",
|
||||
"items": [
|
||||
{"name": "内容关注", "value": "示意", "change": "非实时", "direction": "flat"},
|
||||
{"name": "社区讨论", "value": "示意", "change": "非实时", "direction": "flat"},
|
||||
{"name": "视频热度", "value": "示意", "change": "非实时", "direction": "flat"},
|
||||
{"name": "专题更新", "value": "示意", "change": "非实时", "direction": "flat"},
|
||||
],
|
||||
}
|
||||
)
|
||||
data["newsletter"].update(
|
||||
{
|
||||
"title": f"订阅{topic}中文专题更新",
|
||||
"text": "接收页面内容更新提醒;本表单仅用于交互演示。",
|
||||
"button": "演示订阅",
|
||||
"successPrefix": "演示订阅信息已记录:",
|
||||
}
|
||||
)
|
||||
data["footer"].update(
|
||||
{
|
||||
"tagline": f"从中文专题出发,持续关注{topic}。",
|
||||
"copyright": "© 2026 CNN 风格概念页面。本页面内容均为中文示意。",
|
||||
"legal": "隐私 · 条款 · 内容说明",
|
||||
}
|
||||
)
|
||||
return data
|
||||
|
||||
|
||||
def _next_paths(output_dir: Path) -> tuple[Path, Path]:
|
||||
for index in range(1, 1001):
|
||||
stem = "cnn-page" if index == 1 else f"cnn-page-{index}"
|
||||
data_path = output_dir / f"{stem}-data.json"
|
||||
html_path = output_dir / f"{stem}.html"
|
||||
if not data_path.exists() and not html_path.exists():
|
||||
return data_path, html_path
|
||||
raise renderer.DataValidationError("Unable to allocate output filenames")
|
||||
|
||||
|
||||
def main(argv: list[str] | None = None) -> int:
|
||||
parser = argparse.ArgumentParser(description=__doc__)
|
||||
parser.add_argument("--spec", type=Path, required=True)
|
||||
parser.add_argument("--output-dir", type=Path, required=True)
|
||||
args = parser.parse_args(argv)
|
||||
try:
|
||||
data = build_document(_read_spec(args.spec))
|
||||
summary = renderer.validate_document(data)
|
||||
rendered = renderer.render_document(
|
||||
data,
|
||||
renderer.TEMPLATE_PATH.read_text(encoding="utf-8"),
|
||||
renderer.RUNTIME_PATH.read_text(encoding="utf-8"),
|
||||
)
|
||||
data_path, html_path = _next_paths(args.output_dir)
|
||||
renderer._write_new(
|
||||
data_path,
|
||||
json.dumps(data, ensure_ascii=False, indent=2) + "\n",
|
||||
)
|
||||
renderer._write_new(html_path, rendered)
|
||||
except (renderer.DataValidationError, OSError, UnicodeError) as exc:
|
||||
renderer._emit({"status": "error", "action": "fast-cnn-page", "error": str(exc)})
|
||||
return 2
|
||||
renderer._emit(
|
||||
{
|
||||
"status": "ok",
|
||||
"action": "fast-cnn-page",
|
||||
"data": str(data_path),
|
||||
"html": str(html_path),
|
||||
**summary,
|
||||
}
|
||||
)
|
||||
return 0
|
||||
|
||||
|
||||
if __name__ == "__main__":
|
||||
sys.exit(main())
|
||||
Reference in new issue
Block a user