-
Notifications
You must be signed in to change notification settings - Fork 1
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
- Loading branch information
Showing
2 changed files
with
61 additions
and
21 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,43 +1,83 @@ | ||
========= | ||
django-cv | ||
========= | ||
============== | ||
django-vitae | ||
============== | ||
|
||
Django-CV is a CV generator that can be used with the `Django`_ web framework. | ||
Django-Vitae is a CV generator that can be used with the `Django`_ web framework. | ||
|
||
.. _Django: https://docs.djangoproject.com/ | ||
|
||
Many academics have trouble keeping CVs up to date. Django-CV was created to streamline this process. Django-CV allows users to make highly customizable curricula vitae for use on their websites. The application provides models for common entries on curricula vitae such as education, employment, publications, teaching, and service. Django-CV eliminates many of the repetitive tasks related to producing curricula vitae. The included templates provide a complete CV "out of the box", but allows researchers who might be interested in customizing the format using Django templating language. | ||
Many academics have trouble keeping CVs up to date. Django-Vitae was created to streamline this process. Django-Vitae allows users to make highly customizable curricula vitae for use on their websites. The application provides models for common entries on curricula vitae such as education, employment, publications, teaching, and service. Django-Vitae eliminates many of the repetitive tasks related to producing curricula vitae. The included templates provide a complete CV "out of the box", but allows researchers who might be interested in customizing the format using Django templating language. | ||
|
||
Django-CV uses `semantic versioning`_. Though it aims to provide a complete suite to create a CV, the project does not been tested extensively (and **you** can contribute to that effort!) and pieces might still throw errors. See notes below for quirks and errors in usage that must be resolved. | ||
Django-Vitae uses `semantic versioning`_. Though it aims to provide a complete suite to create a CV, the project does not been tested extensively (and **you** can contribute to that effort!) and pieces might still throw errors. See notes below for quirks and errors in usage that must be resolved. | ||
|
||
.. _semantic versioning: http://semver.org/ | ||
|
||
|
||
Requirements | ||
------------ | ||
|
||
Django-CV is developed and tested in Python 3. It depends on several external packages (other than Django): | ||
Django-Vitae is developed and tested in Python 3. It depends on several external packages (other than Django): | ||
|
||
* `Markdown <https://pypi.org/project/Markdown/>`_ (makes pretty HTML with simple text entries) | ||
* `Nose`_ & `django-nose`_ (used for testing suite) | ||
* `Coverage`_ (used to document testing coverage) | ||
* `citeproc-py <https://pypi.org/project/citeproc-py/>`_ (creates citations formatted according to desired `CSL`_ styles [not yet implemented]) | ||
* `citeproc-py-styles <https://pypi.org/project/citeproc-py-styles/>`_ (adds library of `CSL`_ styles) | ||
|
||
.. _CSL: http://citationstyles.org/ | ||
|
||
Installation | ||
------------ | ||
From `PyPI <https://pypi.org/>`_ for the latest version:: | ||
|
||
pip install django-vitae | ||
|
||
For the latest development version: | ||
|
||
:: | ||
|
||
git clone https://github.com/mikebader/django-vitae | ||
cd django-vitae | ||
python setup.py install | ||
|
||
|
||
|
||
Documentation | ||
------------- | ||
|
||
Limited documentation is available in the ``docs`` directory. | ||
|
||
Testing | ||
------- | ||
To test, you need to install the following packages: | ||
|
||
* `Nose`_ & `django-nose`_ (used for testing suite) | ||
* `Coverage`_ (used to document testing coverage) | ||
|
||
.. _Nose: https://pypi.org/project/nose/ | ||
.. _django-nose: https://pypi.org/project/nose/ | ||
.. _Coverage: https://pypi.org/project/coverage/ | ||
|
||
Testing | ||
------- | ||
An incomplete test suite can be found in the ``tests/`` directory. With `Nose`_ and `Coverage`_ installed, you may run the tests with ``runtests.py``. | ||
:: | ||
|
||
pip install nose | ||
pip install django-nose | ||
pip install coverage | ||
|
||
An incomplete test suite can be found in the ``tests/`` directory. With `Nose`_ and `Coverage`_ installed, you may run the tests with ``runtests.py``. From the ``django-vitae`` root directory: | ||
|
||
:: | ||
|
||
./runtests.py | ||
|
||
|
||
To test only a single model, you may use the flag ``--attr=<model_name>`` for the model (not implemented for all models). For example, to test books, you would use: | ||
|
||
:: | ||
|
||
./runtests.py --attr=book | ||
|
||
|
||
|
||
Use Issues | ||
---------- | ||
|
||
At present, you will have the best luck editing model instances in the ``admin`` interface. You should be able to edit some models in interface implemented in the default templates, but many do not work or are not fully implemented. | ||
|
||
You may find limited documentation in the ``docs/`` directory. | ||
|
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -4,21 +4,21 @@ | |
long_description = f.read() | ||
|
||
setuptools.setup( | ||
name='django-cv', | ||
version='0.0.2.1', | ||
name='django-vitae', | ||
version='0.0.1', | ||
author='Michael Bader', | ||
author_email='[email protected]', | ||
description='A CV generator built for the Django web framework.', | ||
long_description=long_description, | ||
long_description_content_type='text/markdown', | ||
url='https://github.com/mikebader/django-cv', | ||
url='https://github.com/mikebader/django-vitae', | ||
packages=setuptools.find_packages(), | ||
install_requires=[ | ||
'django>=1.11', | ||
'markdown>=2.6', | ||
'citeproc-py>=0.4', | ||
'markdown>=2.6.11', | ||
'citeproc-py>=0.4.0', | ||
'citeproc-py-styles>=0.1.1', | ||
'django-widgets>=0.1.16' | ||
'django-widgets>=-0.1.16' | ||
], | ||
classifiers=[ | ||
'Development Status :: 3 - Alpha', | ||
|