[](https://www.jsdelivr.com/package/npm/bibcite)
# Bibcite
BibTeX or BibLaTeX like citation for HTML.
> Brand new and (probably) full of bugs
## Browser Usage
1. Export your library from your favorite reference management software (e.g.
[Zotero][zotero]) in the CSL-JSON format ([Detailed
Explanation][export-csl-explanation]).
2. Obtain the Javascript file of Bibcite ([e.g. from JSDelivr][releases])
3. Assuming you have an exported `csl-json` file, which we are going to call
`references.json` from now on (but you can use any other filename). And a link
to the JS file of `bibcite` (here called `bibcite.js`) you can do the following in
an html file
```html
This is an example of parenthical citation:
```
### Configuration Options
1. At the moment there are two citation-styles `alphabetic`(default) and
`numeric` you can select them like this:
```html
```
2. There are three types of citations inspired by BibLaTeX `\textcite`,
`\parencite` and `\rawcite`. You can set the `type` of `bib-cite` to either
`paren-cite` (default) `text-cite` or `raw-cite`, e.g.
```html
```
## Node Module
You can find [`bibcite` on npm][npm-bibcite].
### Custom Styles
There will be a way to do customization in the future. Styles are Typescript
types
```typescript
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:
```typescript
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) => `
| [${index}] |
${bib_data.title}
${bib_data.author.map((p) => p.family).join(", ")}
(${bib_data.issued["date-parts"][0][0]})
|
`,
reference: (content: string) =>
`References
`,
};
```
I still need to figure out how to do plugin loading here though.
[zotero]: https://www.zotero.org/
[export-csl-explanation]: https://github.com/FelixBenning/bibcite/blob/main/docs/export-csl-json.md
[releases]: https://www.jsdelivr.com/package/npm/bibcite
[npm-bibcite]: https://www.npmjs.com/package/bibcite