Package: hep-paper-manager
HEP Paper Manager (HPM)HPM is a command-line tool that helps adds Inspire literature to a
Notion database.It has features as following:Retrieve HEP papers by Inspire ID, or Arxiv ID, or DOI.Customizable paper template for creating pages in a Notion database.Interactive CLI for easy setup and usage.Installationpip install hep-paper-managerLet's add a paper to a Notion database!In this step-by-step guide, we will together add "[1511.05190] Jet image -- deep
learning edition"(link) to a Notion
database.Step 0: Create an integration in NotionOpenMy Integrations.Click+ New integration.Enter a name for your integration.Copy the integration secret as your token.Check the official guide for integrationshere.Step 1: Create a Notion databaseA database is the place where we'll put all papers of interest in. Create an
empty page and make it a database.Each item represents a paper. Below is what we want to record for each
paper:PropertyTypeCommentDateDateWhen the paper appears in the Inspire.CitationsNumberMore citations, more likely to be a good paper.TitleTitleTypeSelectAn article, a thesis, or a conference paper.JournalSelectThe journal where the paper is published.AuthorsMulti-selectLinkURLThe Inspire link to the paper.AbstractTextBibtexTextInspire IDTextArxiv IDTextDOITextThe "Type" above is what we call a "property" in Notion. You can add a new
property by clicking+in the database page. Or click an existing property
to modify its type.Open a blank page, it should look like this:To complete the database setup, we need to add the integration to the database.Step 2: Set uphpmTo lethpmadd papers for you, we need to install and initialize it first.pipinstallhep-paper-manager
hpminitIf you want to change the default template, usehpm infoto find the location
of the template file. Then modify the template file directly.Step 3: Add the paper to the databaseUsually, we search for papers on Inspire. The Inspire ID is the number in the
URL.In the command line, we usehpm addto add the paper to the database.hpmadd1405106Let's go back and check the database page. The paper is right there!Of course, you can also add papers by Arxiv ID or DOI.hpmadd1511.05190--id-typearxiv
hpmadd"10.1007/JHEP07(2016)069"--id-typedoiYou can now add more papers to your Notion database.Step 4: Update the paperAfter a while, the paper may have newer information like citation number. You
can update the paper in the database byhpm update.hpmupdate1405106Just likehpm add, you can also update papers by Arxiv ID or DOI.hpmupdate1511.05190--id-typearxiv
hpmupdate"10.1007/JHEP07(2016)069"--id-typedoiNote, the columns in the database but not in the template will not be updated.
So you can add more columns to the database without worrying about losing
information.EnginesInspire: It fetches papers from theInspire HEP.
It serves the default engine forhpm.InspirePaperhas the following
properties:date: strcitations: inttitle: strtype: strjournal: strauthors: list[str]link: strabstract: strbibtex: strinspire_id: strarxiv_id: strdoi: strTemplatesTemplate saves the mapping from paper properties to Notion database properties.
You can adjust the properties within the template.Below is the default template forInspireengine which holds all properties
ofInspirePaper:paper.ymlengine:Inspiredatabase_id:<database_id>properties:date:Datecitations:Citationstitle:Titletype:Typejournal:Journalauthors:Authorslink:Linkabstract:Abstractbibtex:Bibtexinspire_id:Inspire IDarxiv_id:Arxiv IDdoi:DOIThese properties match the properties of the InpspirePaper class. You can
modify the template to fit your needs.! Remember the last three lines are necessary. You can't remove them.Updatesv0.2.2Fix the error whenhpm addsome conference papers that may have no publication info.v0.2.1Fix the bug thathpm addonly checks the first 100 pages in the database.Fix the checkmark style.v0.2.0Refactor the codebase by introducingnotion_database.Addhpm updateto update one paper in the database.Addhpm infoto show the information of this app.v0.1.4Update print style.Add friendly error message when thedatabase_idis not specified.v0.1.3Updatehpm addto check if the paper already exists in the database.You can now create a database with more properties then the template.v0.1.2Update paper from Inspire engine to include url, bibtex, and source.v0.1.1Addhpm initfor interactive setup.Addhpm addfor adding a paper to a Notion database.Introduce the defaultInspireengine andpaper.ymltemplate.