https://github.com/adamreeve/pelican_publications

A Pelican plugin that adds an RST directive for including a BibTeX publication list
https://github.com/adamreeve/pelican_publications

Last synced: 2 months ago
JSON representation

A Pelican plugin that adds an RST directive for including a BibTeX publication list

• Host: GitHub
• URL: https://github.com/adamreeve/pelican_publications
• Owner: adamreeve
• License: mit
• Created: 2014-09-21T01:36:03.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2015-09-13T08:51:22.000Z (over 9 years ago)
• Last Synced: 2024-04-23T13:35:19.991Z (9 months ago)
• Language: Python
• Size: 133 KB
• Stars: 2
• Watchers: 4
• Forks: 3
• Open Issues: 0
• Metadata Files:
  • Readme: README.rst
  • License: LICENSE

Awesome Lists containing this project

README

        
A plugin for the Pelican_ static website generator that

embeds a BibTeX publication list in a page or article

using a ``publications`` restructured text directive.

Usage::

    .. publications:: path/to/publications.bib

        :template: path/to/publications.html

        :sort: date

By default pelican_publications uses a ``publications`` template

in the Pelican theme. This can be overridden by setting

the template option as a path to a Jinja2 template.

The template is passed one parameter, ``publications``, which is

a list of BibTeX entries.

These BibTeX entries are simple dictionaries

in the format used by the bibtexparser_ Python package, with a few

customisations such as converting page ranges to use an html en dash

and splitting the author field into a list of authors.

Possible sort options are:

date

    Sort by publication date (this is the default).

key

    Sort by BibTeX key.

name

    Sort by author names.

.. _Pelican: http://docs.getpelican.com

.. _bibtexparser: https://bibtexparser.readthedocs.org