Zotero citations in Markdown - publishing to ePub or PDF


Zotero logo.

Mostly notes to myself - I hope you find them useful. So, you want to write your dissertation or thesis in Markdown. But how do you manage all your citations? Install Zotero Install the Better BibTex plugin Restart Zotero. The BBT plugin will launch a configuration screen - use it to set your preferences Install VS Code (or VS Codium) Install the VS Code Zotero plugin Now, when you want to enter a citation in Markdown, the combined plugins will generate something like this: ## Abstract …

Continue reading →

Check if your code is cited in academic works


List of citations, including one of mine.

I am a vain man. For a few years, I've been tracking academic papers which cite my blog posts. Recently, someone let me know that they'd found one of GitHub repos in a paper they'd read. It hadn't even occurred to me to search for those! So, shove your GitHub URl into Google Scholar - https://scholar.google.com/scholar?q=github.com/edent - and you'll see if any repos have made it into academia. Have you spotted any of your code in interesting places? Let me know in the comments ☺ Leigh D…

Continue reading →

Where is the original "Overview of SHARD" paper?


A citation in a modern paper.

One thing I'm finding extremely frustrating in academia is the number of people citing papers which don't seem to actually exist. As part of a data analytics class, I'm learning about "database sharding". That is, the process of splitting data between multiple machines. But where does the term come from? Wikipedia - the source of all truth - says: In a database context, most recognize the term "shard" is most likely derived from either one of two sources: Computer Corporation of America's …

Continue reading →

Zotero Citations to Markdown Links via CSL


Zotero logo.

I use Zotero to manage my references. Instead of in-text citations of (Smith, 1984) - I want that to be hyperlinked to the academic paper referenced. For example ([Smith, 1984](https://doi.org/.....)) This is possible, if you're willing to hack around with CSL - the Citation Style Language. Here's a fragment of CSL that I've adapted from Brenton M. Wiernik's zotero-tools/apa-doi-in-text.csl <macro name="url-intext"> <choose> <if…

Continue reading →

Convert DOI to a HTML5 / Schema citation


The DOI logo.

This is a quick and dirty way to turn a DOI (Digital Object Identifiers for academic papers) into an HTML & Microdata citation. I use this to power my Citations page. Schema.org is a Microdata standard which allows machines to read your HTML and create semantic relations between documents. Here's a minimum viable citation: <blockquote itemprop="citation" itemscope itemtype="http://schema.org/ScholarlyArticle"> <span itemprop="author" itemscope itemtype="http://schema.org/Person"> …

Continue reading →

Quoting Page Numbers from eBooks Considered Harmful


It emerged this morning that the Guardian newspaper has realised that the way it writes is unsuitable for the web. Source: Guardian Newspaper, 18/11/2011, page http://www.guardian.co.uk/media/mind-your-language/2011/feb/18/mind-your-language-day-date-time By using non-specific language, I have introduced a degree of ambiguity which makes it hard for reader - both in the present day and the future - to understand the ideas I am trying to convey. For example - the above text doesn't state…

Continue reading →