PaperHive integration with ownCloud
JavaScript PHP CSS

README.md

Build Status Scrutinizer Code Quality

  • Support for 9.0
  • Support for 9.1
  • Support for 9.2-10.0

Installation

To install, go to /apps in your ownCloud installation directory and `git clone https://github.com/owncloud/files_paperhive. In the apps admin panel enable PaperHive app.

Remember about the correct permissions for the www folder after cloning the repository, otherwise app might not work correctly! https://doc.owncloud.org/server/9.0/admin_manual/installation/installation_wizard.html#strong-perms-label

It is highly recommended, to place in each user root directory a default introduction PaperHive document, https://paperhive.org/documents/0tsHJq1-yyVZ which will help the user orient in the new functionality!

About ownCloud, PaperHive and Collabora

Researchers, students, medicine and engineering specialists are among the core ownCloud users and ownCloud's team is committed to support them in the management and creation of research data and texts. A recent partnership with Collabora was ownCloud's response to users' need to write collaboratively online. It resulted in the release of the Collabora Online Development Edition, a VM containing LibreOffice Online and ownCloud Server. To help users read, reference and discuss already published academic texts, ownCloud now starts a cooperation with PaperHive, a web platform for collaborative reading.

Researchers read 12-25 hours a week depending on their discipline. Yet, understanding research articles and books – some of the most complex documents in the world – is hard and inefficient in isolation. Students and inexperienced researchers waste time trying to decipher these texts alone, senior researchers dig through folders of articles irrelevant for their own work, and all at some point might repeat unknowingly others’ mistakes or include these as a citation in their own paper.

PaperHive looks at how the web platform could transform reading into a more social and active process of collaboration. It is a cross-publisher layer of interaction on top of published research documents that enables contextual and structured discussions in real time. PaperHive's main benefits for users:

  • annotate and discuss published academic articles, books and textbooks
  • ask and answer questions, help and benefit from the knowledge, opinions and results of your colleagues and the broad research community
  • keep up-to-date with the newest developments around a specific research topic
  • improve research texts by discovering and correcting mistakes publicly, make complex concepts more accessible
  • share your thoughts and discoveries with the research community and increase your visibility as a researcher
  • give structured feedback to your colleagues
  • if you are a teacher, you can make lectures and seminars much more engaging for students

Close to 14 million academic articles and books can currently be read and discussed with PaperHive.

Transforming Reading Into a Process of Collaboration

One of the greatest ownCloud features is sharing. Folders or files can be shared with groups, individual users or using password protected or public links.

The PaperHive documents in this shared folder allow copyright-compliant sharing of research publications with groups of users. By using the Discuss button in the file list a user is quickly redirected to the PaperHive page. The Discuss button also shows the current number of discussions online. The user can now easily keep up-to-date with new developments around publications of interest and start public or private discussions to better understand or improve academic texts.

Transform your lectures, research and engineering work into a process of collaboration with ownCloud, PaperHive and Collabora!

Add PaperHive document to ownCloud

The PaperHive plugin is shipped with the new file menu button "PaperHive Document", which allows adding the documents found on the PaperHive website at https://paperhive.org. These are no different to your regular .doc or .jpg files and will behave the same as any other files in the ownCloud user interface.

Clicking on the "PaperHive Document" button will ask you for a PaperHive URL or DocID, displaying helpful information in the yellow popup on top of your file list. You are free to choose submitting just DocID or whole URL!

DocID is an unique book identifier, which can be found in the URL of the document at https://paperhive.org, as shown in the example below, where URL is https://paperhive.org/documents/0tsHJq1-yyVZ and unique DocID is 0tsHJq1-yyVZ.

Desired URL or DocID has to be inserted into the field below and confirmed pressing ENTER.

Your PaperHive Document is now in your synchronisation folder!