semvec/pypi-packages huggingface dataset:
django-citations 0.3
A simple Django app to include citations and reference lists in your templates.
License: MIT License

================
Django Citations
================

Citations is a simple Django app which lets you use a citations and 
reference lists within your templates. 

 - The source code is available from https://github.com/will-hart/django-citations under an MIT license.  
 - You can find the package on the Python Packing Index https://pypi.python.org/pypi/django-citations/.
 - The latest documentation for the `develop` branch is available from http://django-citations.readthedocs.org/en/latest/

Quick start
-----------

1. Install using::

    pip install django-citations

2. Add "citations" to your INSTALLED_APPS setting like this::

    INSTALLED_APPS = (
        ...
        'citations',
    )

3. Run `python manage.py migrate` to create the models.


Usage
-----

You can use the admin panel to create references for your site.  These can
have a range of details including ISBN, URLs, titles, etc. Each reference 
must have a unique slug.  This is how we will refer to the reference when we
cite it within a template.

To refer to a reference in your database, you first need to load the tags in
your template::

    {% load citation_tags %}

You can then do the following in your template where you want the reference to
appear::

    {% cite "my_reference_slug" %}
    
You can refer to multiple references at a time by just adding new slugs separated by spaces.
Note that quotation marks are required around the slugs, and slug names should not contain 
spaces::

    {% cite "my_first_reference_slug" "my_second_reference_slug" %}
    
If you attempt to reference a work that is not in your reference list a TemplateSyntaxError
will be raised showing the offending reference slug.  

The references will be included in text as numbers - e.g. `[1]`, or `[1, 2]` for multiple
references.  Reference objects will also be placed in the `reference_list` variable of the
template's context.  

A reference list can be included at the bottom of the document::

    {% show_references reference_list %}
    
Importing References
--------------------

If you have the package `bibtexparser` installed then you will have access in the admin
panel to an "Upload Bibtex" button.  This feature will upload a bibtex file, scan it for 
fields that django-citations supports and save new records.

The bibtexparser package is provided under the LGPL.

Change Log
----------

**Version 0.3**
 - Improved documentation
 - Add new fields to database
 - Add bibtex upload function, where `bibtexparser` is installed
 - Add `show_all_references` tag for complete bibliography

**Version 0.2.1**
 - Fix tags in README

**Version 0.2**

 - Improved citation database - more fields available
 - Improved reference output (uses a Harvard referencing format)
 
**Version 1.0**

 - Initial version
kaadbg 0.3.0
Remote debugger runner for kaa
License: MIT License

========================================
kaadbg - Remote debugger runner for kaa
========================================

Kaadbg is a utility to start debugger session with text editor `kaa <https://pypi.python.org/pypi/kaaedit/>`_. Please visit `Python debugger section of kaa document <https://pypi.python.org/pypi/kaaedit/#python-debugger>`_ for usage.

.. contents::
    :depth: 2


Installation
-------------

Use easy_install or pip to install kaadbg from PyPI ::

   $ sudo easy_install -U kaadbg


History
==============

0.0.1 - 2013.6.16
-------------------

- Initial release.

        
Copyright 
=========================

Copyright (c) 2013 Atsuo Ishimoto

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.