Papers-specific CSL variables

Aleksander Manterys's Avatar

Aleksander Manterys

29 Mar, 2016 11:54 AM

Dear Madam/Sir,

I have found information about a few Papers-specific CSL variables: papers2_pmid, papers2_pmcid, papers2_notes, papers2_type and papers2_subtype). Are there any Papers-specific equivalents for all CSL-standard date variables, especially for original-date, issued, submitted? Or, more generally, can you send me, please, a complete list Papers-specific variables? The CSL-standard variables can be used in Mendeley and Zotero; moreover, there is a possibility to render them via special fields (respectively -- "Notes" and "Extra"; for example, {:original-date: 1951}). In Papers there are date fields, I can put dates into them, but I cannot render them.

Aleksander Manterys

  1. Support Staff 1 Posted by cary on 14 Apr, 2016 09:57 PM

    cary's Avatar

    Hey Aleksander -

    Thanks so much for taking the time to reach out to us. I do apologize for our delay in response to you.

    Unfortunately we are not able to edit or write new styles for you. The styles in Papers come directly from the official CSL repository.

    The CSL Library currently has nearly 7000 styles, but there are still a number of journals not represented. However, Papers regularly updates when new styles are added or amended in the repository.

    All the styles available with Papers are listed in the style browser that you can access as follows:

    • Go into the Papers Preferences…Citations
    • Click on the popup menu 'Favorite Styles' and select 'More Styles...'
    • This will open the Style Browser

    Note that many journals actually point in their instructions to authors to some generic standard styles like 'Vancouver', 'APA' or 'Chicago' to be used for their publications. That's often a good way to get the style you want.

    We also made it possible to overwrite the styles present in Papers, or to add more styles, by dragging and dropping an .csl file directly into the Papers app. This however requires you to edit the XML files that are used by CSL, and to read the CSL specifications. It's not for the faint of heart, but if you are comfortable with XML and have a good text editor like TextMate or similar, then it's not out of reach. The advantage of CSL is that it is used by other applications, it has been developed in the open by many others before Papers adopted it, and there is a lot of material online about it.

    There is also a CSL visual editor, which is especially useful for editing an existing style to match your needs, which you can find here:

    The manual on how to use it can be found here:

    User guide for the CSL Editor

    If you do write your own style, or need to add a style from a repository that has not yet updated in Papers, our Knowledge Base article has full instructions which you may find useful:

    Adding additional citation styles on Papers 3 for Mac

    Below are some other links you may find of use:

    Here is the CSL reference:

    And here are the main repositories for CSL stylesheets:

    Please note that the above links, including the style editor, are not Papers specific. If you use their forums for advice they will only be able to help you with the csl styles and not their integration with Papers. Instructions for adding styles to Papers can be found in the knowledge base article above.

    My apologies again for the trouble!



  2. cary closed this discussion on 14 Apr, 2016 09:57 PM.

  3. Aleksander Manterys re-opened this discussion on 15 Apr, 2016 09:41 AM

  4. 2 Posted by Aleksander Mant... on 15 Apr, 2016 09:41 AM

    Aleksander Manterys's Avatar

    Hey Cary,

    thank you for your letter.
    I have to repeat: I need precise information about fields mapping in Papers in relation to CSL. I do not need any help how to write, rewrite, rework or install a CSL style. Information entered into many important Papers' database (many date fields, copyright field) fields cannot be rendered in bibliography using CSL-standard variables. Papers app is not CSL-compliant enough. That's my problem.


  5. cary closed this discussion on 18 Apr, 2016 07:06 PM.

Discussions are closed to public comments.
If you need help with Papersapp please start a new discussion.

Keyboard shortcuts


? Show this help
ESC Blurs the current field

Comment Form

r Focus the comment reply box
^ + ↩ Submit the comment

You can use Command ⌘ instead of Control ^ on Mac