Welcome to Paperoni! Paperoni is a tool for paper management developed at Mila.

Table of contents

  1. Searching for papers
  2. My papers
  3. Adding papers
  4. Editing papers

Also see the validator interface help and admin interface help

The Search interface allows searching through Paperoni's database of papers. It searches as you type (with a short debounce). Results are sorted so that the most recent publications appear on top.

  • Title: Search by paper title.
  • Author: Search by author name or email (at most one author may be specified).
  • Institution: Search by author affiliation or institution.
  • Venue: Search by venue. We try our best to normalize venue names, but sometimes the same venue may be listed under more than one spelling.
  • Topic: Search by topic. These may be not fully consistent or complete over the whole collection.
  • Start/end date: Search for a paper that had any release between the start and end date. For example, an article with a preprint in 2022 and a publication in 2023 will appear both in 2022 and in 2023.
  • Type: Filter peer-reviewed, preprint, or workshop papers.
  • Peer-reviewed: Check this box to only show peer-reviewed publications.

By default, Paperoni performs a substring search. You may prefix a search with "=" to perform an exact search.

Click-to-filter

In the search results, you can click on an author name, institution, venue, or year to instantly filter results by that value.

Edit button

An edit icon (edit) appears next to each paper title. Clicking it opens the edit page for that paper in a new tab, where you can suggest modifications to its title, authors, venues, and other fields.

Pending papers and edits

Click the "Pending" checkbox to also see papers and edits corresponding to the current search and for which validation is pending.

My papers

The My Papers page helps you keep your own author record accurate: it shows papers already credited to your email, lets you unclaim ones that aren't yours, and helps you find and claim ones that are.

Claiming for: By default the page uses your own email, shown top-right as "Claiming for <email>". Click it to edit, and search/claim on behalf of a different email (e.g. if you are a researcher's assistant, or for an associate who cannot use the interface).

  • Title / Author: Narrow down the search, similarly to the Search interface.

Your papers

Papers (validated, then pending) with an author whose email matches. Each one has a Not mine button: click it to clear your email from the matching author.

Unclaimed papers

Once you search by title or author, this section lists other matching papers not already shown above. Each has a Claim button: click it to pick which author entry is you from a dropdown (the closest name match is listed first), then confirm.

Note: changes on this interface go to the suggestion queue and may not operate immediately.

Add Paper

This button is enabled once you've searched by title, and opens the paper addition interface in a new tab, so you can add a paper that isn't in the database at all (the search requirement exists to force checking whether the paper is already there).

Adding papers

The paper addition interface lets you suggest new papers. Unless you have the validator role, these suggestions will not appear immediately in the database, but will rather go to a pending queue for approval. It may take a few days for the paper to appear.

Before suggesting a paper, please check whether it is already in the database using the search interface.

Populate

At the top of the interface, you will see a Populate section where you can paste a link to the paper (you may paste several, comma-separated). Paperoni will read the metadata and populate the form for you. Allowed links are:

  • arxiv: e.g. https://arxiv.org/abs/1810.11530 or arxiv:1810.11530
  • DOI: e.g. doi:10.1109/comst.2024.3450292
  • Semantic Scholar: e.g. https://www.semanticscholar.org/paper/9f1ce3ff55eb559e00df33fa40ee6ecd6a2a54f1 or semantic_scholar:9f1ce3ff55eb559e00df33fa40ee6ecd6a2a54f1
  • OpenReview: e.g. https://openreview.net/forum?id=gVTkMsaaGI or openreview:gVTkMsaaGI (the metadata is taken from OpenReview itself, the PDF is not read)

Fetching the metadata can sometimes take a while (up to a minute or two), so be patient after clicking Populate.

This only fills the form, it does not submit anything. You may review what was filled in, fix mistakes, add missing venues, and so on.

Submitting

Once you are done, simply click on the Suggest Paper button, bottom right. This will place the paper in a queue for review, so it is normal that you don't see it for a bit when searching for papers right after suggesting it.

Editing papers

The edit interface lets you suggest changes to all data associated to a paper, including title, abstract, authors and affiliations, releases (venues and dates), topics, links, and flags. You can also create a new paper from scratch at /edit/new, or delete a paper.

From the search page, click the edit icon (edit) next to a paper's title to open its edit page.

API

Paperoni has an API that you may use to get data programmatically. To use it, you need a bearer token.

  1. Get a token: Navigate to Token. Sign in with Google when prompted. When the flow finishes, the page will show your token — copy it and store it securely.

  2. Use the token: Send it in the Authorization header as Bearer YOUR_TOKEN.

Example — search (first 10 results):

curl -H 'Authorization: Bearer YOUR_TOKEN' \
  'https://paperoni.mila.quebec/api/v1/search?limit=10&offset=0'

Replace YOUR_TOKEN with the token you copied and adjust the base URL if you use a different Paperoni instance.

For full REST API reference (endpoints, parameters, schemas), see the API documentation.

Bienvenue sur Paperoni ! Paperoni est un outil de gestion d'articles développé à Mila.

Table des matières

  1. Rechercher des articles
  2. Mes articles
  3. Ajouter des articles
  4. Modifier des articles

Voir également l'aide de l'interface de validation et de l'interface d'administration.

L'interface Recherche permet de chercher dans la base d'articles de Paperoni. La recherche se fait au fil de la frappe (avec un court délai). Les résultats sont triés pour afficher les publications les plus récentes en premier.

  • Titre : Recherche par titre d'article.
  • Auteur : Recherche par nom ou courriel d'auteur (un seul auteur peut être précisé).
  • Institution : Recherche par affiliation ou institution de l'auteur.
  • Conférence : Recherche par lieu de publication. Nous faisons de notre mieux pour normaliser les noms de lieux, mais il arrive qu'un même lieu soit répertorié sous plusieurs orthographes.
  • Sujet : Recherche par sujet. Ceux-ci ne sont pas nécessairement cohérents ni complets sur l'ensemble de la collection.
  • Date de début/fin : Recherche d'articles ayant au moins une parution entre ces dates. Par exemple, un article avec une prépublication en 2022 et une publication en 2023 apparaîtra pour 2022 et 2023.
  • Type : Filtre les articles évalués par les pairs, les prépublications ou les articles d'atelier.
  • Évalué par les pairs : Cochez cette case pour n'afficher que les publications évaluées par les pairs.

Par défaut, Paperoni effectue une recherche par sous-chaîne. Vous pouvez préfixer une recherche par « = » pour effectuer une recherche exacte.

Filtrage par clic

Dans les résultats, vous pouvez cliquer sur un nom d'auteur, une institution, un lieu ou une année pour filtrer immédiatement les résultats par cette valeur.

Bouton Modifier

Une icône de modification (modifier) apparaît à côté de chaque titre d'article. Un clic ouvre la page d'édition de l'article dans un nouvel onglet, où vous pouvez suggérer des modifications à son titre, ses auteurs, ses lieux et autres champs.

Articles et modifications en attente

Cochez la case "En attente" pour voir les articles et les modifications qui correspondent à la recherche courante et sont en attente de validation.

Mes articles

La page Mes articles vous aide à tenir votre propre fiche d'auteur à jour : elle affiche les articles déjà associés à votre courriel, vous permet de vous désassocier de ceux qui ne sont pas les vôtres, et vous aide à trouver et revendiquer ceux qui le sont.

Revendication pour : Par défaut, la page utilise votre propre courriel, affiché en haut à droite sous la forme « Revendication pour <courriel> ». Cliquez dessus pour le modifier et rechercher/revendiquer au nom d'un autre courriel (p. ex. si vous êtes l'assistant·e d'un·e chercheur·se, ou pour un·e collègue qui ne peut pas utiliser l'interface).

  • Titre / Auteur : Affinez la recherche, comme dans l'interface de recherche.

Vos articles

Les articles (validés, puis en attente) dont un auteur a un courriel correspondant. Chacun possède un bouton Pas moi : cliquez dessus pour retirer votre courriel de l'auteur correspondant.

Articles non revendiqués

Dès que vous effectuez une recherche par titre ou par auteur, cette section liste les autres articles correspondants qui ne sont pas déjà affichés ci-dessus. Chacun possède un bouton Revendiquer : cliquez dessus pour choisir, dans une liste déroulante, quel auteur vous êtes (le nom le plus proche du vôtre apparaît en premier), puis confirmez.

Note : les modifications apportées dans cette interface sont envoyées dans la file de suggestions et peuvent ne pas prendre effet immédiatement.

Ajouter un article

Ce bouton s'active une fois qu'une recherche par titre a été effectuée, et ouvre l'interface d'ajout d'articles dans un nouvel onglet, pour ajouter un article absent de la base de données (l'exigence de recherche vise à forcer la vérification que l'article n'y figure pas déjà).

Ajouter des articles

L'interface d'ajout d'articles permet de suggérer de nouveaux articles. À moins que vous n'ayez le rôle de validateur, ces suggestions n'apparaîtront pas immédiatement dans la base de données, mais iront plutôt dans une file d'attente en attente d'approbation. L'article peut mettre quelques jours à apparaître.

Avant de suggérer un article, veuillez vérifier s'il ne se trouve pas déjà dans la base de données au moyen de l'interface de recherche.

Remplir

En haut de l'interface, vous verrez une section Remplir où vous pouvez coller un lien vers l'article (vous pouvez en coller plusieurs, séparés par des virgules). Paperoni lira les métadonnées et remplira le formulaire pour vous. Les liens autorisés sont :

  • arxiv : ex. https://arxiv.org/abs/1810.11530 ou arxiv:1810.11530
  • DOI : ex. doi:10.1109/comst.2024.3450292
  • Semantic Scholar : ex. https://www.semanticscholar.org/paper/9f1ce3ff55eb559e00df33fa40ee6ecd6a2a54f1 ou semantic_scholar:9f1ce3ff55eb559e00df33fa40ee6ecd6a2a54f1
  • OpenReview : ex. https://openreview.net/forum?id=gVTkMsaaGI ou openreview:gVTkMsaaGI (les métadonnées proviennent d'OpenReview même, le PDF n'est pas lu)

La récupération des métadonnées peut parfois prendre un certain temps (jusqu'à une ou deux minutes), soyez donc patient après avoir cliqué sur Peupler.

Cela ne fait que remplir le formulaire, rien n'est soumis. Vous pouvez vérifier ce qui a été rempli, corriger les erreurs, ajouter les lieux manquants, etc.

Soumettre

Une fois terminé, cliquez simplement sur le bouton Suggérer l'article, en bas à droite. Cela placera l'article dans une file d'attente en vue de sa révision ; il est donc normal que vous ne le voyiez pas pendant un moment lorsque vous cherchez des articles juste après l'avoir suggéré.

Modification des articles

L'interface d'édition permet de suggérer des changements à toutes les données associées à un article : titre, résumé, auteurs et affiliations, parutions (lieux et dates), sujets, liens et drapeaux. Vous pouvez aussi créer un nouvel article depuis /edit/new, ou supprimer un article.

Depuis la page de recherche, cliquez sur l'icône d'édition (modifier) à côté du titre d'un article pour ouvrir sa page de modification.

API

Paperoni dispose d'une API que vous pouvez utiliser pour obtenir des données par programmation. Pour l'utiliser, vous avez besoin d'un jeton (token) porteur.

  1. Obtenir un jeton : Ouvrez la page Jeton. Connectez-vous avec Google lorsque demandé. À la fin du processus, la page affichera votre jeton — copiez-le et conservez-le de manière sécurisée.

  2. Utiliser le jeton : Envoyez-le dans l'en-tête Authorization sous la forme Bearer VOTRE_JETON.

Exemple — recherche (10 premiers résultats) :

curl -H 'Authorization: Bearer VOTRE_JETON' \
  'https://paperoni.mila.quebec/api/v1/search?limit=10&offset=0'

Remplacez VOTRE_JETON par le jeton copié et adaptez l'URL de base si vous utilisez une autre instance Paperoni.

Pour la référence complète de l'API REST (endpoints, paramètres, schémas), consultez la documentation API.