Metadata-Version: 2.1
Name: pybib2web
Version: 0.3
Summary: A translator of BibTeX to HTML.
Home-page: https://gitlab.com/sosy-lab/software/pybib2web
Author: Dirk Beyer
Author-email: dirk.beyer@sosy-lab.org
License: Apache-2.0
Project-URL: Changelog, https://gitlab.com/sosy-lab/software/pybib2web/-/blob/master/CHANGELOG.md
Project-URL: Issue Tracker, https://gitlab.com/sosy-lab/software/pybib2web/-/issues
Keywords: bibliography,BibTeX
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Topic :: Text Processing :: Markup :: LaTeX
Description-Content-Type: text/markdown
License-File: LICENSES/Apache-2.0.txt

<!--
This file is part of pybib2web, a translator of BibTeX to HTML.
https://gitlab.com/sosy-lab/software/pybib2web

SPDX-FileCopyrightText: 2021 Dirk Beyer <https://www.sosy-lab.org>

SPDX-License-Identifier: Apache-2.0
-->

# pybib2web

Convert BibTeX .bib files into a directory of HTML files.

The created HTML provide individual HTML pages for publications by
year, publication type (category), author, keyword, and funding.
A single-page view is also available.
pybib2web provides semantics and easy customizability of each BibTeX element
through HTML ids and classes.

## Requirements

- python 3.8

### Optional requirements

`detex` is required to detexify BibTeX-entries that use LaTeX commands,
e.g., `\sc{}` or `~`.


## Installation

After cloning the repository, run `pip install -e .` to install pybib2web and its dependencies.


## Usage

Run `pybib2web --help` to show all available command-line options.

Basic usage:

```
pybib2web BIBFILE(s)
```

This will write a directory of HTML files to `bib/`.
The index of these files is `bib/index.html`.

This will, among other things, create
an individual publication page for all authors that appear in the given BibTeX files.
Often, one only wants to create these author-centered pages for individual authors-
for example for oneself or a specific group of people.
pybib2web can be configured through a [config file](doc/config.yml) to do this:

```
pybib2web --config CONFIG_YAML BIBFILE(s)
```


