126 lines
7.0 KiB
Python
126 lines
7.0 KiB
Python
import os
|
|
import sys
|
|
from bs4 import BeautifulSoup, NavigableString
|
|
|
|
# 中英替换对照表
|
|
REPLACEMENTS = [
|
|
{"tag": "div", "class": "textblock", "contains": "Here are the classes", "replace_with": "以下是类、结构体、联合体和接口的简要说明："},
|
|
{"tag": "div", "class": "textblock", "contains": "Here is a list of all files", "replace_with": "以下是所有文件的简要说明："},
|
|
|
|
{"tag": "div", "class": "title", "contains": "Main Page", "replace_with": "主页面"},
|
|
{"tag": "div", "class": "title", "contains": "Class List", "replace_with": "类溯源"},
|
|
{"tag": "div", "class": "title", "contains": "File List", "replace_with": "文件溯源"},
|
|
|
|
{"tag": "h2", "class": "groupheader", "contains": "Packages", "replace_with": "包"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Protected Attributes", "replace_with": "受保护类型"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Public Types", "replace_with": "公共类型"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Additional Inherited Members", "replace_with": "其他继承成员"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Public Attributes", "replace_with": "公有属性"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Function Documentation", "replace_with": "函数文档"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Classes", "replace_with": "类"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Class Hierarchy", "replace_with": "类层次结构"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Class Members", "replace_with": "类成员"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Namespace List", "replace_with": "命名空间列表"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Namespace", "replace_with": "命名空间"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Directories", "replace_with": "文件夹"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Files", "replace_with": "文件"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Macros", "replace_with": "宏"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Macro Definition Documentation", "replace_with": "宏定义文档"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Public Slots", "replace_with": "公共插槽"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Namespace Members", "replace_with": "命名空间成员"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Signals", "replace_with": "信号"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Module List", "replace_with": "模块列表"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Module Members", "replace_with": "模块成员"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "File Members", "replace_with": "文件成员"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Functions", "replace_with": "函数"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Variables", "replace_with": "变量"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Enumerations", "replace_with": "枚举类型"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Enumerator", "replace_with": "枚举值"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Defines", "replace_with": "宏定义"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Typedefs", "replace_with": "类型定义"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Friends", "replace_with": "友元"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Related Functions", "replace_with": "相关函数"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Detailed Description", "replace_with": "详细描述"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Constructor & Destructor Documentation", "replace_with": "构造与析构函数文档"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Member Function Documentation", "replace_with": "成员函数文档"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Member Data Documentation", "replace_with": "成员数据文档"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Defines Documentation", "replace_with": "宏定义文档"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Typedef Documentation", "replace_with": "类型定义文档"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Enumeration Type Documentation", "replace_with": "枚举类型文档"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Enumerator Documentation", "replace_with": "枚举值文档"},
|
|
{"tag": "h2", "class": "groupheader", "contains": "Variable Documentation", "replace_with": "变量文档"},
|
|
|
|
{"tag": "p", "class": "footer", "contains": "Copyright", "replace_with": "版权所有"},
|
|
{"tag": "p", "class": "footer", "contains": "Generated on", "replace_with": "生成日期"},
|
|
]
|
|
|
|
def ensure_utf8_meta(soup):
|
|
"""确保 <meta charset='utf-8'> 存在"""
|
|
if soup.head and not soup.head.find("meta", attrs={"charset": True}):
|
|
meta_tag = soup.new_tag("meta", charset="utf-8")
|
|
soup.head.insert(0, meta_tag)
|
|
|
|
def normalize_text(text: str) -> str:
|
|
"""标准化文本用于比较"""
|
|
return text.replace('\n', '').strip().lower()
|
|
|
|
def replace_in_html(file_path: str):
|
|
try:
|
|
with open(file_path, 'r', encoding='utf-8', errors='ignore') as f:
|
|
soup = BeautifulSoup(f, 'html.parser')
|
|
except Exception as e:
|
|
print(f"[ERROR] 无法读取文件 {file_path}: {e}")
|
|
return
|
|
|
|
ensure_utf8_meta(soup)
|
|
|
|
changed = False
|
|
|
|
titlearea = soup.find(id="titlearea")
|
|
if titlearea:
|
|
titlearea.decompose() # 删除该节点及其内容
|
|
changed = True
|
|
|
|
summaries = soup.find_all(class_="summary")
|
|
if summaries:
|
|
for s in summaries:
|
|
s.decompose()
|
|
changed = True
|
|
|
|
for rule in REPLACEMENTS:
|
|
tag = rule.get("tag", True)
|
|
attrs = {}
|
|
if "class" in rule:
|
|
attrs["class"] = rule["class"]
|
|
if "id" in rule:
|
|
attrs["id"] = rule["id"]
|
|
|
|
for el in soup.find_all(tag, attrs=attrs):
|
|
el_text = normalize_text(el.get_text())
|
|
rule_text = normalize_text(rule["contains"])
|
|
|
|
if rule_text in el_text:
|
|
el.clear()
|
|
el.append(NavigableString(rule["replace_with"]))
|
|
changed = True
|
|
|
|
if changed:
|
|
try:
|
|
with open(file_path, 'w', encoding='utf-8') as f:
|
|
f.write(str(soup))
|
|
except Exception as e:
|
|
print(f"[ERROR] 无法写入文件 {file_path}: {e}")
|
|
|
|
def walk_and_process(root_dir: str):
|
|
print(f"[SRART] 开始替换文件")
|
|
for root, _, files in os.walk(root_dir):
|
|
for name in files:
|
|
if name.endswith(".html"):
|
|
replace_in_html(os.path.join(root, name))
|
|
print(f"[SRART] 文件替换结束")
|
|
if __name__ == "__main__":
|
|
if len(sys.argv) < 2:
|
|
sys.exit(1)
|
|
|
|
walk_and_process(sys.argv[1])
|