Papercore Help

If you have any questions not answered by this help, please don't hesitate to contact .

Your account

To use the content of the Papercore, you don't need to have an account, you can view the summaries without logging in. But to change a summary or create new summaries, you need to have an account so the changes to a summary can be attributed to a person.

Creating an account

To create an account, click on the Sign up link in the upper right of any page.

On the following page, provide all the information asked for in the form, and then create your account by clicking on the Sign up button. You will receive an email to the address you provided with an activation link which you have to open in your browser (by clicking on the link). After you did that, your account is ready for use.

Logging in

To log into the Papercore, click on the Not logged in link in the upper right of any page.

Provide your Login and Password to access the Papercore.

Summaries

Summaries provide a compressed view on a book, paper, journal article etc. They can be written as plain text or using a custom Latex style.

Creating a Summary

To create a summary, you have to be logged into the Papercore. See above if you don't have an account.

Start the summary creation

To create a new summary, select the Create entry from the Summary menu.

Then, select the type of document the summary is about. After the selection, the form matching the document type will appear. Mandatory fields have a bold label - you have to provide a value in those fields. The form is grouped into different sections, the top level sections being "Document", "PACS Categories" and "Summary".

You can't change the document type afterwards, so to start over you would have to cancel out of the form and use the Create menu link again (or use the Create menu link directly to start over).

Entering data

Document section

In this section, you enter the data of the document the summary will describe. The form is a bit different for each of the summary types, but the fields are more or less the same for each of the types.

The different fields are:

Title

Title of the summarized document

Year

Year in which the document was published

Link

A link to the document. The link can be entered in three formats:

URL: just a URL pointing to a webpage
ISBN: a ISBN Number (ISBN-10 or ISBN-13) for the item, with a format like "ISBN 3-680-08783-7" or "ISBN 978-3-86680-192-9" (actually only the numbers of the ISBN have to be there, but using an ISBN prefix is encouraged)
DOI: a valid DOI number, with a format like "DOI:10.1007/s003390201377" or "doi10.1371/journal.pbio.0020449.g001" (the DOI prefix has to be there!)

Pages

The range of pages a document is printed on in a publication (this is not present for all summary types)

Journal

The journal a document is printed in (this is not present for all summary types)

Volume

The volume of the journal

Number of pages

If left empty, the Papercore will try to determine the number of pages of the document from the link given above

Authors

Add the information about the author(s) here -- if you need to add more than one author, click on the Add an author link.

Editors

For some document types, you might be able to add Editors of an document -- fill in the information available, and if you need to add more than one editor, use the Add an author link.

PACS Categories section

To add the summary to a PACS category, you can expand the toplevel PACS categories by clicking on the PACS numbers in the left. To limit the shown categories, you can enter some text into the filter text field, the list will shrink according to the filter text you entered.

To select a PACS entry for the document, use the checkbox next to a PACS entry.

Summary section

This is where the real summmary is added. You can provide the summary text as a plain ascii text, or use the summary.sty Latex document class to create your summary (see below).

Summary Title: Title of the summary (normally, this will be the same as the document title -- if left empty, the document title will be used)
Summary ID: The ID of the Summary. This can be generated by using the generate Summary ID checkbox, or you can manually select the summary id. The suggested format is the surname of the main author followed by the year of publication of the document, e.g. Doe1999.
When you enter your own summary id, the entered text is checked against the currently available summary ids to find similar IDs and avoid duplicates.
Summary: This is where you enter your summary, in plain text or LaTeX format (see LaTeX document class for more information on the Latex format).

Graphics

If you use images in your summary (see below for LaTeX usage instructions), you will be prompted to upload the referenced images found in your summary text.

For each \includegraphics call, you will have to select the matching image to upload to the server. With the Use for: dropdown you can select for which referenced file you want to use the upload.

Important: only use images for which you have the permission to use and distribute!

Related Summaries section

If there are any summaries which are related to the summary you are entering, you can find them by entering text into the Find summary text field. When the correct summary is shown, use the Add button to add the summary as a related summary.

Finishing the summary creation

To add the summary to the Papercore, use the Create summary button at the bottom of the page. If there are any errors in the data you entered, the input form will be shown again with an error explanation at the top.

Fields which contain errors will have a red border surrounding them, so they can be found easily.

LaTeX document class

The summary can be entered in plain text format or as a latex document using the summary.cls. The latter allows you to use the full LaTeX formatting capabilities for your summary.

You can write the summary on your computer and check if everything is correct if you download the summary.cls file and install it in your local LaTeX system.

You can also download a sample LaTeX summary at summary.tex on which you can base your own summary.

Basic Usage

To write a summary using the LaTeX class, start with the following code:


\documentclass[article]{summary}

\author{James Doe}

\title{A summary title}
\journal{Journal of Summaries} 
\volume{1}
\pages{10-34}
\year{2010}
\id{Chainey2010}

\doi{DOI:10.1007/s003390201377}
\pacs{75.50.Ee Antiferromagnetics}

\begin{document}
\maketitle

\section{Introduction}
\section{Method}

\end{document}

Document Type

Possible values for the document type (to be put inside the square brackets in the \documentclass line) are: article, report, proceedings, overview

Authors

To describe the authors of the document the summary is about, use the \author{} command. Add as many lines as needed for the document's authors, e.g.:


\author{James Doe}
\author{Jane Doe}
\author{Jimmy Doe}

Editors

When the document type is overview, you can also state editors of the document by using \editor{} in the same way as for authors.

Document

To describe the document the summary is about, you can use different commands:

\title{}

This command sets the title of the document

\booktitle{}

Sets the book title if document type is proceedings

\journal{}

This command sets the title of the journal the document appeared in.

\no{}

This command sets the journal number if the document type is report

\volume{}

The volume of the journal

\pages{}

The range of pages the document is on in the journal

\year{}

Year of publication

\institution{}

Sets the institution the document was created in. Needed for document type report

\id{}

Set the ID of the summary. The expected format is the last name of the primary author followed by the publication year, e.g. Doe2009

\link{SumID} or \link[Some Text]{SumID}

Create a link to another summary. Supply the Summary ID as argument.

\doi{}

This command is used to add a link to the document which points to the full text of the document or a page describing the document.

It can be given as a DOI Number, a ISBN Number or as a URL.

see above for the supported formats.

\pacs{}

This command states a PACS category the document belongs to, e.g. \pacs{75.50.Ee}. Can be used as often as needed.

Summary

You can use the normal LaTeX commands in writing your summary.

Images

To include Images in your summary, use the normal LaTeX methods includegraphics, figure and so on — just keep in mind that your images can not be in EPS format (in the background, pdflatex is used).

For in-depth information, see for example http://en.wikibooks.org/wiki/LaTeX/Importing_Graphics

Linking to a Summary

If you want to link to a summary, you can use a short link: http://papercore.org/<SumID> -- for example: http://www.papercore.org/spinGlasses2010

The shortlink is displayed on the top of the summary page.

If you have any questions not answered by this help, please don't hesitate to contact .