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) looking like this

https://cdn.jsdelivr.net/npm/[email protected]/dist/bibcite.min.js

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

<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) and numeric 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 the type of bib-cite to either paren-cite (default) text-cite or raw-cite, e.g.
```
<bib-cite key="id_key" type="text-cite"></bib-cite>
```

Examples

The following body

		<h1>My Page</h1>	
		<p> The next two citations are <code>paren-cite</code> citations
			<bib-cite type="paren-cite" key="mas-colellMicroeconomicTheory1995"></bib-cite>
			<bib-cite type="paren-cite" key="amirEffectsEntryCournot2000"></bib-cite>.
		</p>
		<p>
			The following is a <code>text-cite</code> allowing you to use the name in text
			<bib-cite type="text-cite" key="mas-colellMicroeconomicTheory1995"></bib-cite>.
		</p>
		<p>
			And the remaining two are <code>raw-cite</code>
			<bib-cite type="raw-cite" key="amirEffectsEntryCournot2000"></bib-cite>
			<bib-cite type="raw-cite" key="dsouzaParserExtractionTriples2018"></bib-cite>,
		</p>

		<bib-references></bib-references>

depending on the selected style results in the following pages.

Alphabetic style (Default)

<bib-config bib="references.json" citation-style="alphabetic"></bib-config>

Numeric style

<bib-config bib="references.json" citation-style="numeric"></bib-config>

Author-Year Style

<bib-config bib="references.json" citation-style="author-year"></bib-config>

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

// bibcite/styles/types.ts
export type CiteStyle = {
  name: string;
  order: BibOrder;
  enclosing: [string, string];
  multiSeparator: string;
  identifier: (bib_data: Data,index: number, citeType: CiteType) => string;
  bibEntry: (bib_data: Data) => string;
  metaBibEntry: (bibEntry:string, identifier:string) => string;
  metaReference: (content: string) => string;
};

so the numeric style for example is implemented roughly like this:

//bibcite/styles/numeric.ts
export const numeric: CiteStyle = {
  name: "numeric",
  order: { comparison: insertion, inform_citations: true },
  enclosing: ["[", "]"],
  multiSeparator: ",",
  identifier: (_: Data, index: number) => String(index),
  bibEntry: defaultBibEntry,
  metaBibEntry: (bibEntry:string, identifier:string) => `
    <tr style="vertical-align:top">
        <td>[${identifier}]</td>
        <td>${bibEntry}</td>
    </tr>
    `,
  metaReference: (content: string) =>
    `<h2>References</h2>
    <table>
      ${content}
    </table>
    `,
};

and then added

//bibcite/ctyles/index.ts
addStyle(numeric);

So similarly you should be able to define your own custom styles. I still need to figure out how to do plugin loading here though.

felixbenning / bibcite Goto Github PK

bibcite's Introduction

Bibcite

Browser Usage

Configuration Options

Examples

Alphabetic style (Default)

Numeric style

Author-Year Style

Node Module

Custom Styles

bibcite's People

Contributors

Stargazers

Watchers

bibcite's Issues

Recommend Projects

Recommend Topics

Recommend Org