aboutsummaryrefslogtreecommitdiff
path: root/docs/USAGE.md
diff options
context:
space:
mode:
authorAgando <roduccomm@gmail.com>2026-11-09 15:36:11 +0100
committerAgando <roduccomm@gmail.com>2026-11-09 15:36:11 +0100
commitfa527774c2dfec90920d8b1befbefc3ac8241f22 (patch)
tree3fe1030aa75bd43abeea4541eff85f289371a77b /docs/USAGE.md
parent896ae37a4297f703bc4fa3fe155c8a35d49a326d (diff)
fix(products): ship the reviewed 1.0.1 builds — the 1.0.0 pdf2txt never ranHEADv1.0.1main
A review of all three products in Chromium found defects that only execution exposes. pdf2txt 1.0.0 DID NOT RUN. Both the packaged file and the live demo contained a duplicated const declaration inside fetchModels, so the inline script threw a SyntaxError at parse time and no handler was ever bound: no extraction, no translation, no config. Proven by extracting both inline scripts from the committed file and from spaces/chatstudio/pdf2txt.html and running node --check (SyntaxError: Identifier 'config' has already been declared). The two published versions of this product were dead on arrival. pdf2txt 1.0.1 also stops writing the API key and the whole extracted document to localStorage (sessionStorage for the key, nothing for the text), keeps paragraphs (hasEOL), splits chunks on word boundaries, reports a non-JSON 200 or a missing response field instead of writing "undefined" into the editor, re-enables Translate after a run, resets stopRequested, stops a workflow on a failed step, warns on a PDF with no text layer, recognises .PDF, fixes an unterminated mobile media query, stops the Fullscreen button covering line 1, and makes the drop zone and all 39 controls reachable and named. shiftplanner 1.0.1 fixes seven demonstrated defects: the settings modal recursed until the stack overflowed, "+ Worker" prefilled the last edited worker id and overwrote that person, date maths was off by one west of UTC (local-noon Date formatted with toISOString), same-day and overnight shift overlaps were never flagged, the generator sliders never reached state.settings, CSV export could execute a formula and broke on a quote, and the header never wrapped (390 px viewport gave a 1139 px document). Plus four data-integrity guards: unparseable saved plans are copied to a recovery key instead of silently overwritten, wrong-typed fields are normalised, unknown top-level fields survive a save, and a storage event syncs another tab. chat-widget 1.0.1 closes a critical attribute-injection XSS. escapeHtml() round-tripped through textContent, which does not escape a double quote, so a reply containing https://x.test/"onclick="alert(1)// produced a real <a onclick=...> and fired alert(1) when clicked. Proven both ways: the 1.0.0 file fired a dialog, the fixed one renders only href/target/rel and stays silent. The launcher also covered the Send button at 390 px, so the widget could not be used on a phone at all. Also in this commit: - Landing pages and demos are generated (build-product-pages.py). The "Try the demo" button used to point at spaces/chatstudio/pdf2txt.html (the dead copy above) and at a v2.1 shiftplanner with no AI panel: a demo that was a different build than the ZIP. Demos are now built into /demos/<slug>/ from products/<slug>/, with the ../vendor/ prefix rewritten, and the publish wrapper regenerates them before every publish. - publish-public-repo.py refuses to publish a subtree with uncommitted changes. It reads git, so it silently republished the old tip while rc was 0 for every slug.
Diffstat (limited to 'docs/USAGE.md')
-rw-r--r--docs/USAGE.md2
1 files changed, 1 insertions, 1 deletions
diff --git a/docs/USAGE.md b/docs/USAGE.md
index df194b6..35c77be 100644
--- a/docs/USAGE.md
+++ b/docs/USAGE.md
@@ -90,7 +90,7 @@ Things worth knowing before you translate:
- The package ships with **API Source** set to `Proxied (/ollama)` and **Translation
Model** set to `glm-5.3-flash:cloud`. Both are cloud settings. For an offline run you
must change them as in steps 3 and 4.
-- Long documents are sent in 1,500-character pieces, one after another, so a big book
+- Long documents are sent in pieces (1,500 characters, or 2,500 with a cloud model), one after another, so a big book
takes a while. Use the pause/stop buttons if needed.
- The **Clean** and **Validate** steps also use a model (`llama3.2:latest` by default). If
you only want a translation, choose the workflow `Translate Only`.