feat(transit): 添加参考文献解析功能并修复段落编号继承问题
新增了参考文献处理模块,支持按照 GB 7714 《文后参考文献著录规则》顺序编码制 解析和格式化参考文献。同时修复了段落替换过程中自动编号丢失的问题。 - 新增 transit/references.py 模块,提供参考文献解析和格式化功能 - 在 body.py 的 replace_placeholder 函数中实现段落编号属性的正确继承 - 修改 transit/__init__.py 导入新的参考文献处理函数 - 更新 transit/config.py 添加参考文献样式配置项 - 修改 transit/renderer.py 集成参考文献处理流程
This commit is contained in:
114
transit/references.py
Normal file
114
transit/references.py
Normal file
@@ -0,0 +1,114 @@
|
||||
"""
|
||||
GB 7714 《文后参考文献著录规则》顺序编码制 — 参考文献解析与格式化。
|
||||
|
||||
将 Markdown 中 ``[N] ... [TYPE] ...`` 格式的参考文献逐条解析,
|
||||
按文献类型(书 M、期刊 J、会议 C、学位论文 D、标准 S、电子资源 EB/OL 等)
|
||||
重新编排为符合 GB 7714 规范的格式,并输出为独立段落。
|
||||
"""
|
||||
|
||||
import re
|
||||
from typing import Optional
|
||||
|
||||
# 单行匹配: [N] 开头
|
||||
_RE_LINE = re.compile(r"^\[(\d+)\]\s*(.*)$")
|
||||
# 文献类型标记: [M] [J] [C] [D] [S] [EB/OL] [P] [N]
|
||||
_RE_TYPE = re.compile(r"\[(\w+(?:/\w+)?)\]")
|
||||
|
||||
|
||||
# GB 7714 中各文献类型的标准格式模板(仅用于说明,实际格式化直接拼接)
|
||||
TYPE_LABELS: dict[str, str] = {
|
||||
"M": "专著",
|
||||
"J": "期刊文章",
|
||||
"C": "会议论文",
|
||||
"D": "学位论文",
|
||||
"S": "标准",
|
||||
"EB/OL": "电子资源",
|
||||
"P": "专利",
|
||||
"N": "报纸文章",
|
||||
}
|
||||
|
||||
|
||||
def parse_reference_line(line: str) -> Optional[dict]:
|
||||
"""解析单行参考文献,提取序号、作者+标题、文献类型、来源信息。
|
||||
|
||||
期望格式::
|
||||
|
||||
[N] Authors. Title[TYPE]. Source info.
|
||||
"""
|
||||
line = line.strip()
|
||||
m = _RE_LINE.match(line)
|
||||
if not m:
|
||||
return None
|
||||
|
||||
number = int(m.group(1))
|
||||
rest = m.group(2).strip()
|
||||
|
||||
# 定位文献类型标记 [TYPE]
|
||||
tm = _RE_TYPE.search(rest)
|
||||
if not tm:
|
||||
return None
|
||||
|
||||
before_type = rest[: tm.start()].strip().rstrip(".")
|
||||
doc_type = tm.group(1)
|
||||
after_type = rest[tm.end() :].strip().lstrip(".").strip()
|
||||
|
||||
return {
|
||||
"number": number,
|
||||
"before_type": before_type, # "Authors. Title"
|
||||
"doc_type": doc_type, # "M", "J", "EB/OL", …
|
||||
"after_type": after_type, # 来源信息
|
||||
}
|
||||
|
||||
|
||||
def _normalize_period(text: str) -> str:
|
||||
"""确保文本以英文句点结尾(GB 7714 要求)。"""
|
||||
text = text.rstrip()
|
||||
if text and not text.endswith("."):
|
||||
text += "."
|
||||
return text
|
||||
|
||||
|
||||
def format_gb7714(ref: dict) -> str:
|
||||
"""按 GB 7714 重新编排一条参考文献(不含序号前缀,由 Word 样式自动编号)。
|
||||
|
||||
格式::
|
||||
|
||||
Authors. Title[TYPE]. Source.
|
||||
"""
|
||||
bt = ref["before_type"]
|
||||
dt = ref["doc_type"]
|
||||
at = ref["after_type"]
|
||||
formatted = f"{bt}[{dt}]. {at}"
|
||||
return _normalize_period(formatted)
|
||||
|
||||
|
||||
def references_to_paragraphs(
|
||||
ref_text: str,
|
||||
ref_style: str = "列出段落1",
|
||||
) -> list[dict]:
|
||||
"""将参考文献原始文本转换为格式化段落列表。
|
||||
|
||||
返回的每个元素::
|
||||
|
||||
{"text": str, "level": 0, "style": ref_style}
|
||||
|
||||
每条参考文献为一个独立段落。
|
||||
"""
|
||||
if not ref_text or ref_text == "<None>":
|
||||
return [{"text": "<None>", "level": 0, "style": ref_style}]
|
||||
|
||||
lines = [l.strip() for l in ref_text.strip().split("\n") if l.strip()]
|
||||
paragraphs: list[dict] = []
|
||||
|
||||
for line in lines:
|
||||
ref = parse_reference_line(line)
|
||||
if ref:
|
||||
formatted = format_gb7714(ref)
|
||||
else:
|
||||
# 无法解析时,至少去掉 [N] 前缀
|
||||
fallback = re.sub(r"^\[\d+\]\s*", "", line)
|
||||
formatted = _normalize_period(fallback)
|
||||
|
||||
paragraphs.append({"text": formatted, "level": 0, "style": ref_style})
|
||||
|
||||
return paragraphs
|
||||
Reference in New Issue
Block a user