FOLIOMEND / FIELD GUIDE / 1.0.0
This guide accompanies an original fictional practice case, “Measuring a Rain Barrel.” The goal is a corrected index with a recorded human decision for every old locator.
Install Python 3 and desktop Chrome if needed. Extract the buyer ZIP completely. Open a terminal in the extracted folder and run python3 serve.py. On systems where Python is named python, use that command instead. Open http://127.0.0.1:8765/app/. Tested on Linux; other systems have not been accepted. No npm or network download is needed at runtime. Opening the app HTML directly will not work.
Choose Load practice case. The old proof has physical pages 1–3 with printed labels i, 12, 13. The new proof has physical pages 1–6 labeled i, 13, 14, 15, 16, 17. Embedded labels are absent in these sample PDFs; the supplied calibration is explicit.
Inspect pages with the old/new page selectors. Enter one unique printed label per physical page separated by semicolons. Map Heading, Locator and Cross-reference columns. Extra columns stay untouched in canonical output. Preview the table, then choose Confirm numbering & begin review. Editing numbering or mapping immediately invalidates approvals. Confirmation clears approvals.
Choose an item in the queue. Select its supporting text in the old extracted-text panel and click Use selected passage, or type/paste it into the passage field. This matters when a heading differs from body wording: winter storage is supported by “Drain and disconnect…” rather than those exact heading words. Click Find possible destinations to rank pages by word overlap. Click a candidate to view it. A score is not proof of semantic correctness; no result is approved automatically.
Type destination labels separated by semicolons, record a reason, and approve this locator. Each old page in a range appears separately. You may assign multiple destinations to one old locator, for example 14;15. Never infer a continuous range from endpoints. To remove a locator, provide the old passage and a reason, then use Remove this locator. The source row remains with an empty locator when all its locators are removed.
| Entry | Old | Approved new |
|---|---|---|
| foreword | i | i |
| inlet screens | 12 | 14 |
| winter storage | 12 | 15 |
| overflow | 13 | 16 |
| maintenance | 12–13 | 14;16 |
| brass taps | 13 | empty — removed |
| tap care | cross-reference | clear brass taps reference |
For maintenance, select the screen passage for old 12 and the overflow passage for old 13. Approve them separately as 14 and 16. No reference to 15 is implied. Approve foreword even though unchanged.
After all locator decisions, review each cross-reference. In the sample clear the “brass taps” target from tap care, explain its removal and approve the cross-reference. Any subsequent locator decision resets cross-reference approvals. The app requires explicit review; it does not understand arbitrary publisher cross-reference grammar.
Once all items are resolved, download the corrected CSV, spreadsheet-safe CSV, readable HTML, plain text and review ledger using their separate buttons. These are individual files, not an output ZIP. Canonical CSV preserves non-locator strings, original columns and rows (apart from explicit cross-reference edits); original byte-level quoting is not preserved. The safe copy prefixes formula-like cells with an apostrophe and is deliberately different. HTML/TXT display extra columns in original order, separated by dashes; they are not publisher-specific hierarchy/typesetting.
Open the HTML in Chrome to inspect and print if desired. Open canonical CSV in a text/CSV-aware editor; use the safe copy for spreadsheet viewing. Never treat spreadsheet formula protection as a substitute for reviewing your downstream application's behavior. The ledger records passages, destinations and reasons. Source PDFs do not appear in these exports.
Save project downloads a private JSON file containing original proof bytes, original index, calibration, mapping and decisions. Reopen it through Reopen project. Confirm numbering; previous locator decisions appear as editable drafts but must be reapproved. Recheck cross-references. This conservative reapproval also applies to unchanged locators. No autosave or undo history exists. Save before loading another job. Files on disk are never overwritten automatically.
Select two unencrypted extractable-text PDFs and a UTF-8 CSV or TSV. Then choose Open my files. Use a header row with unique nonblank column names. Each row needs a heading. A locator may be blank for a cross-reference-only row. Supported locator examples: 12, i, 12–15, 12;19. Ranges expand to individual pages. Unsupported examples: abbreviated 123–7, page suffixes, volume prefixes, styled meaning, uppercase Roman labels, mixed inline “see” text. Put cross-references in their own column.
CSV supports commas, doubled quotes and embedded newlines in quoted fields. TSV is simple tab-separated text: tabs/newlines inside fields are not supported. Canonical Roman labels are i–xxx; Arabic labels 1–9999. Every imported old locator and approved destination must exist in the confirmed numbering. Duplicate printed labels are unsupported.
The launcher binds only to 127.0.0.1. It serves static files and accepts no upload endpoint; selected proofs are processed in your browser. There are no accounts, external scripts or analytics. Do not share private project JSON because it embeds proofs. Close the browser tab, stop the server with Ctrl+C, and delete the extracted folder and unwanted downloads to uninstall. Browser download history is managed by your browser.
No native Cindex/SKY integration, OCR, automatic semantic guarantee or measured time-saving claim is provided. Native self-tests are not independent release acceptance.