Manuscript Placeholder Collector
Manuscript Placeholder Collector gathers drafting reminders into one private revision checklist.
The problem it solves
Manuscript Placeholder Collector Writers leave themselves notes while drafting: [RESEARCH THIS], TODO: fix the argument, <insert description, TK, or a row of question marks. Manuscript Placeholder Collector gathers those scattered reminders into one private revision checklist.
Who Manuscript Placeholder Collector is for
- People who need a small, purpose-built utility instead of a broad platform.
- Users working with writing, manuscript, DOCX who want the documented v1.2.0 behavior.
- People who prefer an open-source release with visible limitations, source, and license terms.
Intended result
Manuscript Placeholder Collector gathers drafting reminders into one private revision checklist.
This summary is reconciled from the current catalog and repository documentation.
Features in v1.2.0
Capabilities below come from the current project README and release documentation.
Writers leave themselves notes while drafting: [RESEARCH THIS], TODO: fix the argument, <insert description, TK, or a row of question marks. Manuscript Placeholder Collector gathers those scattered reminders into one private revision checklist.
Verified examples
Screenshots are shown only when the current README references a local source image. Otherwise, repository example files are linked directly.
Verified release evidence
This project does not currently publish a screenshot or dedicated example folder. The current README, tests, changelog, tagged release, and source repository remain the verified examples of its behavior.
Platforms and implementation
The public release claims only the cataloged platforms and technologies.
Supported platforms
- Windows
- macOS
- Linux
Built with
- Python
- python-docx
What changed in v1.2.0
Repair formatting and add opt-in DOCX table/comment/footnote scanning with source locations and a private resolution ledger with baseline comparisons.
manuscript-placeholders draft.docx --docx-tables --docx-comments --docx-footnotes --format json --output review.json --ledger-output resolution.jsonDOCX body paragraphs remain the default. Optional structures identify XML part, table/row/cell/paragraph or comment/footnote IDs, plus character offsets within extracted paragraph text. Text files retain line positions. Reports explicitly list enabled/skipped optional structures; headers, footers, endnotes, text boxes and legacy DOC converter behavior are not expanded. --ledger reads a version 1 items object keyed by finding fingerprint with open/resolved/ignored status and a private note. --ledger-output writes a new ledger preserving old entries. --baseline compares a previous fingerprinted JSON report. Fingerprints include source location, marker offset and marker text, so moved text can appear new. A missing marker does not prove an issue was resolved. Source manuscripts and existing outputs remain untouched.
Changelog
Release notes from the canonical v1.2.0 source tag.
- Repair formatting and add opt-in DOCX table/comment/footnote scanning with source locations and a private resolution ledger with baseline comparisons.
- Added regression coverage for the audited behavior and invalid inputs.
- Added section-aware EPUB ingestion in publication spine order.
- Added legacy
.docingestion through locally installedantiword,catdoc, or LibreOffice readers. - Expanded format validation, tests, package metadata, privacy guidance, and usage documentation.
- Added local placeholder collection for text, Markdown, and DOCX manuscripts.
- Added section-aware research, name, revision, insertion, uncertainty, and bracket-note categories.
- Added custom regular expressions and text, Markdown, JSON, and static HTML reports.
Quick start
The shortest documented path into the current release.
Before running these source commands, download the v1.2.0 source archive, extract it, and open a terminal in the extracted project folder containing README.md. Follow the tagged README for required runtimes and any platform-specific setup.
Python 3.10 or newer is required.
python -m venv .venv
python -m pip install -e .Current limitations
These boundaries are part of the product and prevent the page from implying unverified capability.
- Legacy
.docsupport depends onantiword,catdoc, or LibreOffice being installed locally and available onPATH; modern.docxdoes not need that extra tool. - Word tables, headers, footnotes, comments, and tracked changes are not scanned.
- Natural-language notes that do not match a marker require a custom regular expression.
- The collector does not rewrite the original manuscript or decide when an item is resolved.
Privacy and licensing
Review the actual data boundary before using a tool with sensitive inputs.
Privacy and safety
The manuscript stays on the computer. No text is uploaded, and no AI or external API is used. Reports necessarily contain the matched note and nearby manuscript context; treat exported reports with the same privacy as the manuscript.
License and release
Manuscript Placeholder Collector is published under MIT. The current cataloged release is v1.2.0, published 2026-09-07.
Related projects
Related projects are selected deterministically from shared catalog tags, category, and implementation technologies—not popularity or paid placement.
Manuscript Placeholder Collector v1.2.0
Use the tagged release for downloads and release notes. Use the repository for source, issues, contribution guidance, security reporting, and complete documentation.
Page source: current Forge catalog plus README and CHANGELOG from the canonical GitHub release tag. Fingerprint: b8b3decd9d196ddf.