Files
DoLuEdu-WordFileParse/scripts/omml_mathml2latex/utils/__init__.py
Quentin 3271fee5cc init: WordFileParse docx→HTML 解析服务(含 Word EQ 域公式修复)
服务:Spring Boot 3.2 + docx4j 8.3.9,POST /api/v3/server_office_file/file/parse
      接受 .docx,返回 HTML(公式 → LaTeX,图片 → RustFS 外链)

公式支持三类来源:
- OMML(Word 2007+ 公式)      → Python omml_mathml2latex
- MathType OLE 对象            → Ruby mathtype2mathml → MathML → LaTeX
- Word EQ 域(老教辅主力)      → EqToLatexUtil(本次新增)

本次改动:
1. 新增 java-svc/.../core/EqToLatexUtil.java:
   移植自 jby backend-services office-core,EQ 语法 → LaTeX
   (\f→\dfrac、\r→\sqrt、\i→\int/\sum/\prod、\s→^{}/_{}、\b→\left\right、
     \a→array、\x→\boxed/\overline、\o\al 堆叠、圈码、化学符号、极限、连等式)
   品牌标记 JBYU* → WPU*,与采集端一致
2. CtoMathFinder:接上 EQ 分支(原为 not-ported 桩),域代码经
   EqToLatexUtil.convert 转 LaTeX 写入 eqLatexMap(WPEQNUM 占位符)
3. WordParseUtil.dealPlaceholder:EQ 的 LaTeX 同样加 \( \) 包裹
   (原先因 WPEQNUM 例外不加包裹,前端/MathJax 不渲染)

修前症状:教辅 Word 里分式/方程组/上下标整段丢失(如 {−1/3, 1} 变成 {-,1})
修后实测:46 份教辅 2908 处 EQ 域全部还原,公式总数 2954 处、零未包裹残留

安全:application.yml(含 RustFS 密钥)不入库,提供 application.yml.example;
      OssService 的 @Value 默认密钥已清空
2026-09-29 09:43:13 +08:00

69 lines
1.3 KiB
Python

"""
Utility functions for the refactor package.
"""
from .color_helpers import (
detect_uniform_color,
hex_to_latex_color,
should_suppress_color,
wrap_with_uniform_color,
wrap_element_with_color,
)
from .xml_utils import (
text_content,
local_name,
decode_html_entities,
extract_math_equations,
)
from .helpers import (
is_default_color,
)
from .text_processing import (
write_text,
read_text,
convert_spaces_to_latex,
escape_latex_special_chars,
)
from .timer import (
PerformanceTimer,
TimingRecord,
TimingSummary,
get_global_timer,
enable_global_timer,
disable_global_timer,
)
from .debug import (
is_debug_enabled,
debug_print,
)
__all__ = [
'detect_uniform_color',
'hex_to_latex_color',
'should_suppress_color',
'wrap_with_uniform_color',
'wrap_element_with_color',
'text_content',
'local_name',
'decode_html_entities',
'extract_math_equations',
'is_default_color',
'write_text',
'read_text',
'convert_spaces_to_latex',
'escape_latex_special_chars',
'PerformanceTimer',
'TimingRecord',
'TimingSummary',
'get_global_timer',
'enable_global_timer',
'disable_global_timer',
'is_debug_enabled',
'debug_print',
]