An MkDocs plugin that enables managing citations with BibTex
Project description
mkdocs-bibtex
A MkDocs plugin for citation management using bibtex.
Setup
Install the plugin using pip:
pip install mkdocs-bibtex
Next, add the following lines to your mkdocs.yml:
plugins:
- search
- bibtex:
bib_file: "refs.bib"
cite_style: "pandoc"
If you have no
pluginsentry in your config file yet, you'll likely also want to add thesearchplugin. MkDocs enables it by default if there is nopluginsentry set.
Options
bib_file- Name of your bibtex file. Either the absolute path or the path relative tomkdocs.ymlbib_dir- Directory for bibtex files to load, same as above for path resolutioncite_style- The way you place citations into text: "pandoc" for[@myRef]and "plain" for@myRefbib_command- The command for your bibliography, defaults to\bibliographyfull_bib_command- The command for your bibliography, defaults to\full_bibliographycsl_file- Bibtex CSL file to format the citation with, defaults to None, using a built in plain format instead
Usage
In your markdown files:
- Add your citations as you would normally using either "plain" or "pandoc" style
- Add in
\bibliographyor whatever you set yourbib_commandto where you want your references. - Add in
\full_bibliographyor whatever you set yourfull_bib_commandto where you want the full set of references. Note: This is not guaranteed to work yet since one issue is the order in which markdown files are processed. Might need to do something using theon_files()event first. - (Optional) Setup
csl_fileto control the citation text formatting.
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
mkdocs-bibtex-0.3.0.tar.gz
(10.0 kB
view details)
Built Distribution
File details
Details for the file mkdocs-bibtex-0.3.0.tar.gz.
File metadata
- Download URL: mkdocs-bibtex-0.3.0.tar.gz
- Upload date:
- Size: 10.0 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | b97a484e2927921c58f8b6b7d32b2d845b2d5738e74ad086a4aaf3d1c2911f59 |
|
| MD5 | faef10f646f93dd7a013ca1a1fc4aba3 |
|
| BLAKE2b-256 | b100dc98658fe852932dbb02c53687f8f5e776d8c2946105c14fe85bdf9ba1f2 |
File details
Details for the file mkdocs_bibtex-0.3.0-py3-none-any.whl.
File metadata
- Download URL: mkdocs_bibtex-0.3.0-py3-none-any.whl
- Upload date:
- Size: 7.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/3.2.0 pkginfo/1.5.0.1 requests/2.24.0 setuptools/47.1.1 requests-toolbelt/0.9.1 tqdm/4.46.1 CPython/3.8.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 | 1f00604d1cfad5f9b9a4d2b1513cfc0aa5ac7f0a1e092cdc341aac0e044eacaf |
|
| MD5 | b9791bd62c4e220b50d1671ebb879602 |
|
| BLAKE2b-256 | 570cc1447376ea8d536eccd4da452725517eb48eee26fd6cf8fa9afe47dfa1c7 |
