Metadata-Version: 2.1
Name: vitae
Version: 0.1.0
Summary: Tools for academics for building a Curriculum Vitae and other oft-requested documents.
Home-page: https://github.com/josephcslater/vitae
Author: Joseph C. Slater
Author-email: joseph.c.slater@gmail.com
License: UNKNOWN
Keywords: curriculum vitae,academia,cv,resume
Platform: UNKNOWN
Requires-Dist: bibtexparser

vitae
=====

A python module for building curriculum vitae and other documents from a ``bibtex`` file.

I hate formatting citations. It's tedious, and error-prone. Further, when I build my CV, I tend to muck it up and leave something out, mis-sort it, duplicate it accidentally, etc. So, I need a tool to do a better job.

The first function here, ``makemycv``, will take a few arguments and put sorted ``\bibentry`` commands into ``.tex`` files with names corresponding to `BibTeX entry <https://en.wikibooks.org/wiki/LaTeX/Bibliography_Management#BibTeX>`_ types. In doing so, you can then simply use an ``\input`` command to embed all of these citations right in your document in an enumerated environment.

Right now, it only works for a ``bib`` file containing only papers of the CV-writer. I'll fix that eventually.

Eventually I'll put this on ``pypi``, but you can pip install it right now from github:

.. code::

  pip install git+https://github.com/josephcslater/vitae

You'll need the following in the header of your LaTeX cv file.

.. code::

  \usepackage{bibentry}
  \newcommand{\enquote}[1]{``#1''}
  \makeatletter\let\saved@bibitem\@bibitem\makeatother
  \usepackage[colorlinks=true]{hyperref}
  \makeatletter\let\@bibitem\saved@bibitem\makeatother

Then put:

.. code::

  \input{articles.tex}

where you want articles listed, etc.

Then, with your maintained .bib file, in the same location as your cv (for now), open a python terminal,

.. code::

  >>> import vitae
  >>> vitae.makemycv()

will make your ``article.tex`` file along with the other defaults (see the help on ``makemycv``).

If you try ``vitae``, please understand:

a. No warrantee. This is still a work in progress.
b. Please provide your feedback.
c. Please help! I can use help with additional portions.

If you don't use LaTeX, this isn't easy enough for you yet. It's a long ways away. However, `texblog <https://texblog.org>`_` has a decent start in writing a `Resumé in LaTeX <https://texblog.org/2012/04/25/writing-a-cv-in-latex/>`_`. It *doesn't* include the paper inclusion trick being used by ``vitae``.

Future plans
------------

1. Let LaTeX format, then use (internally) `pandoc <http://pandoc.org>`_ to convert citations, and only citations, to any format you want- html, .docx, Markdown, etc.. I just need time to write some parsing scripts. This would have to check for pandoc and balk- leaving users without pandoc to get it installed.

2. Select only article by a specified author (could be a bit dangerous as names aren't as unique as one would think, and this could be error prone/difficult).

3. "dump formatted reverences", with a specificity on number and type.

What else would be nice?


