alran 0.0.0-stage → 0.9.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/ALRAN_TOOLS_NOTICES.md +64 -0
- package/LICENSE +27 -0
- package/LICENSE-STATUS.md +21 -0
- package/NOTICE +6 -0
- package/README.md +289 -2
- package/THIRD_PARTY_NOTICES.md +113 -0
- package/alran-tools.js +3 -0
- package/assets/agents/_default/prompt-auto_classifier.md +185 -0
- package/assets/agents/_default/prompt-auto_classifier_extras.md +17 -0
- package/assets/agents/_default/prompt-base-all.md +133 -0
- package/assets/agents/_default/prompt-base-all.md.hbs +228 -0
- package/assets/agents/_default/prompt-base-windows.md +5 -0
- package/assets/agents/_default/prompt-base-windows.md.hbs +5 -0
- package/assets/agents/_default/prompt-base-worker.md +10 -0
- package/assets/agents/_default/prompt-base-worker.md.hbs +27 -0
- package/assets/agents/_default/prompt-compact.md +76 -0
- package/assets/agents/_default/prompt-compact_continue.md +9 -0
- package/assets/agents/_default/prompt-git.md +8 -0
- package/assets/agents/_default/prompt-goal.md +13 -0
- package/assets/agents/_default/prompt-session-branch.md +3 -0
- package/assets/agents/_default/prompt-session-branch.md.hbs +30 -0
- package/assets/agents/_default/prompt-session-root.md +3 -0
- package/assets/agents/_default/prompt-session-root.md.hbs +32 -0
- package/assets/agents/_default/prompt-title.md +11 -0
- package/assets/agents/_default/prompt-tool_agent.md +22 -0
- package/assets/agents/_migration/README.md +20 -0
- package/assets/agents/_migration/coder/PERSONA.md +11 -0
- package/assets/agents/_migration/coder/system-prompt.md.hbs +42 -0
- package/assets/agents/_migration/general/PERSONA.md +11 -0
- package/assets/agents/_migration/general/system-prompt.md.hbs +49 -0
- package/assets/agents/_v2/AGENT_CONTEXT.md.hbs +245 -0
- package/assets/agents/_v2/PTC_TOOL_CALLS.md.hbs +35 -0
- package/assets/agents/_v2/coding/SYSTEM.md.hbs +173 -0
- package/assets/agents/_v2/explore.md.hbs +38 -0
- package/assets/agents/_v2/tui/SYSTEM.md.hbs +211 -0
- package/assets/agents/_v2/verifier.md.hbs +32 -0
- package/assets/agents/_v2/work/SYSTEM.md.hbs +186 -0
- package/assets/agents/_v2/worker.md.hbs +27 -0
- package/assets/agents/alran/PERSONA.md +7 -0
- package/assets/agents/alran/features/cron.md.hbs +0 -0
- package/assets/agents/alran/features/delegation.md.hbs +56 -0
- package/assets/agents/alran/features/memory.md.hbs +61 -0
- package/assets/agents/alran/features/recoverable-deletion.md.hbs +10 -0
- package/assets/agents/alran/features/task-management.md.hbs +11 -0
- package/assets/agents/alran/features/web-search.md.hbs +11 -0
- package/assets/agents/alran/modes/coding/online/PERSONA.md.hbs +20 -0
- package/assets/agents/alran/modes/coding/online/SYSTEM.md.hbs +158 -0
- package/assets/agents/alran/modes/work/online/PERSONA.md.hbs +20 -0
- package/assets/agents/alran/modes/work/online/SYSTEM.md.hbs +160 -0
- package/assets/agents/alran/prompt-session-root.md +4 -0
- package/assets/agents/alran/prompt-session-root.md.hbs +4 -0
- package/assets/agents/alran/skills/alran-code-product/SKILL.md +72 -0
- package/assets/agents/alran/skills/alran-code-product/references/account-models.md +61 -0
- package/assets/agents/alran/skills/alran-code-product/references/agents.md +34 -0
- package/assets/agents/alran/skills/alran-code-product/references/extensions.md +46 -0
- package/assets/agents/alran/skills/alran-code-product/references/workflows.md +56 -0
- package/assets/agents/alran/skills/control-in-app-browser/SKILL.md +590 -0
- package/assets/agents/alran/system-prompt.md.hbs +97 -0
- package/assets/agents/builtin-agents.json +1 -0
- package/assets/agents/desktop-task/archive-title/system-en.md +1 -0
- package/assets/agents/desktop-task/checkpoint/system.md +19 -0
- package/assets/agents/desktop-task/output-revision/system.md +1 -0
- package/assets/agents/desktop-task/retry/continuation.md +4 -0
- package/assets/agents/desktop-task/session-title/system.md +41 -0
- package/assets/agents/explore/PERSONA.md +8 -0
- package/assets/agents/explore/agent.md +14 -0
- package/assets/agents/explore/system-prompt.md.hbs +35 -0
- package/assets/agents/greeting.md +61 -0
- package/assets/agents/managed-prompts.json +47 -0
- package/assets/agents/prompt-exemptions.json +36 -0
- package/assets/agents/verifier/PERSONA.md +8 -0
- package/assets/agents/verifier/agent.md +17 -0
- package/assets/agents/verifier/system-prompt.md.hbs +28 -0
- package/assets/agents/worker/PERSONA.md +8 -0
- package/assets/agents/worker/agent.md +18 -0
- package/assets/agents/worker/system-prompt.md.hbs +22 -0
- package/assets/agents/workflow/code-review/review-candidates.md +120 -0
- package/assets/agents/workflow/code-review/reviewer-system.md +75 -0
- package/assets/agents/workflow/goal/budget-limit.md +16 -0
- package/assets/agents/workflow/goal/continuation.md +62 -0
- package/assets/agents/workflow/goal/objective-updated.md +16 -0
- package/assets/agents/workflow/goal/recovery-terminal-audit.md +13 -0
- package/assets/agents/workflow/goal/recovery.md +11 -0
- package/assets/agents/workflow/goal/terminal-audit.md +10 -0
- package/assets/agents/workflow/plan-mode/agent-entry.md +72 -0
- package/assets/agents/workflow/prompt-hook/system.md +0 -0
- package/assets/models-dev-catalog.json.gz +0 -0
- package/assets/prompts/code-review/review-candidates.md +120 -0
- package/assets/prompts/code-review/reviewer-system.md +75 -0
- package/assets/skills/alran-tools-master/SKILL.md +127 -0
- package/assets/skills/code-review/SKILL.md +51 -0
- package/assets/skills/cu-desktop/SKILL.md +255 -0
- package/assets/skills/deep-research/SKILL.md +30 -0
- package/assets/skills/deploy-website/SKILL.md +52 -0
- package/assets/skills/docx/LICENSE +21 -0
- package/assets/skills/docx/SKILL.md +259 -0
- package/assets/skills/docx/assets/styles/academic_styles.xml +250 -0
- package/assets/skills/docx/assets/styles/corporate_styles.xml +284 -0
- package/assets/skills/docx/assets/styles/default_styles.xml +449 -0
- package/assets/skills/docx/assets/xsd/aesthetic-rules.xsd +470 -0
- package/assets/skills/docx/assets/xsd/business-rules.xsd +130 -0
- package/assets/skills/docx/assets/xsd/common-types.xsd +159 -0
- package/assets/skills/docx/assets/xsd/wml-subset.xsd +589 -0
- package/assets/skills/docx/docs/acceptance-checklists/create.md +7 -0
- package/assets/skills/docx/docs/acceptance-checklists/edit.md +6 -0
- package/assets/skills/docx/docs/acceptance-checklists/layout-repair.md +7 -0
- package/assets/skills/docx/docs/acceptance-checklists/template.md +6 -0
- package/assets/skills/docx/docs/acceptance.md +139 -0
- package/assets/skills/docx/docs/anti-patterns.md +14 -0
- package/assets/skills/docx/docs/backends.md +116 -0
- package/assets/skills/docx/docs/evidence.md +73 -0
- package/assets/skills/docx/docs/failure-taxonomy.md +71 -0
- package/assets/skills/docx/docs/index.md +50 -0
- package/assets/skills/docx/docs/rendered-delivery.md +125 -0
- package/assets/skills/docx/docs/router.md +122 -0
- package/assets/skills/docx/docs/tables-and-numbering.md +27 -0
- package/assets/skills/docx/docs/task-apply-template.md +141 -0
- package/assets/skills/docx/docs/task-compare-two-docx.md +48 -0
- package/assets/skills/docx/docs/task-create.md +124 -0
- package/assets/skills/docx/docs/task-edit-fill.md +69 -0
- package/assets/skills/docx/docs/task-read-content.md +148 -0
- package/assets/skills/docx/docs/task-read-rendered.md +78 -0
- package/assets/skills/docx/docs/task-read-structure.md +93 -0
- package/assets/skills/docx/docs/task-repair-layout.md +70 -0
- package/assets/skills/docx/docs/template-dsl.md +32 -0
- package/assets/skills/docx/docs/track-changes.md +15 -0
- package/assets/skills/docx/docs/xml-patch-dsl.md +33 -0
- package/assets/skills/docx/references/cjk_typography.md +357 -0
- package/assets/skills/docx/references/cjk_university_template_guide.md +184 -0
- package/assets/skills/docx/references/comments_guide.md +191 -0
- package/assets/skills/docx/references/design_good_bad_examples.md +829 -0
- package/assets/skills/docx/references/design_principles.md +819 -0
- package/assets/skills/docx/references/openxml_element_order.md +308 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part1.md +4061 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part2.md +2820 -0
- package/assets/skills/docx/references/openxml_encyclopedia_part3.md +3381 -0
- package/assets/skills/docx/references/openxml_namespaces.md +82 -0
- package/assets/skills/docx/references/openxml_units.md +72 -0
- package/assets/skills/docx/references/sample-patch-plans.json +22 -0
- package/assets/skills/docx/references/sample-task-intents.json +5 -0
- package/assets/skills/docx/references/sample-template-manifests.json +21 -0
- package/assets/skills/docx/references/scenario_a_create.md +284 -0
- package/assets/skills/docx/references/scenario_b_edit_content.md +295 -0
- package/assets/skills/docx/references/scenario_c_apply_template.md +456 -0
- package/assets/skills/docx/references/track_changes_guide.md +200 -0
- package/assets/skills/docx/references/troubleshooting.md +506 -0
- package/assets/skills/docx/references/typography_guide.md +294 -0
- package/assets/skills/docx/references/xsd_validation_guide.md +158 -0
- package/assets/skills/docx/scripts/build_patch_plan.py +29 -0
- package/assets/skills/docx/scripts/diff_docx_structure.py +61 -0
- package/assets/skills/docx/scripts/doc_to_docx.ps1 +85 -0
- package/assets/skills/docx/scripts/doc_to_docx.sh +40 -0
- package/assets/skills/docx/scripts/docx_preview.ps1 +76 -0
- package/assets/skills/docx/scripts/docx_preview.sh +37 -0
- package/assets/skills/docx/scripts/docx_to_pdf.py +87 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/AlranAIDocx.Cli.csproj +19 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Cli/Program.cs +18 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/AlranAIDocx.Core.csproj +15 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/AnalyzeCommand.cs +147 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ApplyTemplateCommand.cs +322 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/CreateCommand.cs +324 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/DiffCommand.cs +155 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/EditContentCommand.cs +487 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/FixOrderCommand.cs +108 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/MergeRunsCommand.cs +122 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Commands/ValidateCommand.cs +107 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/CommentSynchronizer.cs +169 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/ElementOrder.cs +80 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/NamespaceConstants.cs +42 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/RunMerger.cs +81 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/StyleAnalyzer.cs +81 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/TrackChangesHelper.cs +99 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/OpenXml/UnitConverter.cs +23 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples.cs +1832 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch1.cs +910 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch2.cs +999 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch3.cs +1048 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/AestheticRecipeSamples_Batch4.cs +1038 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/CharacterFormattingSamples.cs +1020 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/DocumentCreationSamples.cs +1121 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FieldAndTocSamples.cs +624 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/FootnoteAndCommentSamples.cs +675 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/HeaderFooterSamples.cs +838 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ImageSamples.cs +917 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ListAndNumberingSamples.cs +826 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/ParagraphFormattingSamples.cs +1199 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/StyleSystemSamples.cs +1487 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TableSamples.cs +1163 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Samples/TrackChangesSamples.cs +595 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/CjkHelper.cs +39 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/FontDefaults.cs +24 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Typography/PageSizes.cs +20 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/BusinessRuleValidator.cs +224 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/GateCheckValidator.cs +148 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/ValidationResult.cs +23 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.Core/Validation/XsdValidator.cs +69 -0
- package/assets/skills/docx/scripts/dotnet/AlranAIDocx.slnx +4 -0
- package/assets/skills/docx/scripts/env_check.ps1 +327 -0
- package/assets/skills/docx/scripts/env_check.sh +340 -0
- package/assets/skills/docx/scripts/extract_docx_text.py +1075 -0
- package/assets/skills/docx/scripts/pack_docx.py +31 -0
- package/assets/skills/docx/scripts/read_docx_structure.py +1032 -0
- package/assets/skills/docx/scripts/render_docx_pages.py +147 -0
- package/assets/skills/docx/scripts/rendered_report.py +609 -0
- package/assets/skills/docx/scripts/setup.ps1 +542 -0
- package/assets/skills/docx/scripts/setup.sh +537 -0
- package/assets/skills/docx/scripts/unpack_docx.py +29 -0
- package/assets/skills/docx/scripts/validate_template_manifest.py +60 -0
- package/assets/skills/docx/scripts/verify_anchor_atomicity.py +87 -0
- package/assets/skills/edit-deployed-website/SKILL.md +27 -0
- package/assets/skills/init/SKILL.md +135 -0
- package/assets/skills/llm-call/SKILL.md +48 -0
- package/assets/skills/llm-call/scripts/llm_call.py +458 -0
- package/assets/skills/pdf/SKILL.md +280 -0
- package/assets/skills/pdf/docs/advanced-reference.md +711 -0
- package/assets/skills/pdf/docs/create-guide.md +437 -0
- package/assets/skills/pdf/docs/design-guide.md +204 -0
- package/assets/skills/pdf/docs/forms-guide.md +462 -0
- package/assets/skills/pdf/docs/html-pdf-spec.md +500 -0
- package/assets/skills/pdf/docs/latex-academic-thesis-guide.md +233 -0
- package/assets/skills/pdf/docs/latex-technical-book-guide.md +112 -0
- package/assets/skills/pdf/docs/pitfalls-index.md +792 -0
- package/assets/skills/pdf/docs/read-guide.md +358 -0
- package/assets/skills/pdf/docs/reformat-guide.md +238 -0
- package/assets/skills/pdf/docs/skill-readme-archive.md +151 -0
- package/assets/skills/pdf/docs/troubleshooting.md +86 -0
- package/assets/skills/pdf/docs/vision-guide.md +188 -0
- package/assets/skills/pdf/scripts/__init__.py +0 -0
- package/assets/skills/pdf/scripts/_pdf_read_lib.py +284 -0
- package/assets/skills/pdf/scripts/fill/__init__.py +0 -0
- package/assets/skills/pdf/scripts/fill/acroform_apply.py +153 -0
- package/assets/skills/pdf/scripts/fill/overlay_apply.py +109 -0
- package/assets/skills/pdf/scripts/lib/__init__.py +0 -0
- package/assets/skills/pdf/scripts/lib/acroform_io.py +170 -0
- package/assets/skills/pdf/scripts/lib/cli_utils.py +41 -0
- package/assets/skills/pdf/scripts/lib/geometry.py +79 -0
- package/assets/skills/pdf/scripts/make.sh +388 -0
- package/assets/skills/pdf/scripts/merge.py +112 -0
- package/assets/skills/pdf/scripts/pdf_inspect/__init__.py +0 -0
- package/assets/skills/pdf/scripts/pdf_inspect/acroform_inspect.py +52 -0
- package/assets/skills/pdf/scripts/pdf_inspect/acroform_probe.py +57 -0
- package/assets/skills/pdf/scripts/pdf_inspect/layout_scan.py +164 -0
- package/assets/skills/pdf/scripts/read_pdf_vision.py +473 -0
- package/assets/skills/pdf/scripts/reformat_parse.py +181 -0
- package/assets/skills/pdf/scripts/render/__init__.py +0 -0
- package/assets/skills/pdf/scripts/render/overlay_preview.py +86 -0
- package/assets/skills/pdf/scripts/render/page_rasterize.py +85 -0
- package/assets/skills/pdf/scripts/render_html.cjs +205 -0
- package/assets/skills/pdf/scripts/validate/__init__.py +0 -0
- package/assets/skills/pdf/scripts/validate/geometry_lint.py +124 -0
- package/assets/skills/pdf/templates/INDEX.md +90 -0
- package/assets/skills/pdf/templates/bilingual-menu-premium/README.md +175 -0
- package/assets/skills/pdf/templates/bilingual-menu-premium/skeleton.html +343 -0
- package/assets/skills/pdf/templates/brand-guide-2page/README.md +140 -0
- package/assets/skills/pdf/templates/brand-guide-2page/skeleton.html +264 -0
- package/assets/skills/pdf/templates/data-viz-report/README.md +234 -0
- package/assets/skills/pdf/templates/data-viz-report/skeleton.html +835 -0
- package/assets/skills/pdf/templates/form-fill-acroform/README.md +195 -0
- package/assets/skills/pdf/templates/form-fill-acroform/field_values.template.json +118 -0
- package/assets/skills/pdf/templates/latex-academic-thesis/README.md +146 -0
- package/assets/skills/pdf/templates/latex-academic-thesis/source.tex +334 -0
- package/assets/skills/pdf/templates/latex-technical-book/README.md +130 -0
- package/assets/skills/pdf/templates/latex-technical-book/README.template-source.md +62 -0
- package/assets/skills/pdf/templates/latex-technical-book/source.tex +439 -0
- package/assets/skills/pdf/templates/multi-article-aggregator/README.md +148 -0
- package/assets/skills/pdf/templates/multi-article-aggregator/pipeline.md +223 -0
- package/assets/skills/pdf/templates/multilang-research-report/README.md +136 -0
- package/assets/skills/pdf/templates/multilang-research-report/skeleton.html +242 -0
- package/assets/skills/pdf/templates/reformat-default/README.md +136 -0
- package/assets/skills/pdf/templates/reformat-default/skeleton.html +204 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/README.md +136 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/skeleton.html +96 -0
- package/assets/skills/pdf/templates/translate-preserve-layout/terminology.template.json +66 -0
- package/assets/skills/pptx/SKILL.md +283 -0
- package/assets/skills/pptx/references/design-system.md +424 -0
- package/assets/skills/pptx/references/editing.md +162 -0
- package/assets/skills/pptx/references/element-map.md +229 -0
- package/assets/skills/pptx/references/pitfalls.md +205 -0
- package/assets/skills/pptx/references/pptxgenjs.md +420 -0
- package/assets/skills/pptx/references/preview-selection-writeback.md +65 -0
- package/assets/skills/pptx/references/python-pptx-recipes.md +63 -0
- package/assets/skills/pptx/references/slide-types.md +413 -0
- package/assets/skills/pptx/scripts/alran-ppt-map.cjs +280 -0
- package/assets/skills/pptx/scripts/audit_pptx.py +708 -0
- package/assets/skills/pptx/scripts/extract_comments.py +468 -0
- package/assets/skills/pptx/scripts/extract_images.py +226 -0
- package/assets/skills/pptx/scripts/extract_pptx.py +285 -0
- package/assets/skills/pptx/scripts/pdf2png.swift +203 -0
- package/assets/skills/pptx/scripts/pptx-screenshot.sh +105 -0
- package/assets/skills/resume-codex/SKILL.md +53 -0
- package/assets/skills/resume-codex/scripts/session-reader.mjs +445 -0
- package/assets/skills/skill-creator/SKILL.md +188 -0
- package/assets/skills/skill-creator/references/anti-patterns.md +149 -0
- package/assets/skills/skill-creator/references/commands-macos-linux.md +38 -0
- package/assets/skills/skill-creator/references/commands-windows-powershell.md +48 -0
- package/assets/skills/skill-creator/references/description-rubric.md +83 -0
- package/assets/skills/skill-creator/references/skill-template.md +101 -0
- package/assets/skills/skill-creator/references/when-to-bundle-scripts.md +139 -0
- package/assets/skills/skill-creator/scripts/lint-skill.js +226 -0
- package/assets/skills/skill-refiner/SKILL.md +137 -0
- package/assets/skills/visual-page/SKILL.md +194 -0
- package/assets/skills/x-link-reader/SKILL.md +108 -0
- package/assets/skills/xlsx/SKILL.md +498 -0
- package/assets/skills/xlsx/docs/advanced-reference.md +410 -0
- package/assets/skills/xlsx/docs/conventions-guide.md +217 -0
- package/assets/skills/xlsx/docs/create-edit-guide.md +410 -0
- package/assets/skills/xlsx/docs/pitfalls-index.md +759 -0
- package/assets/skills/xlsx/docs/raw-xml-escape-hatch.md +201 -0
- package/assets/skills/xlsx/docs/recalc-guide.md +295 -0
- package/assets/skills/xlsx/scripts/office/helpers/__init__.py +0 -0
- package/assets/skills/xlsx/scripts/office/helpers/merge_runs.py +199 -0
- package/assets/skills/xlsx/scripts/office/helpers/simplify_redlines.py +197 -0
- package/assets/skills/xlsx/scripts/office/pack.py +159 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chart.xsd +1499 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-chartDrawing.xsd +146 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-diagram.xsd +1085 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-lockedCanvas.xsd +11 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-main.xsd +3081 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-picture.xsd +23 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-spreadsheetDrawing.xsd +185 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/dml-wordprocessingDrawing.xsd +287 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/pml.xsd +1676 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-additionalCharacteristics.xsd +28 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-bibliography.xsd +144 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-commonSimpleTypes.xsd +174 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlDataProperties.xsd +25 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-customXmlSchemaProperties.xsd +18 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesCustom.xsd +59 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesExtended.xsd +56 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-documentPropertiesVariantTypes.xsd +195 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-math.xsd +582 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/shared-relationshipReference.xsd +25 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/sml.xsd +4439 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-main.xsd +570 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-officeDrawing.xsd +509 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-presentationDrawing.xsd +12 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-spreadsheetDrawing.xsd +108 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/vml-wordprocessingDrawing.xsd +96 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/wml.xsd +3646 -0
- package/assets/skills/xlsx/scripts/office/schemas/ISO-IEC29500-4_2016/xml.xsd +116 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-contentTypes.xsd +42 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-coreProperties.xsd +50 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-digSig.xsd +49 -0
- package/assets/skills/xlsx/scripts/office/schemas/ecma/fouth-edition/opc-relationships.xsd +33 -0
- package/assets/skills/xlsx/scripts/office/schemas/mce/mc.xsd +75 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2010.xsd +560 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2012.xsd +67 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-2018.xsd +14 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cex-2018.xsd +20 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-cid-2016.xsd +13 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-sdtdatahash-2020.xsd +4 -0
- package/assets/skills/xlsx/scripts/office/schemas/microsoft/wml-symex-2015.xsd +8 -0
- package/assets/skills/xlsx/scripts/office/soffice.py +191 -0
- package/assets/skills/xlsx/scripts/office/unpack.py +132 -0
- package/assets/skills/xlsx/scripts/office/validate.py +117 -0
- package/assets/skills/xlsx/scripts/office/validators/__init__.py +15 -0
- package/assets/skills/xlsx/scripts/office/validators/base.py +851 -0
- package/assets/skills/xlsx/scripts/office/validators/docx.py +446 -0
- package/assets/skills/xlsx/scripts/office/validators/pptx.py +275 -0
- package/assets/skills/xlsx/scripts/office/validators/redlining.py +247 -0
- package/assets/skills/xlsx/scripts/recalc.py +450 -0
- package/chunks/account-commands-JZ6NXTTK.js +2 -0
- package/chunks/anthropic-MN33DP4E.js +2 -0
- package/chunks/application-ITGAJ4HC.js +2 -0
- package/chunks/auth-command-V3RVPLZO.js +2 -0
- package/chunks/azure-openai-responses-OWHMUNKC.js +2 -0
- package/chunks/chunk-2TF6JAQM.js +2 -0
- package/chunks/chunk-33CNY6GP.js +2 -0
- package/chunks/chunk-3AODGLMF.js +2 -0
- package/chunks/chunk-44VPC5LA.js +38 -0
- package/chunks/chunk-4CN3IJFH.js +2 -0
- package/chunks/chunk-4PDIO3M6.js +2 -0
- package/chunks/chunk-4X22UJQH.js +164 -0
- package/chunks/chunk-6255CZPL.js +2 -0
- package/chunks/chunk-6P4UKHGR.js +2 -0
- package/chunks/chunk-7QLAXRD2.js +1085 -0
- package/chunks/chunk-7XYOYZX2.js +2 -0
- package/chunks/chunk-A7GMJNA2.js +29 -0
- package/chunks/chunk-AGUSPIUP.js +2 -0
- package/chunks/chunk-BQ3CF3KE.js +2 -0
- package/chunks/chunk-C3CMJAAV.js +3 -0
- package/chunks/chunk-CJM7ZJ6W.js +7 -0
- package/chunks/chunk-CSOUJVKM.js +2 -0
- package/chunks/chunk-D66ZSHXR.js +2 -0
- package/chunks/chunk-D7MGU75P.js +2 -0
- package/chunks/chunk-E3GLGDGC.js +5 -0
- package/chunks/chunk-ENHOPPS7.js +16 -0
- package/chunks/chunk-EOR6EDNR.js +2 -0
- package/chunks/chunk-EYK25HWR.js +2 -0
- package/chunks/chunk-F46IELF5.js +2 -0
- package/chunks/chunk-FC4M2B7E.js +2 -0
- package/chunks/chunk-FSNYOJPJ.js +2 -0
- package/chunks/chunk-FUERW2DW.js +3 -0
- package/chunks/chunk-FXOH6TEQ.js +21 -0
- package/chunks/chunk-GP52JZMY.js +2 -0
- package/chunks/chunk-GRXX6I72.js +2 -0
- package/chunks/chunk-GSYHBK5Q.js +6 -0
- package/chunks/chunk-HNWBFJNO.js +2 -0
- package/chunks/chunk-IIE366LR.js +6706 -0
- package/chunks/chunk-IWK7PZP7.js +207 -0
- package/chunks/chunk-J3KCPYZT.js +2 -0
- package/chunks/chunk-KCLRJQ53.js +59 -0
- package/chunks/chunk-LU4RPLJ3.js +2 -0
- package/chunks/chunk-LZJYNT32.js +2 -0
- package/chunks/chunk-M7GW4VMR.js +27 -0
- package/chunks/chunk-MACBL5HF.js +2 -0
- package/chunks/chunk-N5NTXCJI.js +2 -0
- package/chunks/chunk-N5SVBCUB.js +7 -0
- package/chunks/chunk-N6W7ZL26.js +2 -0
- package/chunks/chunk-NWB7LFOK.js +131 -0
- package/chunks/chunk-OIQ336YE.js +16 -0
- package/chunks/chunk-OQNU3VPS.js +30 -0
- package/chunks/chunk-OTDNOWXG.js +16 -0
- package/chunks/chunk-PNXZWSWT.js +3 -0
- package/chunks/chunk-QFUV5PX6.js +2 -0
- package/chunks/chunk-QIN5ZBE2.js +2 -0
- package/chunks/chunk-QKBN5CGI.js +2 -0
- package/chunks/chunk-QPGTKSIQ.js +2 -0
- package/chunks/chunk-SIOLUFGG.js +2 -0
- package/chunks/chunk-TW23QKAD.js +3 -0
- package/chunks/chunk-U3RMPDXU.js +2 -0
- package/chunks/chunk-U7U3DJHF.js +2 -0
- package/chunks/chunk-VLXX22YO.js +2 -0
- package/chunks/chunk-WHD2XVT2.js +2 -0
- package/chunks/chunk-WTAJMYF2.js +249 -0
- package/chunks/chunk-WWNUAU4P.js +29 -0
- package/chunks/chunk-WYANV3IX.js +4 -0
- package/chunks/chunk-XAGZ6ZEU.js +9 -0
- package/chunks/chunk-XFCC2CI2.js +24 -0
- package/chunks/chunk-XQK7JM66.js +2 -0
- package/chunks/chunk-YLQXZBEL.js +2 -0
- package/chunks/chunk-YPV2X2RG.js +2 -0
- package/chunks/chunk-Z6BHCXKT.js +25 -0
- package/chunks/chunk-Z6HBNJCA.js +8 -0
- package/chunks/chunk-ZQKVUPKA.js +2 -0
- package/chunks/chunk-ZQOALVGL.js +2 -0
- package/chunks/clipboard-image-PQPC4EHR.js +2 -0
- package/chunks/data-dir-LDVKDCJ2.js +2 -0
- package/chunks/dist-2BRD4JFU.js +11 -0
- package/chunks/dist-EXKHRFQO.js +5 -0
- package/chunks/emscripten-module-RD6P2XH5.js +2 -0
- package/chunks/emscripten-module-WYNDFH3N.js +2 -0
- package/chunks/emscripten-module-XPTEOIWW.js +2 -0
- package/chunks/emscripten-module-ZS3PMSDF.js +2 -0
- package/chunks/ffi-IO7WZQNG.js +2 -0
- package/chunks/ffi-M5UP5J6C.js +2 -0
- package/chunks/ffi-ORLOPBB3.js +2 -0
- package/chunks/ffi-OUPK6AY6.js +2 -0
- package/chunks/google-UJAPMFAB.js +2 -0
- package/chunks/google-vertex-VLSF55PW.js +2 -0
- package/chunks/install-source-JTIUC4G4.js +2 -0
- package/chunks/launcher-FCZ3EDBF.js +61 -0
- package/chunks/lifecycle-GY435YMF.js +2 -0
- package/chunks/main-TQGGRHTS.js +13 -0
- package/chunks/mistral-ZJZUEF2X.js +3 -0
- package/chunks/module-6F3E5H7Y-BN7QWGYB.js +2 -0
- package/chunks/module-asyncify-R6PWJ6ZV-P4FWSBAY.js +2 -0
- package/chunks/multipart-parser-L6M455MS.js +2 -0
- package/chunks/network-proxy-U72JCK2I.js +2 -0
- package/chunks/openai-codex-responses-FPCDNRL5.js +2 -0
- package/chunks/openai-completions-D32YW6KL.js +2 -0
- package/chunks/openai-responses-ZCGSENM4.js +2 -0
- package/chunks/openrouter-G2EHY5BD.js +2 -0
- package/chunks/otel-OHXIZ666.js +2 -0
- package/chunks/package-contract-GVXTMJ3N.js +2 -0
- package/chunks/pdfjs-SHZAF7PF.js +107 -0
- package/chunks/photon_rs-C52RL4CI.js +3 -0
- package/chunks/plugin-command-OSAFHS7C.js +2 -0
- package/chunks/provider-command-SKTCHD4E.js +2 -0
- package/chunks/questionnaire-bridge-ISQOCYWY.js +2 -0
- package/chunks/run-acp-command-SG2BDMFJ.js +2 -0
- package/chunks/run-exec-command-5ADSQR2Z.js +15 -0
- package/chunks/skills-command-XXXEZAG6.js +2 -0
- package/chunks/src-DNIDEMVV.js +2 -0
- package/chunks/src-IBHIRTD7.js +2 -0
- package/chunks/telemetry-J7ZLGF5X.js +2 -0
- package/chunks/telemetry-command-COQG2AKK.js +5 -0
- package/chunks/tools-WDBB2JKV.js +2 -0
- package/chunks/undici-TUGHZJSA.js +2 -0
- package/chunks/update-NB6OD572.js +14 -0
- package/chunks/update-hint-ED7O67WU.js +3 -0
- package/chunks/wechat-onboard-UWXQW2HT.js +2 -0
- package/cli.js +5 -0
- package/configs/data-minimal.yaml +50 -0
- package/embedded/alran-tools/cli.mjs +4961 -0
- package/embedded/alran-tools/manifest.json +25 -0
- package/emscripten-module.wasm +0 -0
- package/image-preview-worker.js +2 -0
- package/internal-bin/alran-tools +9 -0
- package/internal-bin/alran-tools.cmd +8 -0
- package/matrix-mcp-stdio.js +4 -0
- package/native/darwin/prebuilds/darwin-arm64/darwin-modifiers.node +0 -0
- package/native/darwin/prebuilds/darwin-x64/darwin-modifiers.node +0 -0
- package/native/win32/prebuilds/win32-arm64/win32-console-mode.node +0 -0
- package/native/win32/prebuilds/win32-x64/win32-console-mode.node +0 -0
- package/package.json +38 -4
- package/photon_rs_bg.wasm +0 -0
- package/quickjs-worker.js +152 -0
- package/vendor/java-proxy-agent/build.ts +97 -0
- package/vendor/java-proxy-agent/srt-proxy-agent.jar +0 -0
- package/vendor/seccomp/arm64/apply-seccomp +0 -0
- package/vendor/seccomp/build.ts +74 -0
- package/vendor/seccomp/x64/apply-seccomp +0 -0
- package/vendor/srt-win/arm64/srt-win.exe +0 -0
- package/vendor/srt-win/build.ts +40 -0
- package/vendor/srt-win/x64/srt-win.exe +0 -0
|
@@ -0,0 +1,439 @@
|
|
|
1
|
+
% =============================================================================
|
|
2
|
+
% LaTeX template for Chinese technical publications
|
|
3
|
+
% =============================================================================
|
|
4
|
+
|
|
5
|
+
\documentclass[10pt,openany,oneside]{book}
|
|
6
|
+
|
|
7
|
+
\usepackage[
|
|
8
|
+
paperwidth=176mm,
|
|
9
|
+
paperheight=250mm,
|
|
10
|
+
left=21mm,
|
|
11
|
+
right=21mm,
|
|
12
|
+
top=20mm,
|
|
13
|
+
bottom=24mm,
|
|
14
|
+
headheight=13pt,
|
|
15
|
+
headsep=6mm,
|
|
16
|
+
footskip=10mm
|
|
17
|
+
]{geometry}
|
|
18
|
+
|
|
19
|
+
\usepackage{fontspec}
|
|
20
|
+
\usepackage[UTF8,scheme=plain]{ctex}
|
|
21
|
+
\IfFontExistsTF{TeX Gyre Pagella}{\setmainfont{TeX Gyre Pagella}}{\setmainfont{Palatino}}
|
|
22
|
+
\IfFontExistsTF{TeX Gyre Heros}{\setsansfont{TeX Gyre Heros}}{\setsansfont{Helvetica}}
|
|
23
|
+
\IfFontExistsTF{JetBrains Mono}{\setmonofont{JetBrains Mono}[Scale=MatchLowercase]}{\setmonofont{Menlo}[Scale=MatchLowercase]}
|
|
24
|
+
\IfFontExistsTF{Source Han Serif SC}{\setCJKmainfont{Source Han Serif SC}}{\setCJKmainfont{Songti SC}}
|
|
25
|
+
\IfFontExistsTF{Source Han Sans SC}{\setCJKsansfont{Source Han Sans SC}}{\setCJKsansfont{Heiti SC}}
|
|
26
|
+
\IfFontExistsTF{Sarasa Mono SC}{\setCJKmonofont{Sarasa Mono SC}}{}
|
|
27
|
+
|
|
28
|
+
\usepackage{microtype}
|
|
29
|
+
\usepackage{setspace}
|
|
30
|
+
\setstretch{1.10}
|
|
31
|
+
\setlength{\parindent}{2em}
|
|
32
|
+
\setlength{\parskip}{0pt plus 1pt}
|
|
33
|
+
\emergencystretch=3em
|
|
34
|
+
\tolerance=1800
|
|
35
|
+
\hbadness=6000
|
|
36
|
+
|
|
37
|
+
\usepackage{xcolor}
|
|
38
|
+
\definecolor{BookBlue}{HTML}{1F4E79}
|
|
39
|
+
\definecolor{BookNavy}{HTML}{15324A}
|
|
40
|
+
\definecolor{BookGold}{HTML}{C59B4B}
|
|
41
|
+
\definecolor{CoverRed}{HTML}{BE1E2D}
|
|
42
|
+
\definecolor{CoverBlack}{HTML}{333333}
|
|
43
|
+
\definecolor{BookRed}{HTML}{8B1E1E}
|
|
44
|
+
\definecolor{BookGreen}{HTML}{2D6A4F}
|
|
45
|
+
\definecolor{BookGray}{HTML}{4A5568}
|
|
46
|
+
\definecolor{LightBlue}{HTML}{EEF5FB}
|
|
47
|
+
\definecolor{LightGray}{HTML}{F6F7F9}
|
|
48
|
+
\definecolor{CodeBg}{HTML}{F7F7F3}
|
|
49
|
+
\definecolor{CodeRule}{HTML}{D8DEE9}
|
|
50
|
+
\definecolor{CodeKeyword}{HTML}{4B6584}
|
|
51
|
+
\definecolor{CodeComment}{HTML}{6B7C6A}
|
|
52
|
+
\definecolor{CodeString}{HTML}{8A5A44}
|
|
53
|
+
\definecolor{CodeNumber}{HTML}{6C6F7D}
|
|
54
|
+
\definecolor{TocBlack}{HTML}{111111}
|
|
55
|
+
\definecolor{CoverPaper}{HTML}{FEFEFE}
|
|
56
|
+
\definecolor{AccentSoft}{HTML}{FAF5F0}
|
|
57
|
+
\definecolor{AccentLine}{HTML}{8A1E1E}
|
|
58
|
+
\definecolor{DiagramBox}{HTML}{F7F3EF}
|
|
59
|
+
\definecolor{DiagramBlue}{HTML}{E8EEF5}
|
|
60
|
+
|
|
61
|
+
\usepackage{amsmath,amssymb,mathtools,bm}
|
|
62
|
+
\usepackage{amsthm}
|
|
63
|
+
\renewcommand{\proofname}{证明}
|
|
64
|
+
\usepackage{graphicx}
|
|
65
|
+
\graphicspath{{figures/}}
|
|
66
|
+
\usepackage{tikz}
|
|
67
|
+
\usetikzlibrary{arrows.meta,positioning,shapes.geometric,calc}
|
|
68
|
+
\usepackage{lettrine}
|
|
69
|
+
\usepackage{enumitem}
|
|
70
|
+
\usepackage{booktabs,multirow,tabularx,longtable,array,ragged2e}
|
|
71
|
+
\newcolumntype{Y}{>{\RaggedRight\arraybackslash\hspace{0pt}}X}
|
|
72
|
+
\usepackage{caption,subcaption}
|
|
73
|
+
\captionsetup{font=small,labelfont=bf,labelsep=period}
|
|
74
|
+
\usepackage{xurl}
|
|
75
|
+
\Urlmuskip=0mu plus 2mu
|
|
76
|
+
\usepackage{algorithm}
|
|
77
|
+
\usepackage[noend]{algpseudocode}
|
|
78
|
+
\floatname{algorithm}{算法 / Algorithm}
|
|
79
|
+
\renewcommand{\contentsname}{目\quad 录}
|
|
80
|
+
\renewcommand{\bibname}{参考文献 / Bibliography}
|
|
81
|
+
\renewcommand{\indexname}{索\quad 引 / Index}
|
|
82
|
+
\renewcommand{\figurename}{图}
|
|
83
|
+
\renewcommand{\tablename}{表}
|
|
84
|
+
|
|
85
|
+
\usepackage{listings}
|
|
86
|
+
\lstdefinestyle{bookcode}{
|
|
87
|
+
basicstyle=\scriptsize\ttfamily,
|
|
88
|
+
backgroundcolor=\color{CodeBg},
|
|
89
|
+
frame=lines,
|
|
90
|
+
framerule=0.45pt,
|
|
91
|
+
rulecolor=\color{CodeRule},
|
|
92
|
+
numbers=left,
|
|
93
|
+
numberstyle=\tiny\sffamily\color{BookGray},
|
|
94
|
+
keywordstyle=\color{CodeKeyword}\bfseries,
|
|
95
|
+
commentstyle=\color{CodeComment}\itshape,
|
|
96
|
+
stringstyle=\color{CodeString},
|
|
97
|
+
identifierstyle=\color{CoverBlack},
|
|
98
|
+
breaklines=true,
|
|
99
|
+
breakatwhitespace=false,
|
|
100
|
+
postbreak=\mbox{\textcolor{BookGray}{$\hookrightarrow$}\space},
|
|
101
|
+
columns=fullflexible,
|
|
102
|
+
keepspaces=true,
|
|
103
|
+
showstringspaces=false,
|
|
104
|
+
tabsize=2,
|
|
105
|
+
xleftmargin=2.6em,
|
|
106
|
+
xrightmargin=0.6em,
|
|
107
|
+
framexleftmargin=2.2em,
|
|
108
|
+
framexrightmargin=0.4em,
|
|
109
|
+
framesep=4pt,
|
|
110
|
+
aboveskip=0.75em,
|
|
111
|
+
belowskip=0.75em,
|
|
112
|
+
captionpos=b,
|
|
113
|
+
numbersep=0.8em,
|
|
114
|
+
alsoletter={@:-},
|
|
115
|
+
morekeywords={async,await,import,export,from,const,let,var,function,return,class,interface,type,extends,implements,public,private,protected,readonly,if,else,for,while,switch,case,break,continue,try,catch,finally,throw,new,this,null,undefined,true,false}
|
|
116
|
+
}
|
|
117
|
+
\lstset{style=bookcode}
|
|
118
|
+
\renewcommand{\lstlistingname}{代码清单 / Listing}
|
|
119
|
+
|
|
120
|
+
\usepackage[explicit]{titlesec}
|
|
121
|
+
\usepackage{titletoc}
|
|
122
|
+
\titleformat{\chapter}[display]
|
|
123
|
+
{\normalfont\large\bfseries\color{BookBlue}}
|
|
124
|
+
{\filleft\normalsize 第\thechapter 章}
|
|
125
|
+
{1.2ex}
|
|
126
|
+
{\titlerule[1.2pt]\vspace{1.4ex}\filright #1}
|
|
127
|
+
[\vspace{1.1ex}\titlerule]
|
|
128
|
+
\titlespacing*{\chapter}{0pt}{0pt}{22pt}
|
|
129
|
+
\titleformat{\section}
|
|
130
|
+
{\normalfont\small\bfseries\color{BookBlue}}
|
|
131
|
+
{\thesection}{0.8em}{#1}
|
|
132
|
+
\titleformat{\subsection}
|
|
133
|
+
{\normalfont\small\bfseries\color{BookGray}}
|
|
134
|
+
{\thesubsection}{0.8em}{#1}
|
|
135
|
+
\titleformat{\subsubsection}
|
|
136
|
+
{\normalfont\small\bfseries\color{BookGray}}
|
|
137
|
+
{\thesubsubsection}{0.8em}{#1}
|
|
138
|
+
\setcounter{secnumdepth}{3}
|
|
139
|
+
\setcounter{tocdepth}{2}
|
|
140
|
+
\titlecontents{chapter}
|
|
141
|
+
[0pt]
|
|
142
|
+
{\addvspace{0.65em}\small\bfseries\color{TocBlack}}
|
|
143
|
+
{\textcolor{BookRed}{\contentslabel{2.2em}}}
|
|
144
|
+
{}
|
|
145
|
+
{\titlerule*[0.55em]{.}\textcolor{BookRed}{\contentspage}}
|
|
146
|
+
\titlecontents{section}
|
|
147
|
+
[2.2em]
|
|
148
|
+
{\small\color{TocBlack}}
|
|
149
|
+
{\textcolor{BookRed}{\contentslabel{2.8em}}}
|
|
150
|
+
{}
|
|
151
|
+
{\titlerule*[0.55em]{.}\textcolor{BookRed}{\contentspage}}
|
|
152
|
+
\titlecontents{subsection}
|
|
153
|
+
[5.0em]
|
|
154
|
+
{\footnotesize\color{TocBlack!85}}
|
|
155
|
+
{\textcolor{BookRed!80!black}{\contentslabel{3.2em}}}
|
|
156
|
+
{}
|
|
157
|
+
{\titlerule*[0.55em]{.}\textcolor{BookRed!80!black}{\contentspage}}
|
|
158
|
+
|
|
159
|
+
\usepackage{fancyhdr}
|
|
160
|
+
\pagestyle{fancy}
|
|
161
|
+
\fancyhf{}
|
|
162
|
+
\renewcommand{\chaptermark}[1]{\markboth{#1}{}}
|
|
163
|
+
\renewcommand{\sectionmark}[1]{\markright{#1}}
|
|
164
|
+
\fancyhead[L]{\footnotesize\sffamily\color{BookGray}\nouppercase{\rightmark}}
|
|
165
|
+
\fancyhead[R]{\footnotesize\sffamily\color{BookGray}\thepage}
|
|
166
|
+
\fancyfoot[L]{\scriptsize\sffamily\color{BookGray}\BookTitle}
|
|
167
|
+
\fancyfoot[C]{\scriptsize\sffamily\color{BookGray!75}\BookPublisher}
|
|
168
|
+
\fancyfoot[R]{\scriptsize\sffamily\color{BookGray}\thepage}
|
|
169
|
+
\fancypagestyle{plain}{
|
|
170
|
+
\fancyhf{}
|
|
171
|
+
\fancyfoot[L]{\scriptsize\sffamily\color{BookGray}\BookTitle}
|
|
172
|
+
\fancyfoot[C]{\scriptsize\sffamily\color{BookGray!75}\BookPublisher}
|
|
173
|
+
\fancyfoot[R]{\scriptsize\sffamily\color{BookGray}\thepage}
|
|
174
|
+
\renewcommand{\headrulewidth}{0pt}
|
|
175
|
+
\renewcommand{\footrulewidth}{0.35pt}
|
|
176
|
+
}
|
|
177
|
+
\renewcommand{\headrulewidth}{0.35pt}
|
|
178
|
+
\renewcommand{\footrulewidth}{0.35pt}
|
|
179
|
+
|
|
180
|
+
\usepackage[most]{tcolorbox}
|
|
181
|
+
\tcbuselibrary{breakable,skins,theorems,listings}
|
|
182
|
+
\newtcolorbox{insightbox}[1][]{
|
|
183
|
+
enhanced,breakable,colback=white,colframe=BookRed,
|
|
184
|
+
title={要点 / Insight},fonttitle=\bfseries,coltitle=white,
|
|
185
|
+
colbacktitle=BookRed,#1
|
|
186
|
+
}
|
|
187
|
+
\newtcolorbox{pullquotebox}{
|
|
188
|
+
enhanced,breakable,colback=AccentSoft,colframe=AccentLine,
|
|
189
|
+
borderline west={2.2pt}{0pt}{AccentLine},boxrule=0pt,
|
|
190
|
+
left=4mm,right=4mm,top=2.6mm,bottom=2.6mm,
|
|
191
|
+
fontupper=\itshape\small
|
|
192
|
+
}
|
|
193
|
+
\newtcolorbox{diagramBox}[1][]{
|
|
194
|
+
enhanced,breakable,colback=DiagramBox,colframe=CodeRule,
|
|
195
|
+
boxrule=0.45pt,arc=1.5pt,left=4mm,right=4mm,top=3mm,bottom=3mm,#1
|
|
196
|
+
}
|
|
197
|
+
\newcommand{\fancydropcap}[2]{\lettrine[lines=2,lhang=0.08,nindent=0.18em,findent=0.12em]{\textcolor{BookRed}{#1}}{#2}}
|
|
198
|
+
|
|
199
|
+
\newtcbtheorem[number within=chapter]{definition}{定义 / Definition}{
|
|
200
|
+
enhanced,breakable,colback=LightBlue,colframe=BookBlue,
|
|
201
|
+
coltitle=white,fonttitle=\bfseries,
|
|
202
|
+
attach boxed title to top left={xshift=2mm,yshift=-2mm},
|
|
203
|
+
boxed title style={colback=BookBlue,sharp corners},
|
|
204
|
+
separator sign={.}
|
|
205
|
+
}{def}
|
|
206
|
+
|
|
207
|
+
\newtcbtheorem[number within=chapter]{theorem}{定理 / Theorem}{
|
|
208
|
+
enhanced,breakable,colback=white,colframe=BookBlue,
|
|
209
|
+
coltitle=white,fonttitle=\bfseries,
|
|
210
|
+
attach boxed title to top left={xshift=2mm,yshift=-2mm},
|
|
211
|
+
boxed title style={colback=BookBlue,sharp corners},
|
|
212
|
+
separator sign={.}
|
|
213
|
+
}{thm}
|
|
214
|
+
|
|
215
|
+
\newtcbtheorem[number within=chapter]{example}{例 / Example}{
|
|
216
|
+
enhanced,breakable,colback=LightGray,colframe=BookGray,
|
|
217
|
+
coltitle=white,fonttitle=\bfseries,
|
|
218
|
+
attach boxed title to top left={xshift=2mm,yshift=-2mm},
|
|
219
|
+
boxed title style={colback=BookGray,sharp corners},
|
|
220
|
+
separator sign={.}
|
|
221
|
+
}{ex}
|
|
222
|
+
|
|
223
|
+
\newtcolorbox{warningbox}[1][]{
|
|
224
|
+
enhanced,breakable,colback=BookRed!3,colframe=BookRed,
|
|
225
|
+
title={常见误区 / Common Pitfall},fonttitle=\bfseries,coltitle=white,
|
|
226
|
+
colbacktitle=BookRed,#1
|
|
227
|
+
}
|
|
228
|
+
|
|
229
|
+
\newcounter{exercise}[chapter]
|
|
230
|
+
\renewcommand{\theexercise}{\thechapter.\arabic{exercise}}
|
|
231
|
+
\newenvironment{exercise}[1][]{%
|
|
232
|
+
\refstepcounter{exercise}\par\medskip
|
|
233
|
+
\noindent\textbf{习题 / Exercise~\theexercise\quad #1}\itshape\quad
|
|
234
|
+
}{\par\medskip}
|
|
235
|
+
|
|
236
|
+
\newenvironment{chapterbibliography}{%
|
|
237
|
+
\section*{本章延伸阅读 / Further Reading}\addcontentsline{toc}{section}{本章延伸阅读 / Further Reading}
|
|
238
|
+
\small
|
|
239
|
+
}{\normalsize}
|
|
240
|
+
|
|
241
|
+
\usepackage[numbers,sort&compress]{natbib}
|
|
242
|
+
\bibliographystyle{plainnat}
|
|
243
|
+
\usepackage{makeidx}
|
|
244
|
+
\makeindex
|
|
245
|
+
\usepackage{hyperref}
|
|
246
|
+
\hypersetup{
|
|
247
|
+
unicode=true,
|
|
248
|
+
colorlinks=true,
|
|
249
|
+
linkcolor=TocBlack,
|
|
250
|
+
citecolor=TocBlack,
|
|
251
|
+
urlcolor=BookGray,
|
|
252
|
+
pdftitle={技术系统},
|
|
253
|
+
pdfauthor={作者姓名},
|
|
254
|
+
pdfsubject={中文技术出版读物模板}
|
|
255
|
+
}
|
|
256
|
+
\usepackage[nameinlink,noabbrev]{cleveref}
|
|
257
|
+
|
|
258
|
+
\newcommand{\BookTitle}{技术系统}
|
|
259
|
+
\newcommand{\BookTitleDetail}{算法、设计与工程实践}
|
|
260
|
+
\newcommand{\BookTitleEN}{}
|
|
261
|
+
\newcommand{\BookTitleDetailEN}{}
|
|
262
|
+
\newcommand{\BookSubtitle}{}
|
|
263
|
+
\newcommand{\BookSubtitleEN}{}
|
|
264
|
+
\newcommand{\BookAuthor}{作者姓名}
|
|
265
|
+
\newcommand{\BookEdition}{第 1 版}
|
|
266
|
+
\newcommand{\BookPublisher}{某某出版社}
|
|
267
|
+
\newcommand{\BookYear}{2026}
|
|
268
|
+
|
|
269
|
+
|
|
270
|
+
% Legacy cover retained for reference; not used by the document.
|
|
271
|
+
\newcommand{\maketechbooktitleClassic}{%
|
|
272
|
+
\begin{titlepage}
|
|
273
|
+
\thispagestyle{empty}
|
|
274
|
+
\begingroup
|
|
275
|
+
\newgeometry{left=0mm,right=0mm,top=0mm,bottom=0mm}%
|
|
276
|
+
\begin{tikzpicture}[remember picture,overlay]
|
|
277
|
+
\fill[CoverPaper] (current page.south west) rectangle (current page.north east);
|
|
278
|
+
\IfFileExists{figures/cover-background.png}{%
|
|
279
|
+
\node[inner sep=0pt,opacity=0.22] at (current page.center)
|
|
280
|
+
{\includegraphics[width=176mm,height=250mm]{figures/cover-background.png}};
|
|
281
|
+
}{}
|
|
282
|
+
\fill[CoverRed] (current page.north west) rectangle ([yshift=-6mm]current page.north east);
|
|
283
|
+
\fill[CoverRed] (current page.south west) rectangle ([yshift=6mm]current page.south east);
|
|
284
|
+
\fill[CoverRed!4] ([xshift=12mm,yshift=-12mm]current page.north west) rectangle
|
|
285
|
+
([xshift=38mm,yshift=12mm]current page.south west);
|
|
286
|
+
\draw[CoverBlack,line width=0.55pt]
|
|
287
|
+
([xshift=12mm,yshift=-12mm]current page.north west) rectangle
|
|
288
|
+
([xshift=-12mm,yshift=12mm]current page.south east);
|
|
289
|
+
\draw[CoverRed,line width=1.2pt]
|
|
290
|
+
([xshift=20mm,yshift=-18mm]current page.north west) --
|
|
291
|
+
([xshift=20mm,yshift=18mm]current page.south west);
|
|
292
|
+
\draw[CoverBlack,line width=0.35pt]
|
|
293
|
+
([xshift=23mm,yshift=-18mm]current page.north west) --
|
|
294
|
+
([xshift=23mm,yshift=18mm]current page.south west);
|
|
295
|
+
\IfFileExists{figures/alran-logo.png}{%
|
|
296
|
+
\node[anchor=north east,inner sep=0pt]
|
|
297
|
+
at ([xshift=-20mm,yshift=-24mm]current page.north east)
|
|
298
|
+
{\includegraphics[width=36mm]{figures/alran-logo.png}};
|
|
299
|
+
}{}
|
|
300
|
+
\node[anchor=north west,align=left,text=BookGray,font=\sffamily\bfseries\scriptsize]
|
|
301
|
+
at ([xshift=31mm,yshift=-24mm]current page.north west)
|
|
302
|
+
{HARNESS ENGINEERING SERIES};
|
|
303
|
+
\node[anchor=north west,align=left,text=black,text width=118mm,font=\rmfamily\bfseries\fontsize{34pt}{39pt}\selectfont]
|
|
304
|
+
at ([xshift=31mm,yshift=-58mm]current page.north west)
|
|
305
|
+
{\BookTitle};
|
|
306
|
+
\node[anchor=north west,align=left,text=CoverBlack,text width=118mm,font=\rmfamily\fontsize{18pt}{25pt}\selectfont]
|
|
307
|
+
at ([xshift=31mm,yshift=-93mm]current page.north west)
|
|
308
|
+
{\BookTitleDetail};
|
|
309
|
+
\draw[CoverRed,line width=1pt]
|
|
310
|
+
([xshift=31mm,yshift=-150mm]current page.north west) --
|
|
311
|
+
([xshift=139mm,yshift=-150mm]current page.north west);
|
|
312
|
+
\draw[CoverBlack,line width=0.35pt]
|
|
313
|
+
([xshift=31mm,yshift=43mm]current page.south west) --
|
|
314
|
+
([xshift=-16mm,yshift=43mm]current page.south east);
|
|
315
|
+
\draw[CoverRed,line width=0.8pt]
|
|
316
|
+
([xshift=31mm,yshift=40mm]current page.south west) --
|
|
317
|
+
([xshift=-16mm,yshift=40mm]current page.south east);
|
|
318
|
+
\node[anchor=south,align=center,text=CoverBlack,font=\sffamily\small]
|
|
319
|
+
at ([yshift=26mm]current page.south)
|
|
320
|
+
{\BookAuthor};
|
|
321
|
+
\node[anchor=south,align=center,text=BookGray,font=\sffamily\scriptsize]
|
|
322
|
+
at ([yshift=18mm]current page.south)
|
|
323
|
+
{\BookYear};
|
|
324
|
+
\end{tikzpicture}%
|
|
325
|
+
\null\clearpage
|
|
326
|
+
\restoregeometry
|
|
327
|
+
\endgroup
|
|
328
|
+
\end{titlepage}
|
|
329
|
+
}
|
|
330
|
+
|
|
331
|
+
\newcommand{\drawpangolincover}{%
|
|
332
|
+
\begin{scope}[x=1mm,y=1mm,shift={(88mm,-151mm)},scale=0.9]
|
|
333
|
+
\draw[CoverBlack!68,line width=0.55pt]
|
|
334
|
+
(-36,5) .. controls (-26,25) and (5,31) .. (26,16)
|
|
335
|
+
.. controls (43,4) and (46,-18) .. (27,-26)
|
|
336
|
+
.. controls (4,-36) and (-25,-25) .. (-33,-9)
|
|
337
|
+
.. controls (-38,1) and (-38,1) .. (-36,5);
|
|
338
|
+
\draw[CoverBlack!54,line width=0.45pt]
|
|
339
|
+
(-22,17) .. controls (-11,23) and (4,23) .. (18,14);
|
|
340
|
+
\foreach \x/\y/\r in {-24/9/9,-10/14/10,5/13/10,18/6/9,27/-7/8,15/-18/9,-3/-22/9,-19/-15/8}{%
|
|
341
|
+
\draw[CoverBlack!32,line width=0.35pt] (\x,\y) ellipse (\r mm and 4.2mm);
|
|
342
|
+
}
|
|
343
|
+
\draw[CoverBlack!62,line width=0.5pt]
|
|
344
|
+
(23,13) .. controls (39,22) and (54,14) .. (61,1);
|
|
345
|
+
\fill[CoverBlack!62] (57,3) circle (0.8mm);
|
|
346
|
+
\draw[CoverBlack!55,line width=0.45pt]
|
|
347
|
+
(-32,-8) .. controls (-53,-13) and (-56,-34) .. (-39,-42)
|
|
348
|
+
.. controls (-27,-48) and (-11,-43) .. (-5,-31);
|
|
349
|
+
\draw[CoverBlack!48,line width=0.45pt] (-8,-27) -- (-12,-39);
|
|
350
|
+
\draw[CoverBlack!48,line width=0.45pt] (12,-27) -- (9,-39);
|
|
351
|
+
\draw[CoverBlack!48,line width=0.45pt] (30,-20) -- (35,-32);
|
|
352
|
+
\end{scope}%
|
|
353
|
+
}
|
|
354
|
+
|
|
355
|
+
\newcommand{\maketechbooktitle}{%
|
|
356
|
+
\begin{titlepage}
|
|
357
|
+
\thispagestyle{empty}
|
|
358
|
+
\begingroup
|
|
359
|
+
\newgeometry{left=0mm,right=0mm,top=0mm,bottom=0mm}%
|
|
360
|
+
\begin{tikzpicture}[remember picture,overlay]
|
|
361
|
+
\fill[CoverPaper] (current page.south west) rectangle (current page.north east);
|
|
362
|
+
\fill[CoverRed] (current page.north west) rectangle ([yshift=-7mm]current page.north east);
|
|
363
|
+
\fill[CoverRed] (current page.south west) rectangle ([yshift=7mm]current page.south east);
|
|
364
|
+
\draw[CoverBlack,line width=0.6pt]
|
|
365
|
+
([xshift=12mm,yshift=-12mm]current page.north west) rectangle
|
|
366
|
+
([xshift=-12mm,yshift=12mm]current page.south east);
|
|
367
|
+
\draw[CoverRed,line width=0.8pt]
|
|
368
|
+
([xshift=14mm,yshift=-15mm]current page.north west) --
|
|
369
|
+
([xshift=-14mm,yshift=-15mm]current page.north east);
|
|
370
|
+
\draw[CoverBlack,line width=0.4pt]
|
|
371
|
+
([xshift=14mm,yshift=-17mm]current page.north west) --
|
|
372
|
+
([xshift=-14mm,yshift=-17mm]current page.north east);
|
|
373
|
+
\node[anchor=north west,align=left,text=BookGray,font=\sffamily\scriptsize]
|
|
374
|
+
at ([xshift=16mm,yshift=-20mm]current page.north west)
|
|
375
|
+
{HARNESS ENGINEERING SERIES};
|
|
376
|
+
\node[anchor=north east,align=right,text=BookGray,font=\sffamily\bfseries\scriptsize]
|
|
377
|
+
at ([xshift=-16mm,yshift=-20mm]current page.north east)
|
|
378
|
+
{\MakeUppercase{\BookPublisher}};
|
|
379
|
+
\node[anchor=north west,align=left,text=black,text width=142mm,font=\rmfamily\fontsize{42pt}{48pt}\selectfont]
|
|
380
|
+
at ([xshift=16mm,yshift=-42mm]current page.north west)
|
|
381
|
+
{\BookTitle};
|
|
382
|
+
\node[anchor=north west,align=left,text=CoverBlack,text width=142mm,font=\rmfamily\fontsize{19pt}{27pt}\selectfont]
|
|
383
|
+
at ([xshift=16mm,yshift=-76mm]current page.north west)
|
|
384
|
+
{\BookTitleDetail};
|
|
385
|
+
\drawpangolincover
|
|
386
|
+
\draw[CoverBlack,line width=0.4pt]
|
|
387
|
+
([xshift=14mm,yshift=44mm]current page.south west) --
|
|
388
|
+
([xshift=-14mm,yshift=44mm]current page.south east);
|
|
389
|
+
\draw[CoverRed,line width=0.8pt]
|
|
390
|
+
([xshift=14mm,yshift=42mm]current page.south west) --
|
|
391
|
+
([xshift=-14mm,yshift=42mm]current page.south east);
|
|
392
|
+
\node[anchor=south west,align=left,text=CoverBlack,font=\sffamily\small]
|
|
393
|
+
at ([xshift=16mm,yshift=29mm]current page.south west)
|
|
394
|
+
{\BookAuthor};
|
|
395
|
+
\node[anchor=south west,align=left,text=BookGray,font=\sffamily\scriptsize]
|
|
396
|
+
at ([xshift=16mm,yshift=21mm]current page.south west)
|
|
397
|
+
{Cover illustration placeholder};
|
|
398
|
+
\node[anchor=south east,align=right,text=BookGray,font=\sffamily\scriptsize]
|
|
399
|
+
at ([xshift=-16mm,yshift=16mm]current page.south east)
|
|
400
|
+
{\MakeUppercase{\BookPublisher}\\\BookYear};
|
|
401
|
+
\end{tikzpicture}%
|
|
402
|
+
\null\clearpage
|
|
403
|
+
\restoregeometry
|
|
404
|
+
\endgroup
|
|
405
|
+
\end{titlepage}
|
|
406
|
+
}
|
|
407
|
+
|
|
408
|
+
|
|
409
|
+
|
|
410
|
+
\begin{document}
|
|
411
|
+
\frontmatter
|
|
412
|
+
\maketechbooktitle
|
|
413
|
+
|
|
414
|
+
\chapter*{前言}
|
|
415
|
+
\addcontentsline{toc}{chapter}{前言}
|
|
416
|
+
|
|
417
|
+
这里写入本书前言。建议说明本书的写作动机、适合读者、阅读路径,以及章节组织方式。前言不必解释模板本身,而应面向真实读者介绍这本书为什么值得阅读。
|
|
418
|
+
|
|
419
|
+
\phantomsection
|
|
420
|
+
\pdfbookmark[0]{目录}{toc}
|
|
421
|
+
\tableofcontents
|
|
422
|
+
\clearpage
|
|
423
|
+
|
|
424
|
+
\mainmatter
|
|
425
|
+
\input{chapters/chapter01}
|
|
426
|
+
\input{chapters/chapter02}
|
|
427
|
+
\input{chapters/chapter03}
|
|
428
|
+
|
|
429
|
+
\appendix
|
|
430
|
+
\input{backmatter/appendix}
|
|
431
|
+
|
|
432
|
+
\backmatter
|
|
433
|
+
\phantomsection
|
|
434
|
+
\addcontentsline{toc}{chapter}{参考文献 / Bibliography}
|
|
435
|
+
\bibliography{references}
|
|
436
|
+
\phantomsection
|
|
437
|
+
\addcontentsline{toc}{chapter}{索引 / Index}
|
|
438
|
+
\printindex
|
|
439
|
+
\end{document}
|
|
@@ -0,0 +1,148 @@
|
|
|
1
|
+
# multi-article-aggregator
|
|
2
|
+
|
|
3
|
+
> Distilled from reference examples m16 (source blog 11 posts -> 70-page
|
|
4
|
+
> PDF). **Cowork multi-pass pipeline**: fetch -> clean DOM -> per-article
|
|
5
|
+
> render -> 2-pass TOC -> merge. This route is fundamentally a pipeline,
|
|
6
|
+
> not a single HTML file.
|
|
7
|
+
|
|
8
|
+
## 1. When to use
|
|
9
|
+
|
|
10
|
+
- **EN keywords**: aggregate articles, blog digest, multi-post
|
|
11
|
+
compilation, monthly digest, TOC + multi-doc, news roundup,
|
|
12
|
+
blog -> PDF
|
|
13
|
+
- **CN keywords**: 文章合集、blog 聚合、多篇汇总、月度回顾、资讯整理、博客打包
|
|
14
|
+
- **Sample user asks**:
|
|
15
|
+
- "Compile these source blog posts from January 2026 into a PDF;
|
|
16
|
+
needs a TOC that jumps to each post; one post per page."
|
|
17
|
+
- "Aggregate 11 Medium articles into a single PDF with clickable TOC
|
|
18
|
+
and category grouping."
|
|
19
|
+
|
|
20
|
+
## 2. Pipeline
|
|
21
|
+
|
|
22
|
+
**Cowork multi-pass pipeline** (not a single HTML, no single skeleton).
|
|
23
|
+
|
|
24
|
+
| Stage | Tool | Purpose |
|
|
25
|
+
|---|---|---|
|
|
26
|
+
| 1. Fetch | Playwright | Pull each source page (`networkidle` + 1.5 s settle for lazy loads). |
|
|
27
|
+
| 2. Per-article DOM cleanup | Playwright `page.evaluate` | Inject hide CSS to strip nav / footer / cookie / related-posts / share / sticky elements. |
|
|
28
|
+
| 3. Per-article render | Playwright `page.pdf()` | One PDF per article (do NOT merge HTML). |
|
|
29
|
+
| 4. Collect metadata | pdfinfo | Page count per article -> page-offset map for the TOC. |
|
|
30
|
+
| 5. **TOC pass 1** | reportlab canvas | Render the TOC with mock page numbers; measure its own page count. |
|
|
31
|
+
| 6. **Merge pass 1** | pypdf | Concatenate `[TOC + article 1..N]`; recompute the true start page of each article. |
|
|
32
|
+
| 7. **TOC pass 2** | reportlab canvas | Re-render the TOC with the real page numbers. |
|
|
33
|
+
| 8. **Merge pass 2** | pypdf | Final PDF + outline bookmarks + `/Link` annotations. |
|
|
34
|
+
| 9. (Optional) trim trailing blanks | pypdf | Detect per-article trailing pages that are >= 90% blank; drop them and re-balance offsets. |
|
|
35
|
+
|
|
36
|
+
Why cowork instead of merging HTML in one shot: 11 articles use
|
|
37
|
+
different Webflow templates with conflicting CSS cascades. Rendering
|
|
38
|
+
each article in isolation preserves its font hierarchy without
|
|
39
|
+
cross-contamination.
|
|
40
|
+
|
|
41
|
+
## 3. Document shape
|
|
42
|
+
|
|
43
|
+
- **Pages**: ~70 (5-8 per article x 11 + 1-2 TOC).
|
|
44
|
+
- **Structure**: cover (optional) -> TOC (dot leaders + page numbers +
|
|
45
|
+
category grouping) -> 11 articles (each with `page-break-before`) ->
|
|
46
|
+
colophon (optional).
|
|
47
|
+
- **Page size**: A4 portrait.
|
|
48
|
+
- **Per-article structure**: H1 title -> metadata (date / author /
|
|
49
|
+
category / reading time) -> body (text + code + images) -> no nav /
|
|
50
|
+
related / share.
|
|
51
|
+
|
|
52
|
+
## 4. Visual params
|
|
53
|
+
|
|
54
|
+
- **Palette**: neutral / inherit from source (the source uses dark + serif).
|
|
55
|
+
- **Typography**: pull source `@font-face` woff2 -> convert to TTF ->
|
|
56
|
+
inline as `data:` URIs; `font-family` cascade with fallbacks;
|
|
57
|
+
**critical: `await document.fonts.ready` before rendering.**
|
|
58
|
+
- **Code blocks**: `font-family: Menlo, Consolas, monospace`;
|
|
59
|
+
`background: #f5f5f5`; `padding: 12px`; `whitespace: pre-wrap`.
|
|
60
|
+
- **TOC**: category-grouped (bold underlined subhead -> numbered item ->
|
|
61
|
+
dot leaders -> right-aligned date -> right-aligned page number;
|
|
62
|
+
multi-line titles wrap automatically).
|
|
63
|
+
- **Per-article H1**: 28pt; H2 20pt; H3 16pt.
|
|
64
|
+
- **Images**: `max-width: 100%; height: auto`. Wait for `img.complete`
|
|
65
|
+
before rendering.
|
|
66
|
+
|
|
67
|
+
## 5. Skeleton
|
|
68
|
+
|
|
69
|
+
See [`pipeline.md`](pipeline.md) (cowork pipeline pseudocode + per-article
|
|
70
|
+
HTML stub + TOC rendering spec).
|
|
71
|
+
|
|
72
|
+
**Quick start**:
|
|
73
|
+
|
|
74
|
+
```bash
|
|
75
|
+
# This route has no "copy a single skeleton" path — you must walk the pipeline.
|
|
76
|
+
# 1. Prepare posts_list.json: [{url, title, date, author, category, slug}, ...]
|
|
77
|
+
# 2. Run fetch + clean DOM + per-article render (python + playwright).
|
|
78
|
+
# 3. Render TOC with reportlab, merge with pypdf.
|
|
79
|
+
# Full details in pipeline.md.
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
## 6. Pitfalls (from m16 production)
|
|
83
|
+
|
|
84
|
+
- **Web-font load race**: without `await document.fonts.ready` Chromium
|
|
85
|
+
substitutes system fonts (Times / Helvetica) and breaks the visual.
|
|
86
|
+
**Always await custom fonts.**
|
|
87
|
+
- **Lazy-loaded images dropped**: when Playwright prints, late-loading
|
|
88
|
+
images get clipped. **Scroll to the bottom** before rendering, then
|
|
89
|
+
`wait_for_timeout(1500-2000)` so all images settle.
|
|
90
|
+
- **CSS cascade pollution**: Webflow uses `.is-cc` / `[class*='icon']`
|
|
91
|
+
in deeply nested layouts; broad selectors like `[class*='form_']`
|
|
92
|
+
accidentally hit `.hero_blog_post_details_form` and collapse the
|
|
93
|
+
metadata block. **Use an explicit KEEP whitelist** + force
|
|
94
|
+
`display: flex` for the wanted nodes.
|
|
95
|
+
- **Per-article trailing blanks**: a single article often produces 1-2
|
|
96
|
+
trailing blank pages (CSS height 100vh / placeholders). **Strip them
|
|
97
|
+
before merging**, or the total page count balloons and TOC numbers
|
|
98
|
+
drift.
|
|
99
|
+
- **Metadata icons run wild**: Webflow icons without size constraints
|
|
100
|
+
occupy 60% of the page width. Inject early CSS:
|
|
101
|
+
`svg, [class*='icon'] { max-width: 64px; max-height: 64px; }`.
|
|
102
|
+
- **TOC pagination**: 11 entries can overflow one page. reportlab
|
|
103
|
+
canvas does not paginate automatically — measure cumulative height,
|
|
104
|
+
call `c.showPage()` once you exceed `SAFE_PAGE_H`.
|
|
105
|
+
- **PDF outline 0-based vs 1-based**: outline page numbers are 0-based
|
|
106
|
+
(page 0 = TOC), but the displayed numbers are 1-based. Off-by-one
|
|
107
|
+
errors send bookmarks to the wrong page. **Verify the `/Dest` indirect
|
|
108
|
+
reference with both `pdfinfo` and pypdf outline.**
|
|
109
|
+
- **Order / grouping**: defaults to chronological; users may want
|
|
110
|
+
reverse or custom grouping. **Parameterise**:
|
|
111
|
+
`--order=chrono|reverse`, `--group-by=category|date`.
|
|
112
|
+
|
|
113
|
+
## 7. Generalization
|
|
114
|
+
|
|
115
|
+
**Required**:
|
|
116
|
+
- `COMPILATION_TITLE`
|
|
117
|
+
- `SOURCE_WEBFONT_FAMILY` (auto-discover from source `@font-face`, or
|
|
118
|
+
`getComputedStyle(body).fontFamily`).
|
|
119
|
+
- `posts_list.json` (`[{url, title, date, author, slug, category}]`).
|
|
120
|
+
- `N_ARTICLES` (5-50 typical).
|
|
121
|
+
|
|
122
|
+
**Optional**:
|
|
123
|
+
- Per-article excerpt (TOC sub-line).
|
|
124
|
+
- Category / tag badges.
|
|
125
|
+
- Author avatars (if the source provides them).
|
|
126
|
+
- Custom cover.
|
|
127
|
+
|
|
128
|
+
**Structural invariants**:
|
|
129
|
+
- TOC + dot leaders + page numbers (never inline).
|
|
130
|
+
- `page-break-before: always` per article.
|
|
131
|
+
- `img { max-width: 100%; height: auto; }` to prevent overflow.
|
|
132
|
+
- Code blocks in monospace + light-gray background.
|
|
133
|
+
- No nav / footer / related elements.
|
|
134
|
+
|
|
135
|
+
**Swappable**:
|
|
136
|
+
- Source site (blog -> medium.com / Substack / dev.to / WordPress
|
|
137
|
+
/ any stable HTML).
|
|
138
|
+
- Article count (5-50; tune the TOC paging threshold).
|
|
139
|
+
- Language (EN / CN / mixed; reportlab + pypdf are encoding-agnostic).
|
|
140
|
+
- Margins (default 16 mm; pass via the `page.pdf()` margin dict).
|
|
141
|
+
|
|
142
|
+
**Diversify every run.** The aggregator should inherit the **source
|
|
143
|
+
site's webfont** (auto-detect via `getComputedStyle`) — do not default
|
|
144
|
+
to a stock sans-serif. Re-pick the cover treatment, accent color, and
|
|
145
|
+
TOC layout based on the source site's identity (Substack newsletter
|
|
146
|
+
warmth vs dev.to monospace vs corporate blog formality). Two digests
|
|
147
|
+
from two different blogs should read as separate publications, not
|
|
148
|
+
both wearing the m18 default.
|