June 02, 2018

From json resume to json cv - part 1

I’ve been looking at ways to extend json resume to cover more of the common elements in an academic cv. Here’s a little bit of a start: json cv and here are some notes on the changes so far:

multiple positions at the same institution

Currently, json resume only supports listing a single job title for each institution:

json resume - position

"position": "YourTitle",

This works fine, unless you want to list multiple roles or job titles at the same institution. In json resume, you would have to create repeat entries for the same institution each time your job title changes. There are some threads suggesting changing position to an array, but the proposals were not adopted.

json cv - position or positions

json cv takes the array approach for positions, allowing you to either keep the simple approach above, or list multiple positions as an array:

"positions": [
    {
	"title": "YourTitle",
	"startDate": "2017-01-01",
	"endDate": "Present"
    },
    {
	"title": "YourPreviousTitle",
	"startDate": "2016-01-01",
	"endDate": "2016-12-31"
    }

publications and presentations

The next challenge is the limited set of data available to describe publications. There’s just not enough here to generate a formatted citation. There also doesn’t seem to be a way to list multiple authors for a publication:

json resume - publications

"publications": [
	{
	"name": "PublicationTitle",
	"publisher": "PublisherName",
	"releaseDate": "2014-10-01",
	"website": "http://your-publication-doi.org",
	"summary": "Description..."
	}
],

I had initially considered integrating CSL JSON, which is likely the best and most robust approach, but the massive number of fields and level of detail seemed a bit daunting.

For now, json cv tries to balance all this by adding citation format fields and an array for authors for each publication:

json cv - publications

"publications": [
		{
        "name": "PublicationTitle1",
		"publisher": "PublisherName1",
		"releaseDate": "2014-10-01",
		"website": "http://your-publication-doi.org",
		"summary": "Description1...",
		"authors": [
		    "FirstAuthorName",
            "SecondAuthorName"
        ],
		"citations": [
		  {
          "APA": "Full-APA-Citation",
          "MLA": "Full-MLA-Citation"
		  }
        ]
		}
],

json cv - presentations

For the related challenge of presentations, json cv adds a new set of fields, modelled after publications:

"presentations": [
		{
        "name": "PresentationTitle",
		"meetingName": "PublisherName1",
		"meetingLocation": "MeetingLocation1",
		"date": "2014-10-01",
		"website": "http://your-publication-doi.org",
		"abstract": "Description1...",
		"presenters": [
            "FirstAuthorName",
			"SecondAuthorName"
        ],
		"citations": [
		{
			"APA": "YourTitle",
			"MLA": "2015-01-01"
		}
        ]
		}
],

A little bit of duplication of information, but perhaps satisfactory for now?