Scrivener and Magic Citations on Papers for Mac

Magic Citations

If you have never used Citations before, you may want to first get familiar with this feature by watching the screencasts in the corresponding tutorial:

http://support.mekentosj.com/kb/tutorials/magic-manuscripts

How to insert citations in Scrivener

The workflow to insert citations in Scrivener is very similar to what you would do in Pages:

  • Invoke the Citations window by using the keyboard shortcut (typically type the control key twice)
  • Search the paper you'd like to cite and press Enter when you found it
  • Optionally add more papers to the citation by typing another query
  • When the citation is to your liking, press Enter on the 'Insert Citekey' action (or double-click)

This will insert a 'citekey' within brackets at the insertion point in the current document:

Manuscripts window for Scrivener

Scrivener document with inserted citekey

How to format the bibliography of a Scrivener document

Unlike with Pages or MS Word, you cannot format a manuscript all from within Scrivener at the moment. However, once your Scrivener project is ready and has all the citations inserted, you can generate a separate document to be formatted in Word:

  • In Scrivener, 'compile' the project into a 'Rich Text' (rtf) document
  • Open the compiled document in Microsoft Word
  • Save the document as a 'doc' or 'docx' file
  • Invoke the Citations window (control+control)
  • Choose the 'Format Manuscript' option, or select a style to apply to the manuscript
  • Papers/Citations will create a new document with the formatted citations and the bibliography

Alternatively, you can generate a separate rtf document with the formatted citations and the formatted bibliography:

  • In Scrivener, 'compile' the project into a 'Rich Text' (rtf) document
  • Open the compiled document in TextEdit ot in Microsoft Word (or import it into Pages)
  • Invoke the Citations window (control+control)
  • Choose the 'Format Manuscript' option, or select a style to apply to the manuscript
  • Papers/Citations will create a new document with the formatted citations and the bibliography

Note that the 'rtf' format will not preserve footnotes, and in such a case, the only possible workflow is by exporting to '.doc' or '.docx' documents in Word.

scrivener_manuscripts_format_manuscript.png

scrivener_textedit_results_png.png

In some cases, the Citations window will display warnings as it is not sure which paper corresponds to one of the citekeys. This is most likely to happen if you have duplicate entries in your library. In this case, you just need to select which paper you want to use for the ambiguous citekey.

How to use Bibtex commands with Scrivener

By default, the citekeys are inserted using the Papers format, which simply places the citekey inside curly braces. If you want to format your bibliography using BibTeX, you can change the citekey format in Papers Preferences, under the Citations tab. The setting needs to be changed before you start inserting citations in your project.

scrivener_bibtex_citekey_preference.png

Read also our tips on using BibTeX with Citations: http://support.mekentosj.com/kb/pro-tips/bibtex-and-magic-manuscripts

What's next

There is still more we would like to do for Scrivener integration:

  • Support the Pandoc / MMD workflow (short term)
  • Offer the "Format Manuscript" option directly in Scrivener (long term)

Please share your thoughts, ideas, feedback, suggestions on this public discussion:

http://support.mekentosj.com/discussions/suggestions/20-scrivener-2...

(please do not ask for timelines on the future Scrivener developments, and please keep the discussion limited to the Scrivener topic; other bugs and feature requests should be sent to support at mekentosj dot com)