Bibcite
BibTeX or BibLaTeX like citation for HTML.
Brand new and (probably) full of bugs
Browser Usage
-
Export your library from your favorite reference management software (e.g. Zotero) in the CSL-JSON format (Detailed Explanation).
-
Obtain the Javascript file of Bibcite (e.g. from JSDelivr)
-
Assuming you have an exported
csl-json
file, which we are going to callreferences.json
from now on (but you can use any other filename). And a link to the JS file ofbibcite
(here calledbibcite.js
) you can do the following in an html file<head> <script src="bibcite.js"></script> <bib-config bib="references.json"></bib-config> </head> <body> <p> This is an example of parenthical citation: <bib-cite key="id in references.json"></bib-cite> </p> <bib-references></bib-references> </body>
Configuration Options
-
At the moment there are two citation-styles
alphabetic
(default) andnumeric
you can select them like this:<bib-config bib="references.json" citation-style="numeric"></bib-config>
-
There are three types of citations inspired by BibLaTeX
\textcite
,\parencite
and\rawcite
. You can set thetype
ofbib-cite
to eitherparen-cite
(default)text-cite
orraw-cite
, e.g.<bib-cite key="id_key" type="text-cite"></bib-cite>
Node Module
You can find bibcite
on npm.
Custom Styles
There will be a way to do customization in the future. Styles are Typescript types
type CiteStyle = {
name: string;
order: BibOrder;
enclosing: [string, string];
multiSeparator: string;
identifier: (index: number, bib_data: Data, citeType: CiteType) => string;
bib_entry: (index: number, bib_data: Data) => string;
reference: (content: string) => string;
};
so the numeric style for example is implemented like this:
export const numeric: CiteStyle = {
name: "numeric",
order: { comparison: insertion, inform_citations: true },
enclosing: ["[", "]"],
multiSeparator: ",",
identifier: (index: number, _: Data) => String(index),
bib_entry: (index: number, bib_data: Data) => `
<tr>
<td>[${index}]</td>
<td>
<h3>${bib_data.title}</h3>
<span>${bib_data.author.map((p) => p.family).join(", ")}</span>
<span>(${bib_data.issued["date-parts"][0][0]})</span>
</td>
</tr>
`,
reference: (content: string) =>
`<h2>References</h2>
<table>
${content}
</table>
`,
};
I still need to figure out how to do plugin loading here though.