PubRef

From HandWiki
pubref
Websitepubref.org
CommercialYes
Launched2014
Current statusActive

PubRef is a composition and project management application used by researchers and students for scholarly writing and communication. PubRef uses an extended form of Markdown as a primary authoring format and converts this to JATS, the archive format used by the US National Library of Medicine.

Research asset containerization

Researchers manage scholarly writing projects within version-controlled file repositories called containers that function similarly to git repositories and docker containers to provide enhanced reproducibility, transparency and re-usability in digital science publishing.

Manuscript writing

A PubRef manuscript is a Markdown file within a container that contains extra embedded information that describes the essential front matter elements of a scholarly manuscript such as the title, short title, list of authors, author affiliations, keywords. This information is captured in embedded YAML blocks within the primary manuscript called Meta. Figures, tables, equations and other special content can be similarly embedded within the context of the document via Meta descriptors.

Minimal example

This minimal formatting example repurposes a classic paper by Stephen Hawking and Roger Penrose The Singularities of Gravitational Collapse and Cosmology [1]

# The journal meta descriptor declares what journal the 
# manuscript should be submitted to.
!journal
title: Proceedings of the Royal Society of London
# The article meta descriptor defines the title, keywords, and categorization
!article
type: Original Research
title: The Singularities of Gravitational Collapse and Cosmology
# A Meta Block that describes the corresponding author.
!author
corresponding: yes
first: Stephen
last: Hawking
degrees: PhD
affiliation: cambridge
---
!author
first: Roger
last: Penrose
degrees: PhD
affiliation: birbeck
# A Meta Block that describes an organizational affiliation.  
# The 'id' makes it referenceable within the document.
!affiliation id: cambridge
university: Cambridge University
institute: Institute of Theoretical Astronomy
---
!affiliation id: birbeck
college: Birbeck College
dept: Department of Mathematics

# Introduction

An important feature of gravitation, for very large concentrations of mass, is that it is essentially *unstable*. This is due...
# This inserts a bibliography within the document.  Citations references are 
# resolved to a items in a folder named 'references', in the same directory as the 
# manuscript file.
!bibliography 
src: references

Manuscript publishing

Once the essential frontmatter meta elements have been declared, manuscripts can be automatically submitted to academic publishers.[2] Articles, supporting data, and dependent code can be published directly on PubRef in the form of personal communications under the DOI prefix 10.17920/P9.pubref.[3]

References

  1. Hawking, Stephen; Penrose, Roger (1970). "The Singularities of Gravitational Collapse and Cosmology". Proceedings of the Royal Society A 314 (1519): 529–548. doi:10.1098/rspa.1970.0021. Bibcode1970RSPSA.314..529H. 
  2. Aries Press. "Aries Systems and PubRef Announce Partnership Allowing Authors Direct Submission to Thousands of Scholarly Journals". http://www.editorialmanager.com/homepage/press.html#090815. Retrieved 8 September 2015. 
  3. California Digital Library. "EZID Client List". http://ezid.cdlib.org/home/client_list. Retrieved 10 September 2015.