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 默认密钥已清空
This commit is contained in:
55
scripts/omml_mathml2latex/utils/debug.py
Normal file
55
scripts/omml_mathml2latex/utils/debug.py
Normal file
@@ -0,0 +1,55 @@
|
||||
"""
|
||||
Debug output control utility.
|
||||
|
||||
This module provides a centralized way to control debug output across the project.
|
||||
Debug output is disabled by default and can be enabled via the OMML2TEX_DEBUG
|
||||
environment variable.
|
||||
|
||||
Usage:
|
||||
from omml2tex.utils.debug import debug_print
|
||||
|
||||
debug_print("[DEBUG] Some debug info") # Only prints if OMML2TEX_DEBUG=1
|
||||
|
||||
Environment Variables:
|
||||
OMML2TEX_DEBUG: Set to "1" or "true" to enable debug output (default: disabled)
|
||||
"""
|
||||
|
||||
import os
|
||||
import sys
|
||||
|
||||
|
||||
def is_debug_enabled() -> bool:
|
||||
"""
|
||||
Check if debug mode is enabled via environment variable.
|
||||
|
||||
Returns:
|
||||
True if OMML2TEX_DEBUG is set to "1" or "true", False otherwise
|
||||
"""
|
||||
debug_value = os.environ.get('OMML2TEX_DEBUG', '').lower()
|
||||
return debug_value in ('1', 'true', 'yes', 'on')
|
||||
|
||||
|
||||
def debug_print(*args, **kwargs):
|
||||
"""
|
||||
Print debug output only if debug mode is enabled.
|
||||
|
||||
This function has the same signature as the built-in print() function,
|
||||
but only outputs to stderr when OMML2TEX_DEBUG environment variable is set.
|
||||
|
||||
Args:
|
||||
*args: Arguments to print
|
||||
**kwargs: Keyword arguments for print (e.g., file, sep, end)
|
||||
|
||||
Examples:
|
||||
>>> debug_print("[DEBUG] Processing equation")
|
||||
>>> debug_print("[DEBUG] Value:", value, "Result:", result)
|
||||
>>> debug_print("[DEBUG] Error", file=sys.stderr) # file=sys.stderr is default
|
||||
"""
|
||||
if is_debug_enabled():
|
||||
# Default to stderr if file not specified
|
||||
if 'file' not in kwargs:
|
||||
kwargs['file'] = sys.stderr
|
||||
print(*args, **kwargs)
|
||||
|
||||
|
||||
__all__ = ['is_debug_enabled', 'debug_print']
|
||||
Reference in New Issue
Block a user