Create, edit and display a journal article, entirely in GitHub
HTML JavaScript Ruby Shell
Pull request Compare This branch is 1 commit ahead, 6 commits behind PeerJ:gh-pages.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
_data
_figures
_includes
_layouts
_sections
data
.gitignore
Gemfile
LICENSE
README.md
_config.yml
_config_dev.yml
index.json
index.md
references.md
serve.sh

README.md

Paper Now

Create, edit and (optionally) display a journal article, entirely in GitHub.

In contrast to the more traditional process of submit > peer review > publish at PeerJ, or even the less formal preprints at PeerJ Preprints or arXiv, Paper Now is an experiment to see where the future may go with scholarly communication. Initially, it may be that co-authors collaborate either privately or publicly on GitHub and then proceed to submitting to PeerJ or other journals for formal peer-review or preprinting. Or perhaps this is where the traditional medium of publication begins to diverge. There is no end goal other than to see what the academic community wants, which is why this is completely open to fork, extend, and build upon.

Examples

Instructions

  1. Clone this repository to your own account, by visiting GitHub's importer.
  2. Edit the article metadata
  3. Add data* and figures
  4. Edit each section
  5. View your article in GitHub Pages at https://{username}.github.io/paper-now

Notes

  • Paper Now is at a very experimental stage; it may progress further if people find it useful.
  • Paper Now is inspired by Jekyll Now; the sidebar layout is inspired by Lens.
  • If you rename your repository, you also need to change the baseurl setting in _config.yml to match.
  • *There isn't currently a way to upload binary files using GitHub's web interface, so you'll need to do this locally. GitHub's desktop client is probably the easiest way to clone a repository, add files and push the changes back to GitHub.
  • The article styles and scripts are in a separate web component, so can be updated independently of the article content.

Feedback