Files
MDHelper/mdhelper/export_check.py
T

97 lines
4.9 KiB
Python

"""Content-aware export checks; code examples are never scanned as links."""
from __future__ import annotations
import re
from dataclasses import dataclass
from pathlib import Path
from urllib.parse import urlsplit
from .document_resources import analyze_document, resolve_local_reference
@dataclass(frozen=True)
class ExportIssue:
line: int
message: str
def check_export(source: str, path: Path, kind: str, css_source: str = "") -> list[ExportIssue]:
issues: list[ExportIssue] = []
seen: set[tuple[int, str]] = set()
def add(line: int, message: str) -> None:
if (line, message) not in seen:
seen.add((line, message)); issues.append(ExportIssue(line, message))
word = kind in {"pandoc", "python-docx", "builtin"}
basic = kind in {"python-docx", "builtin"}
def target(value: str, line: int, image: bool) -> None:
parsed = urlsplit(value)
if parsed.scheme in {"http", "https"}:
if image:
add(line, "远程图片依赖网络,离线导出可能缺失:" + value)
return
if parsed.scheme not in {"", "file"} or not parsed.path:
return
local = resolve_local_reference(path, value)
if local is not None and not local.exists():
add(line, "本地图片不存在:" + value if image else "本地链接目标不存在:" + value)
if image and basic:
add(line, "此 Word 导出方式不嵌入图片,建议选择 Pandoc。")
analysis = analyze_document(source)
for reference in analysis.references:
target(reference.url, reference.line, reference.image)
tokens = analysis.tokens
list_depth = 0
for token in tokens:
line = token.map[0] + 1 if token.map else 0
if token.type in {"bullet_list_open", "ordered_list_open"}:
list_depth += 1
if basic and list_depth > 1:
add(line, "此 Word 导出方式不能完整保留多级列表,建议选择 Pandoc。")
if kind == "builtin" and token.type == "ordered_list_open":
add(line, "内置导出使用简化编号,建议选择 Pandoc 保留连续编号。")
elif token.type in {"bullet_list_close", "ordered_list_close"}:
list_depth -= 1
if word and token.type == "fence" and token.info.strip().lower() == "mermaid":
add(line, "Mermaid 图表在 Word 中会保留为代码;需要图形时请先转换为图片。")
if basic and token.type == "math_block":
add(line, "此 Word 导出方式不转换公式,建议选择 Pandoc。")
for child in token.children or []:
if basic and child.type == "math_inline":
add(line, "此 Word 导出方式不转换公式,建议选择 Pandoc。")
html_tokens = [token] if token.type == "html_block" else [c for c in token.children or [] if c.type == "html_inline"]
for raw in html_tokens:
if word:
add(line, "含有内嵌 HTML,Word 可能无法保留其内容或布局,请核对导出结果。")
if word and css_source.strip():
from .style_sync import analyze_css, CORE_PROPERTIES
import tinycss2
analysis = analyze_css(css_source)
for note in analysis.notes:
add(0, "Word 样式限制:" + note)
unsupported: set[str] = set()
for rule in tinycss2.parse_stylesheet(css_source, skip_whitespace=True, skip_comments=True):
if rule.type == "qualified-rule":
for declaration in tinycss2.parse_declaration_list(rule.content):
if declaration.type == "declaration" and declaration.lower_name not in CORE_PROPERTIES | {"font", "margin"}:
unsupported.add(declaration.lower_name)
if unsupported:
add(0, "以下 CSS 效果不会转换为 Word 格式:" + "、".join(sorted(unsupported)))
return issues
def confirm_export(parent: object, issues: list[ExportIssue]) -> bool:
if not issues:
return True
from PySide6.QtWidgets import QDialog, QDialogButtonBox, QLabel, QPlainTextEdit, QVBoxLayout
dialog = QDialog(parent); dialog.setWindowTitle("导出前检查"); dialog.resize(760, 460)
layout = QVBoxLayout(dialog)
layout.addWidget(QLabel("发现以下内容需要留意。可以返回编辑,或继续导出后核对结果。"))
details = QPlainTextEdit(); details.setReadOnly(True)
details.setPlainText("\n\n".join((f"第 {issue.line} 行:" if issue.line else "") + issue.message for issue in issues))
layout.addWidget(details)
buttons = QDialogButtonBox()
buttons.addButton("继续导出", QDialogButtonBox.ButtonRole.AcceptRole)
buttons.addButton("返回编辑", QDialogButtonBox.ButtonRole.RejectRole)
buttons.accepted.connect(dialog.accept); buttons.rejected.connect(dialog.reject)
layout.addWidget(buttons)
return dialog.exec() == QDialog.DialogCode.Accepted