Enhance reader styles exports and settings

This commit is contained in:
shenw
2026-06-14 09:51:16 +08:00
parent 586d384da3
commit 63a07b00b8
22 changed files with 3572 additions and 202 deletions
+183 -2
View File
@@ -2,13 +2,16 @@ from pathlib import Path
from tempfile import TemporaryDirectory
from mdhelper.app import parse_arguments
from mdhelper import search as search_module
from mdhelper.doc_check import check_documents
from mdhelper.document_tree import discover_documents
from mdhelper.code_structure import extract_code_headings
from mdhelper.document_tree import DocumentEntry, MAX_DISCOVERABLE_CODE_BYTES, discover_documents
from mdhelper.history import HistoryItem, NavigationHistory
from mdhelper.main_window import re_find_markdown_links
from mdhelper.markdown_utils import extract_headings
from mdhelper.markdown_renderer import MarkdownRenderer
from mdhelper.search import SearchIndex, search_entries
from mdhelper.style_dialog import build_document_style_css
def test_sample_media_and_code_rendering() -> None:
@@ -34,6 +37,14 @@ def test_sample_media_and_code_rendering() -> None:
assert "copy-code-button" in html
assert "code-line" in html
assert "toggle-code-button" in html
assert 'toggle.textContent = "收起";' in html
assert 'block.classList.add("is-collapsible");' in html
assert 'block.classList.add("is-collapsible", "is-collapsed")' not in html
assert '${line || " "}' in html
assert '.join("");' in html
assert "#569cd6" in html
assert "#ce9178" in html
assert "#1e1e1e" in html
assert "image-lightbox" in html
assert "image-lightbox__toolbar" in html
assert 'data-action="fit"' in html
@@ -52,6 +63,8 @@ def test_sample_media_and_code_rendering() -> None:
assert "flowchart LR" in html
assert "math-block" in html
assert "data-math-engine=\"katex\"" in html
assert "data-wheel-scroll-speed=\"1.0\"" in html
assert "configuredWheelSpeed" in html
assert "--reader-font-family:" in html
assert "--reader-font-size:" in html
assert "katex.min.css" in html
@@ -68,10 +81,18 @@ def test_sample_media_and_code_rendering() -> None:
project_root / "sample.md",
document_font_family="Microsoft YaHei UI",
document_font_size=18,
wheel_scroll_speed=2.4,
)
assert "data-wheel-scroll-speed=\"2.4\"" in custom_font_html
assert '"Microsoft YaHei UI"' in custom_font_html
assert "--reader-font-size: 18px;" in custom_font_html
custom_style_html = renderer.render_file(
project_root / "sample.md",
document_style_css=".reader { max-width: 720px; }",
)
assert ".reader { max-width: 720px; }" in custom_style_html
def test_heading_extraction_matches_rendered_anchor() -> None:
project_root = Path(__file__).resolve().parent.parent
@@ -82,6 +103,50 @@ def test_heading_extraction_matches_rendered_anchor() -> None:
assert any(heading.title == "10. Mermaid 图表示例" for heading in headings)
def test_document_style_builder_supports_word_like_paragraph_options() -> None:
css = build_document_style_css(
{
"paragraph": {
"chinese_font_family": "Microsoft YaHei UI",
"english_font_family": "Times New Roman",
"font_size": 18,
"line_height_value": 1.7,
"line_height_unit": "multiple",
"first_line_indent_chars": 2,
"space_before_value": 6,
"space_before_unit": "pt",
"space_after_value": 0.6,
"space_after_unit": "multiple",
},
"h2": {
"bold": True,
"hanging_indent_chars": 1.5,
},
"blockquote": {
"chinese_font_family": "KaiTi",
"english_font_family": "Georgia",
},
},
".reader strong { color: #0057b8; }",
)
assert ".reader p" in css
assert 'font-family: "Times New Roman", "Microsoft YaHei UI"' in css
assert "font-size: 18px;" in css
assert "line-height: 1.7;" in css
assert "text-indent: 2em;" in css
assert "margin-top: 6pt;" in css
assert "margin-bottom: 0.6em;" in css
assert ".reader h2" in css
assert "font-weight: 700;" in css
assert "padding-left: 1.5em;" in css
assert "text-indent: -1.5em;" in css
assert ".reader blockquote p" in css
assert ".reader .admonition p" in css
assert 'font-family: "Georgia", "KaiTi"' in css
assert ".reader strong { color: #0057b8; }" in css
def test_full_text_search_finds_document_body() -> None:
project_root = Path(__file__).resolve().parent.parent
entries = discover_documents(project_root)
@@ -142,7 +207,7 @@ def test_document_checker_reports_missing_local_target() -> None:
def test_app_arguments_support_initial_file_and_check_mode() -> None:
args = parse_arguments(["sample.md"])
assert args.file == "sample.md"
assert args.path == "sample.md"
assert not args.check
check_args = parse_arguments(["--check", "--project-root", "."])
@@ -162,3 +227,119 @@ def test_navigation_history_preserves_scroll_position() -> None:
assert history.current is not None
assert history.current.scroll_y == 120
assert history.back() == first
def test_document_discovery_filters_optional_code_groups(tmp_path: Path) -> None:
(tmp_path / "guide.md").write_text("# Guide\n", encoding="utf-8")
(tmp_path / "tool.py").write_text("def run():\n return 1\n", encoding="utf-8")
(tmp_path / "engine.cpp").write_text("int solve() { return 1; }\n", encoding="utf-8")
default_entries = discover_documents(tmp_path)
all_entries = discover_documents(tmp_path, ("markdown", "python", "cpp"))
assert [entry.path.name for entry in default_entries] == ["guide.md"]
assert {entry.path.name for entry in all_entries} == {"guide.md", "tool.py", "engine.cpp"}
def test_document_discovery_prunes_excluded_directories(tmp_path: Path) -> None:
(tmp_path / "guide.md").write_text("# Guide\n", encoding="utf-8")
hidden_git = tmp_path / ".git"
hidden_git.mkdir()
(hidden_git / "hidden.md").write_text("# Hidden\n", encoding="utf-8")
build_dir = tmp_path / "build"
build_dir.mkdir()
(build_dir / "generated.py").write_text("def generated():\n return 1\n", encoding="utf-8")
entries = discover_documents(tmp_path, ("markdown", "python"))
assert {entry.relative_path for entry in entries} == {"guide.md"}
def test_search_index_reads_body_lazily(tmp_path: Path, monkeypatch) -> None:
path = tmp_path / "guide.md"
path.write_text("placeholder", encoding="utf-8")
entry = DocumentEntry(path=path, title="Guide", relative_path="guide.md")
calls: list[Path] = []
def fake_read_text(read_entry: DocumentEntry) -> str:
calls.append(read_entry.path)
return "body needle"
monkeypatch.setattr(search_module, "_read_text", fake_read_text)
index = search_module.SearchIndex([entry])
assert calls == []
assert index.search("Guide")[0].match_kind == "标题"
assert calls == []
assert index.search("needle")[0].match_kind == "正文"
assert calls == [entry.path]
def test_code_file_rendering_uses_highlighting_and_line_anchors(tmp_path: Path) -> None:
code_path = tmp_path / "tool.py"
source = "class Runner:\n def run(self):\n return 1\n"
renderer = MarkdownRenderer(tmp_path)
html = renderer.render_code_source(source, code_path, language="python")
assert "code-file-view" in html
assert "language-python" in html
assert "line-1" in html
assert "Runner" in html
def test_code_headings_extract_python_and_cpp_symbols(tmp_path: Path) -> None:
python_path = tmp_path / "tool.py"
cpp_path = tmp_path / "engine.cpp"
python_source = "class Runner:\n def run(self):\n return 1\n\nasync def main():\n return None\n"
cpp_source = "struct Node { int value; };\n\nint solve(int value) { return value; }\n"
python_headings = extract_code_headings(python_path, python_source)
cpp_headings = extract_code_headings(cpp_path, cpp_source)
assert [heading.title for heading in python_headings] == ["class Runner", "def run", "async def main"]
assert [heading.slug for heading in python_headings] == ["line-1", "line-2", "line-5"]
assert any(heading.title == "struct Node" for heading in cpp_headings)
assert any(heading.title == "function solve" for heading in cpp_headings)
def test_search_index_reads_optional_code_documents(tmp_path: Path) -> None:
(tmp_path / "tool.py").write_text("def calculate_magic_value():\n return 42\n", encoding="utf-8")
entries = discover_documents(tmp_path, ("python",))
matches = SearchIndex(entries).search("magic_value")
assert matches
assert matches[0].entry.path.name == "tool.py"
assert matches[0].match_kind == "正文"
def test_large_code_files_are_not_auto_discovered(tmp_path: Path) -> None:
(tmp_path / "guide.md").write_text("# Guide\n", encoding="utf-8")
large_code = tmp_path / "large_module.py"
large_code.write_text("# large\n" + ("x = 1\n" * ((MAX_DISCOVERABLE_CODE_BYTES // 6) + 2)), encoding="utf-8")
entries = discover_documents(tmp_path, ("markdown", "python"))
assert {entry.path.name for entry in entries} == {"guide.md"}
def test_code_search_reads_gbk_source(tmp_path: Path) -> None:
source_path = tmp_path / "legacy.py"
source_path.write_text("# 中文注释\ndef legacy_name():\n return '命中'\n", encoding="gbk")
entries = discover_documents(tmp_path, ("python",))
matches = SearchIndex(entries).search("命中")
assert matches
assert matches[0].entry.path.name == "legacy.py"
def test_code_headings_read_gbk_source_when_source_not_supplied(tmp_path: Path) -> None:
source_path = tmp_path / "legacy.py"
source_path.write_text("class 中文类:\n def run(self):\n return 1\n", encoding="gbk")
headings = extract_code_headings(source_path)
assert headings[0].title == "class 中文类"
assert headings[1].title == "def run"