# @citedrive/codemirror-lang-bibtex [ [**WEBSITE**](https://codemirror.net/) | [**ISSUES**](https://github.com/citedrive/codemirror-lang-bibtex/issues) | [**FORUM**](https://discuss.codemirror.net/c/next/) | [**CHANGELOG**](https://github.com/citedrive/codemirror-lang-bibtex/releases) ] This package implements BibTeX language support for the [CodeMirror](https://codemirror.net/) code editor. The [project page](https://codemirror.net/) has more information, a number of [examples](https://codemirror.net/examples/) and the [documentation](https://codemirror.net/docs/). This code is released under an [MIT license](https://github.com/citedrive/codemirror-lang-bibtex/tree/main/LICENSE). ## Usage ```javascript import { EditorView, basicSetup } from "codemirror"; import { bibtex } from "@citedrive/codemirror-lang-bibtex"; const view = new EditorView({ parent: document.body, doc: `fmt.Println("hello world")`, extensions: [basicSetup, bibtex()], }); ``` ## API Reference

bibtex(config⁠?: {biblatex⁠?: boolean, smartSuggest⁠?: boolean, snippetRecs⁠?: boolean, syntaxLinter⁠?: boolean, keywords⁠?: readonly string[]} = {}) → LanguageSupport

BibTeX language support with BibLaTeX dialect support, autocompletion configuration, and snippets for both BibTeX and BibLaTeX that are suggested based on the editor context.

There are configuration options for the following:

BibTeX vs BibLaTeX language support:
- default: biblatex: false
- defaults to BibTeX
Snippet Smart-Suggestion:
- default: smartSuggest: true
- The smart-suggestion feature only suggests snippets for bibliography entries (i.e. @article = {...}) when the user is not currently editing an entry and only suggests snippets for bibliography fields (i.e. author = {Donald Knuth}) when the user is currently editing an entry.
Opinionated Snippets:
- default: snippetRecs: true
- Snippets have been scaffolded as per the current BibTeX/BibLaTeX specs. The snippet render config, exclusion of certain snippets, and entry snippets' suggestion of recommendation/optional fields are done in an opinionated manner (suggestions are welcome!).
Syntax Linting:
- default: syntaxLinter: true
- Invalid BibTeX (and BibLaTeX) syntax is underlined in red and a warning is issued, thanks to bibtex-tidy.
Custom Keywords:
- default: keywords: []
- Users can specify custom keywords/values that will be auto-suggested when within a FieldValue syntax node.

bibtexLanguage: LRLanguage

BibTeX Language configuration with syntax highlighting, folding, and indentation.

biblatexLanguage: LRLanguage

BibLaTeX Language configuration as a dialect of BibTeX.

bibtexCompletion: Extension

BibTeX autocompletion configuration.

bibtexLinter: Extension

BibTeX syntax linter.