Support
Something not working, or a result you don’t understand? The answers below cover most things. If not, email contact+ibid@victorshammas.com. I read every message.
- Getting started
- What the verdicts mean
- Citations and styles
- The bibliography
- PDFs and scanned pages
- Fixing citations
- The free version
- Contact
Getting started
How do I check a manuscript?
Open Ibid, choose your manuscript (or drag it onto the window) and click Check Citations. If the manuscript ends with a References, Bibliography or Works Cited section, that’s all: Ibid reads it automatically. You can also add BibTeX, CSL-JSON or RIS files to check against.
To see what it does first, choose Help › Try the Sample: a short essay citing Scott, Foucault, Bourdieu and others, with a few planted mistakes.
Which files can I use?
Manuscript: Word (.docx), PDF, Markdown, LaTeX (.tex), RTF, OpenDocument (.odt), Word 97–2003 (.doc), HTML or plain text. Footnotes and endnotes are read too.
Bibliography: the manuscript’s own reference list, and optionally BibTeX (.bib), CSL-JSON (.json, for example exported from Zotero) or RIS (.ris) files, or a separate reference-list document (Word, PDF, Markdown or text).
It found no bibliography.
Ibid looks for a heading such as “References”, “Bibliography” or “Works Cited” near the end of the manuscript, and reads the entries after it. If your list has a different heading, or is in a separate file, add that file as a bibliography file instead.
Does Ibid read tracked changes?
In Word files, tracked deletions are skipped, so a citation you deleted with Track Changes on isn’t checked. Tracked insertions are read as part of the text.
What the verdicts mean
- Matched. The citation and its bibliography entry agree on author and year.
- Not in bibliography. The citation names a work that has no entry in the bibliography.
- Not cited in text. A bibliography entry that no citation in the text or notes refers to.
- Year mismatch. The author matches, the year doesn’t: a different year, an original year cited for an entry listed by its reprint year, or a year without the a/b letter the bibliography uses.
- Author mismatch. The year matches, the name doesn’t quite: a misspelling, a missing accent, a left-out co-author, co-authors in the wrong order, or “et al.” for two authors.
- Ambiguous citation. Two entries have the same author and year, without a/b letters to tell them apart.
- Page outside range. The cited page isn’t within the page range of the article or chapter in the bibliography.
- Reference issue. A duplicate entry, an entry out of alphabetical order, or an entry without a year.
- Style inconsistency. The citation is set differently from most of the others in the manuscript, for example a colon before the page number, or “&” instead of “and”.
For footnoted manuscripts there are also Title mismatch, Short note before full note and Unclear “Ibid.” (it isn’t clear which work an Ibid. refers to).
A citation is reported missing, but it’s in the bibliography.
First check the spelling of the name and the year in both places; Ibid suggests the closest entry when there is one. If you cite an organisation by a short name, give that name in brackets in the bibliography entry, for example Space Exploration Technologies Corp. [SpaceX]. 2020., and citations to “SpaceX” will match it. Abbreviations made from an organisation’s initials, such as WHO or NASA, are matched without brackets.
Can I turn off the style and alphabetical-order checks?
Yes, in Ibid › Settings.
Citations and styles
Which citation styles does Ibid check?
Author–date styles, such as APA, Chicago author-date, ASA and Harvard, and Chicago notes and bibliography. It understands citations like (Scott 1998, 87), (Scott 1998: 87–89), Scott (1998), (Scott 1998; Bourdieu 1984), (Weber 1922a, 1922b), Pandoc keys like [@scott1998, 87] and LaTeX \cite{scott1998}.
In footnotes, full notes like James C. Scott, Seeing Like a State (New Haven: Yale University Press, 1998), 87., short notes like Scott, Seeing Like a State, 87., and Ibid. and Idem are all checked against the bibliography.
What about MLA or numbered citations?
Ibid recognises MLA (author–page) and numbered citation styles and says so in the results, but doesn’t check them yet. Their bibliography entries are shown, without “Not cited in text” verdicts.
The bibliography
Do I need a .bib file?
No. If the manuscript has its own reference list, Ibid reads it, including 3-em dashes for a repeated author (———. 1990.), original and reprint years like 1989 [1859], year letters, page ranges and DOIs. Add an export from your reference manager only if you also want to check against it.
Ibid says it isn’t allowed to read a file.
Ibid can read only the files you choose (a Mac App Store rule). A link or alias to a file elsewhere isn’t covered: choose the original file instead.
PDFs and scanned pages
Can I check a PDF?
Yes. Ibid reads the page layout, including two-column pages and footnotes, and lists problems by the printed page number. Results are most reliable from a PDF exported with its text (for example with Save as PDF in Word), rather than a scan. If you have the Word or LaTeX file, checking that is better still.
What about scanned PDFs?
Pages without text are read with the Mac’s built-in text recognition, on your Mac. It sometimes misreads a letter, so a name on a scanned page may be reported as a mismatch when it’s right. Check the page itself before changing anything.
Fixing citations
What’s the fastest way to fix everything?
Go through To Review with the arrow keys. Copy Suggested Fix or Reference (⇧⌘C) copies the corrected citation. For a Word manuscript, File › Export Word Copy with Comments saves a copy of your document with a margin comment on each citation and bibliography entry to fix. Then fix them in Word and choose Check Again (⌘R).
For any manuscript, File › Export Report as Web Page saves a report you can open in any browser.
A result is fine as it is.
Mark it as reviewed with ⌘K and it stays out of the list, also next time you check the same manuscript.
Does Ibid change my manuscript?
No. It only reads it. The Word copy with comments is a new file; your original isn’t touched.
The free version
What does the free version do?
It checks the whole manuscript, and shows full results for the first 25 citations and the first 25 bibliography entries. A one-time in-app purchase unlocks the results for all of them, and the exports. There’s no subscription.
I bought Ibid on another Mac.
Choose Ibid › Settings › Restore Purchase, signed in with the same Apple Account.
Contact
Email contact+ibid@victorshammas.com. If a result looks wrong, it helps to include the citation and the bibliography entry as they appear in your manuscript.