1191b33dd4c3f7db5e5a547944b3ada212162e84
[django-pagination.git] / doc / changes.rst
1 Version History
2 ***************
3
4 .. _version_2_0_1:
5
6 Version 2.0.1
7 =============
8
9 This is a micro release. There are no code changes so there is no need to
10 upgrade. The only changes are to documentation and infrastructure files.
11
12 The following changes are included:
13
14 * Improve documentation for using custom pagination templates
15 * Document multiple paginations per page
16 * Use correct template name in do_paginate docstring
17 * Provide correct link to installation instructions
18 * Fix documentation referencing all project name
19 * Ignore vim swap files
20 * Add templates from the test project to MANIFEST.in
21
22
23 .. _version_2_0:
24
25 Version 2.0
26 ===========
27
28
29 * Revived the project as a fork of
30   git://github.com/ericflo/django-pagination.git. The project now has a new
31   maintainer (Zygmunt Krynicki) and a new home (on pypi and launchpad).
32
33 * Merged a lot of branches of the old project. In general this was made to show
34   people "here is the new good stuff" and to get as much contributions, back
35   into the trunk, as possible.
36
37 * Merge a lot of translations: de, es, fr, it, nn, no, pl, pt, pt_BR, ru and
38   tr. Translations are still in a bad state (they are not built automatically,
39   they are in incorrect place) but the first step is done.
40
41 * Add support for custom pagination templates. You can now use the optional
42   argument on paginate to use different template::
43
44     {% autopaginate obj_list %}
45     ...
46     {% paginate using "something/custom_template.html" %}
47
48 * Pagination template has support for specific blocks. Those blocks are
49   'previouslink', 'pagelinks' and 'nextlink'.  Make sure to base your template
50   on pagination/pagination.html end extend the blocks you care about.
51
52 * Add support for using multiple paginations on a single page. Simply use
53   multiple autopaginate/paginate tags. The only limitation is that you must use
54   paginate before using the next autopaginate tag. For an example see the test
55   project and the example application inside.
56
57 * Simplify building documentation. To build the documentation simply run
58   `setup.py build_sphinx`. You will need sphinx installed obviously.
59
60 * Simplify running tests. To run tests just invoke `setup.py test`. That's all!
61   This is based on the goodness of django-testproject that simplifies setting
62   up helper projects just for testing.
63
64
65 Version 1.0.7
66 =============
67
68 * Last release from previous upstream developer.