Support
Something not working, or a result you don’t understand? The answers below cover most things. If not, email contact+verbatim@victorshammas.com. I read every message.
- Getting started
- What the verdicts mean
- Citations and file names
- PDFs, EPUBs and scanned pages
- Zotero
- Fixing quotations
- The free version
- Contact
Getting started
How do I check a manuscript?
Open Verbatim, choose your manuscript, add the folder (or folders) with your sources, and click Check Quotations. You can also drag files and folders onto the window. The first time, Verbatim reads every source, which takes a few seconds for a typical folder; it keeps what it read, so later checks are quick.
To see what it does first, choose Help › Try the Sample: a short essay quoting Mill, Du Bois and Wollstonecraft, with a few planted mistakes.
Which files can I use?
Manuscript: Word (.docx), Markdown, plain text, RTF, OpenDocument (.odt), .doc or HTML. Footnotes and endnotes are read from Word and Markdown files.
Sources: PDFs, EPUBs, web pages saved as HTML, plain text and Word files, or the attachments in a Zotero library. A folder can hold many works you didn’t cite: Verbatim matches each citation to its file and searches the rest only if a passage isn’t in the cited work.
LaTeX manuscripts aren’t read yet. Export to Word or Markdown first, for example with pandoc.
What counts as a quotation?
A passage in quotation marks (double, or single in British-style manuscripts) of four or more words, and any block quotation (a Word “Quote” or “Block Text” style, an indented paragraph, or a Markdown > line). Shorter quoted phrases are usually scare quotes, terms or titles and are skipped; you can change the minimum in Verbatim › Settings.
It found no quotations.
Check that the quotations are in quotation marks or set as block quotations, and that the manuscript isn’t a PDF (Verbatim reads manuscripts as Word, Markdown or text files). Quotations after a heading such as “References” or “Bibliography” aren’t searched.
What the verdicts mean
- Exact. Word for word, apart from typography: curly or straight quotes, dashes, ligatures, line breaks.
- Acceptable changes. Only changes conventions allow: omissions marked with an ellipsis, changes in [brackets], a capital letter changed at the start, and end punctuation.
- Minor differences. Punctuation, capitalisation, spelling or spacing differs inside the quotation.
- Altered. Words added, dropped or changed. A dropped “not”, a changed number or a reversed word (“likely”/“unlikely”) is marked as possibly changing the meaning.
- Not found. The passage isn’t in the cited source or any other source you added. If a passage shares at least half its words, it’s shown as the closest match.
- Source not supplied. The citation names a work that isn’t among your sources.
Some quotations also carry a flag: Wrong page, Wrong source (found in a different work from the one cited), Source is quoting (the source itself has the passage in quotation marks, so you may need “quoted in”), No page cited and Source has no page numbers.
Why “Altered” when I only changed one small word?
Because a quotation should be word for word. Verbatim shows exactly what differs; whether it matters is up to you. If a change is deliberate (for example, modernised spelling), mark the quotation as reviewed with ⌘K and it stays out of the list.
Could a scanned source cause false alarms?
Yes. Text recognition sometimes misreads a letter. When a source was read that way, Verbatim says so next to the result, so you can check the page itself with Show in Source.
Citations and file names
How does Verbatim know which source a quotation comes from?
It reads the citation next to the quotation and matches it to your files by author and year. It understands author–date citations like (Scott 1998, 87), (Scott 1998: 87–89) and Scott (1998), a page number on its own (the same work as before), footnotes like James C. Scott, Seeing Like a State (New Haven: Yale University Press, 1998), 87., Ibid., and Pandoc keys like [@scott1998, 87].
How should I name my files?
With the author’s surname and the year, for example Scott 1998 – Seeing Like a State.pdf or Greene & Dalke 2021 – You’re Still an Angry Man.pdf. If a file name doesn’t match its citation, Verbatim still searches the file, and tells you the citation wasn’t matched. With Zotero, file names don’t matter.
Can I keep my manuscript in the same folder as my sources?
Yes. Verbatim never uses the manuscript as a source, and skips files that look like earlier drafts of it (Word, Markdown or text files holding most of its quotations).
PDFs, EPUBs and scanned pages
The page numbers are wrong for one of my PDFs.
Verbatim reads the printed page numbers from the page margins (for example 291 to 354 in a journal article), and uses the file’s own page labels when they’re meaningful. A few PDFs have neither, such as unpaginated web reports; then the page check is skipped and the result says so. If you think a PDF’s pages are read wrongly, please email me the details.
My source is an EPUB. Can it check pages?
Yes, if the EPUB carries the print edition’s page numbers, as many publishers’ EPUBs do. Otherwise Verbatim shows the chapter instead and notes that the page couldn’t be checked.
What about scanned PDFs?
Pages without text are read with the Mac’s built-in text recognition. It runs on your Mac, takes a few seconds a page the first time, and the result is kept for next time. You can turn it off in Verbatim › Settings.
Verbatim says it isn’t allowed to read a file.
Verbatim can read only the files and folders you choose (a Mac App Store rule). A link or alias to a file elsewhere isn’t covered: add the original file, or its folder, instead.
Zotero
How do I check against my Zotero library?
Click Add Zotero Library… and choose your Zotero data folder (usually Zotero in your home folder; it contains zotero.sqlite). Then pick the whole library or a collection; a collection includes its subcollections. Zotero can stay open.
Some of my Zotero items are missing.
Verbatim reads PDF, EPUB and snapshot attachments stored in Zotero. Attachments that haven’t been downloaded to this Mac, and linked files stored outside the Zotero folder, can’t be read; they’re listed under “files not used” in the results.
Fixing quotations
What’s the fastest way to fix everything?
Go through To Review with the arrow keys. Space shows the passage in its source; Copy Source Text copies the source’s wording. For a Word manuscript, Export › Word Copy with Comments saves a copy of your document with a comment on each quotation to fix, anchored to the quoted words. Then fix them in Word and choose Check Again (⌘R): Verbatim keeps your place.
Does Verbatim change my manuscript?
No. It only reads it. The Word copy with comments is a new file; your original isn’t touched.
Can I check translated quotations?
Not against the original, since the words differ. Check them against the translation you quoted from.
The free version
What does the free version do?
It checks every quotation, and shows full results for the first 20 quotations of any manuscript. A one-time in-app purchase unlocks the results for all of them, and the exports. There’s no subscription.
I bought Verbatim on another Mac.
Choose Verbatim › Settings › Restore Purchase, signed in with the same Apple Account.
Contact
Email contact+verbatim@victorshammas.com. If a result looks wrong, it helps to include the quotation, its citation, and the source’s title and page.