Pelican BibTeX Reader: A Plugin for Pelican
====================================================
[](https://pypi.org/project/pelican-bibtex-reader/)
A Pelican reader to process BibTeX files
Installation
------------
This plugin can be installed via:
python -m pip install pelican-bibtex-reader
Usage
-----
This plugin uses [python-bibtexparser](https://github.com/sciunto-org/python-bibtexparser) to parse properly formatted BibTeX files for use in
[Pelican](https://getpelican.com/). Just put a BibTeX file
with ending `.bib` anywhere in your content directory.
The content provided by this plugin consists of only a
crude HTML rendering of the key-value pairs of each
entry. However, the full bibtex database is available
as Python object in the metadata of the page (key: `bibtexdatabase`).
Using an appropriate template, nice lists of literature
can be rendered, easily. Check out [the literature list on my homepage](https://andreas.fischer-family.online/pages/publications.html)
for an example.
Metadata needed for Pelican
(such as the title, the date, or the template to be used)
can be added at the top of the `.bib`-file, using the following syntax:
```
% Title: Some title
% Date: 01.02.2023
% ...
% Feel free to write anything else; only
% key: value
% pairs are parsed. All other comments are ignored.
@MISC{...}
```
Contributing
------------
Contributions are welcome and much appreciated. Every little bit helps. You can contribute by improving the documentation, adding missing features, and fixing bugs. You can also help out by reviewing and commenting on [existing issues][].
To start contributing to this plugin, review the [Contributing to Pelican][] documentation, beginning with the **Contributing Code** section.
[existing issues]: https://github.com/balanceofcowards/pelican-bibtex-reader/issues
[Contributing to Pelican]: https://docs.getpelican.com/en/latest/contribute.html
License
-------
This project is licensed under the AGPL-3.0 license.
Raw data
{
"_id": null,
"home_page": "https://github.com/balanceofcowards/pelican-bibtex-reader",
"name": "pelican-bibtex-reader",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.6.2,<4.0",
"maintainer_email": "",
"keywords": "pelican,plugin,bibtex",
"author": "Andreas Fischer",
"author_email": "_@ndreas.de",
"download_url": "https://files.pythonhosted.org/packages/16/7e/db17741715ea4c8b4c748c396e01d207e545c8202ae312a0fc833f3b1373/pelican_bibtex_reader-0.1.1.tar.gz",
"platform": null,
"description": "Pelican BibTeX Reader: A Plugin for Pelican\n====================================================\n\n[](https://pypi.org/project/pelican-bibtex-reader/)\n\n\nA Pelican reader to process BibTeX files\n\nInstallation\n------------\n\nThis plugin can be installed via:\n\n python -m pip install pelican-bibtex-reader\n\nUsage\n-----\n\nThis plugin uses [python-bibtexparser](https://github.com/sciunto-org/python-bibtexparser) to parse properly formatted BibTeX files for use in\n[Pelican](https://getpelican.com/). Just put a BibTeX file\nwith ending `.bib` anywhere in your content directory.\n\nThe content provided by this plugin consists of only a\ncrude HTML rendering of the key-value pairs of each\nentry. However, the full bibtex database is available\nas Python object in the metadata of the page (key: `bibtexdatabase`).\nUsing an appropriate template, nice lists of literature\ncan be rendered, easily. Check out [the literature list on my homepage](https://andreas.fischer-family.online/pages/publications.html)\nfor an example.\n\nMetadata needed for Pelican \n(such as the title, the date, or the template to be used)\ncan be added at the top of the `.bib`-file, using the following syntax:\n\n```\n% Title: Some title\n% Date: 01.02.2023\n% ...\n% Feel free to write anything else; only\n% key: value\n% pairs are parsed. All other comments are ignored.\n\n@MISC{...}\n```\n\nContributing\n------------\n\nContributions are welcome and much appreciated. Every little bit helps. You can contribute by improving the documentation, adding missing features, and fixing bugs. You can also help out by reviewing and commenting on [existing issues][].\n\nTo start contributing to this plugin, review the [Contributing to Pelican][] documentation, beginning with the **Contributing Code** section.\n\n[existing issues]: https://github.com/balanceofcowards/pelican-bibtex-reader/issues\n[Contributing to Pelican]: https://docs.getpelican.com/en/latest/contribute.html\n\nLicense\n-------\n\nThis project is licensed under the AGPL-3.0 license.\n",
"bugtrack_url": null,
"license": "AGPL-3.0",
"summary": "A Pelican reader to process BibTeX files",
"version": "0.1.1",
"project_urls": {
"Documentation": "https://docs.getpelican.com",
"Funding": "https://donate.getpelican.com/",
"Homepage": "https://github.com/balanceofcowards/pelican-bibtex-reader",
"Issue Tracker": "https://github.com/balanceofcowards/pelican-bibtex-reader/issues",
"Repository": "https://github.com/balanceofcowards/pelican-bibtex-reader"
},
"split_keywords": [
"pelican",
"plugin",
"bibtex"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "b5fa8d9f76ea6df30217c79cfa2b1ae69345a2680d9ddf53f36dbf59d8ba914d",
"md5": "234a4038aefc22aa41135d0f7c4629a7",
"sha256": "56382841a831181b7bb5ed17dc5f5c07e66361600eb12e96bd9b04a4983f6639"
},
"downloads": -1,
"filename": "pelican_bibtex_reader-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "234a4038aefc22aa41135d0f7c4629a7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.6.2,<4.0",
"size": 16691,
"upload_time": "2023-06-28T08:08:06",
"upload_time_iso_8601": "2023-06-28T08:08:06.355807Z",
"url": "https://files.pythonhosted.org/packages/b5/fa/8d9f76ea6df30217c79cfa2b1ae69345a2680d9ddf53f36dbf59d8ba914d/pelican_bibtex_reader-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "167edb17741715ea4c8b4c748c396e01d207e545c8202ae312a0fc833f3b1373",
"md5": "fae0cd4098cb80ead14135d2e68cbfe2",
"sha256": "ecb749eaab16c74b8f1ebf70f8935e7b9a04562a106994fce96cf985c043e041"
},
"downloads": -1,
"filename": "pelican_bibtex_reader-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "fae0cd4098cb80ead14135d2e68cbfe2",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.6.2,<4.0",
"size": 15781,
"upload_time": "2023-06-28T08:08:08",
"upload_time_iso_8601": "2023-06-28T08:08:08.006421Z",
"url": "https://files.pythonhosted.org/packages/16/7e/db17741715ea4c8b4c748c396e01d207e545c8202ae312a0fc833f3b1373/pelican_bibtex_reader-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-06-28 08:08:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "balanceofcowards",
"github_project": "pelican-bibtex-reader",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [],
"tox": true,
"lcname": "pelican-bibtex-reader"
}
JSON
