publist

managing my list of publications, talks, reviews
git clone https://a3nm.net/git/publist/
Log | Files | Refs | README | LICENSE

README (4621B)


      1 # Publist -- managing my list of publications, talks, reviews
      2 
      3 This is what I use as an academic to maintain my list of publications, talks,
      4 reviews.
      5 
      6 This is (C) Antoine Amarilli and BSD-licensed, see LICENSE
      7 
      8 Warning: This is extremely dirty code written for my personal use and only
      9 shared in case it's useful to someone, please do not judge me too harshly for
     10 it.
     11 
     12 Warning: This documentation was written to give a minimal idea of what the
     13 system does, but will probably not be kept up-to-date.
     14 
     15 Warning: The idea of maintaining publication lists, etc., is a conservative idea
     16 that means you are playing by the rules of the academic system. While I need to
     17 do it professionally, I don't mean to imply that this is a good idea. It is
     18 probably a better idea to write a high-level understandable summary of your
     19 research. For more about what I think of the academic system, see:
     20 https://a3nm.net/work/research/wrong/
     21 
     22 ## Input files
     23 
     24 The system generates French and English output.
     25 
     26 The following files are the input to the system. As a general principle, they
     27 consist of a list of records (each of which is a paragraph), and every record
     28 consist of key-value pairs separated by ':'. For many keys, a localized version
     29 exists to give the same info in French, e.g., "Location" contains the English
     30 name of a location, and "LocationFr" contains the French name.
     31 
     32 - authors: list of authors, with an id, name, website URL (using academic
     33   websites if they exist, otherwise some choice of a DBLP page or a Wayback
     34   machine copy of a former academic website)
     35 
     36 - venues: list of conferences and journals, with an id (the name is inferred
     37   automatically from the id), optional name, type (conference, journal,
     38   workshop, school), publisher, open-access or not, location, URL, audience
     39   (national or international)
     40 
     41 - reviews: list of places I reviewed, with the role (pc, spc for senior pc,
     42   pc_demos for being a PC member for demos, misc for having done misc reviews)
     43 
     44 - talks: ordered list of talks I gave (latest first), with a title, date, venue
     45   (can be a conference ID or seminar name), optional link to a poster, optional
     46   location, optional place, URLs of the venue, place, misc to add some
     47   annotation, and a dirty system with the "$TEAM" placeholder to indicate a team
     48   and URL for a team, etc.
     49 
     50 - publis: ordered list of my publications (latest first), with an id (bibtex
     51   key), oldid (used for a space-separated list of former ids of the paper, to
     52   avoid breaking anchors), a title, a space-separated list of authors, an
     53   optional venue, an indication of if the paper was reviewed or not, is a "main"
     54   paper or not (controls whether it goes, e.g., in the résumé), should be hidden
     55   from the résumé or not (key "hidecv" or "oldcv"), a type (demo, shortpaper,
     56   etc.), possible links to slides, posters, videos, code, possible information
     57   about the authors of this extra material, option to indicate the existence of
     58   errata (will generate special links to the errata)
     59 
     60 My own files are versioned together with the code, of course if you adapt it you
     61 will want to run the code on your own files.
     62 
     63 ## Other files
     64 
     65 These files are not used yet:
     66 
     67 - interviews: list of interviews given
     68 - others: list of other kinds of service
     69 
     70 ## Invocation
     71 
     72 Run: ./make.sh
     73 
     74 This will run the various python scripts, and run a LaTeX compilation for the
     75 PDF publication lists
     76 
     77 ## Generated files
     78 
     79 - main.bib: bibtex file containing all publications, featuring keywords used for
     80   filtering in the publication lists, and featuring hyperlinks to papers,
     81   authors, venues
     82 
     83 - publis_fr.txt and publis_en.txt: plain text publication listing
     84 
     85 - publist_en.pdf and publist_fr.pdf: CNRS-style accepted publication lists, with papers
     86   ordered by types, then by date, with global numbering
     87 
     88 - publis_all.html.en and publis_all.html.fr: HTML+Markdown snippets with
     89   accepted publications listed chronologically and grouped by year
     90 
     91 - publis_main.html.en and publis_main.html.fr: the same but only for the main
     92   publications and without the year headings (but also including publications
     93   not yet accepted)
     94 
     95 - reviews.tex: a LaTeX snippet for a CV indicating the reviews (only listing
     96   open-access venues)
     97 
     98 - reviews_en.html and reviews_fr.html: an HTML snippet for the same purpose
     99 
    100 - selectpubli_en.tex: a LaTeX snippet for a CV indicating the main publications
    101 
    102 - talks_all.html.en and talks_all.html.fr: a HTML+Markdown snippet with the
    103   past talks, listed chronologically and grouped by year
    104 
    105 - talks_last.html.en and talks_last.html.fr: the same but only for the latest
    106   talks (and also including upcoming talks)