Skip to content

Commit 92a134f

Browse files
committed
Adopt main README for version 2.0
1 parent c2a3b6a commit 92a134f

File tree

3 files changed

+26
-23
lines changed

3 files changed

+26
-23
lines changed

README.md

Lines changed: 20 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
# django-admin-sortable2
22

3-
A replacement for django-admin-sortable using an unintrusive approach.
3+
This Django package adds functionality for generic drag-and-drop ordering of items in the List, the Stacked- and the
4+
Tabular-Inlines Views of the Django Admin interface.
45

56
[![Build Status](https://github.com/jrief/django-admin-sortable2/actions/workflows/django.yml/badge.svg)](https://github.com/jrief/django-admin-sortable2/actions/workflows/django.yml)
67
[![PyPI version](https://img.shields.io/pypi/v/django-admin-sortable2.svg)](https://pypi.python.org/pypi/django-admin-sortable2)
@@ -9,42 +10,40 @@ A replacement for django-admin-sortable using an unintrusive approach.
910
[![Downloads](https://img.shields.io/pypi/dm/django-admin-sortable2.svg)](https://img.shields.io/pypi/dm/django-admin-sortable2.svg)
1011
[![Software license](https://img.shields.io/pypi/l/django-admin-sortable2.svg)](https://github.com/jrief/django-admin-sortable2/blob/master/LICENSE)
1112

12-
This plugin is a generic drag-and-drop ordering module for sorting objects in the List, the Stacked-
13-
and the Tabular-Inlines Views in the Django Admin interface.
13+
Check the demo:
1414

15-
![Demo](https://raw.githubusercontent.com/jrief/django-admin-sortable2/master/demo.gif)
15+
![Demo](https://raw.githubusercontent.com/jrief/django-admin-sortable2/master/docs/source/_static/django-admin-sortable2.gif)
1616

17-
This module offers simple mixin classes which enrich the functionality of any existing class derived
18-
from `admin.ModelAdmin`, `admin.StackedInline` or `admin.TabularInline`.
17+
This library offers simple mixin classes which enrich the functionality of any existing class inheriting from
18+
`admin.ModelAdmin`, `admin.StackedInline` or `admin.TabularInline`.
1919

20-
Thus it makes it very easy to integrate with existing models and their model admin interfaces.
21-
Existing models can inherit from `models.Model` or any other class derived thereof. No special
22-
base class is required.
20+
It thus makes it very easy to integrate with existing models and their model admin interfaces. Existing models can
21+
inherit from `models.Model` or any other class derived thereof. No special base class is required.
2322

2423

25-
## Project's home
24+
## Version 2.0
2625

27-
https://github.com/jrief/django-admin-sortable2
26+
This is a major rewrite of this **django-admin-sortable2**. It replaces the client side part against
27+
[Sortable.JS](https://sortablejs.github.io/Sortable/) and thus the need for jQuery.
2828

29-
Detailled documentation on [ReadTheDocs](http://django-admin-sortable2.readthedocs.org/en/latest/).
29+
Replacing that library allowed me to add a new feature: Multiple items can now be dragged and dropped together.
3030

31-
To ask questions or reporting bugs, please use the [issue tracker](https://github.com/jrief/django-admin-sortable2/issues).
3231

32+
## Project's Home
3333

34-
## Why should You use it?
34+
https://github.com/jrief/django-admin-sortable2
3535

36-
All available plugins which add functionality to make list views for the Django admin interface
37-
sortable, offer a base class to be used instead of `models.Model`. This abstract base class then
38-
contains a hard coded position field, additional methods, and meta directives.
36+
Detailled documentation can be found on [ReadTheDocs](https://django-admin-sortable2.readthedocs.org/en/latest/).
3937

40-
This inhibits to create sortable abstract models. **django-admin-sortable2** does not have these
41-
restrictions.
38+
To ask questions or reporting bugs, please read the [contributor's guide](https://django-admin-sortable2.readthedocs.io/en/latest/contributing.html).
4239

4340

4441
## License
4542

46-
MIT licensed.
43+
Licensed under the terms of the MIT license.
4744

48-
Copyright © 2013-2021 Jacob Rief and contributors.
45+
Copyright © 2013-2022 Jacob Rief and contributors.
4946

47+
Please follow me on
5048
[![Twitter Follow](https://img.shields.io/twitter/follow/jacobrief.svg?style=social&label=Jacob+Rief)](https://twitter.com/jacobrief)
49+
for updates and other news.

docs/source/contributing.rst

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -98,11 +98,15 @@ that such a feature is merged.
9898

9999
You can use that extra code to adopt the test suite.
100100

101-
Remember: For UI-centric applications such as this one, where the client- and server-side are
101+
*Remember*: For UI-centric applications such as this one, where the client- and server-side are
102102
strongly entangled with each other, I prefer end-to-end tests way more rather than unit tests.
103103
Reason is, that otherwise I would have to mock the interfaces, which itself is error-prone and
104104
additional work.
105105

106+
*Don't hide yourself*: I will not accept large pull requests from anonymous users, so please publish
107+
an email address in your GitHub's profile. Reason is that when refactoring the code, I must be
108+
able to contact the initial author of a feature not added by myself.
109+
106110

107111
Quoting
108112
=======

setup.py

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -45,7 +45,7 @@ def readfile(filename):
4545
install_requires=[
4646
'Django>=4.0',
4747
],
48-
packages=find_packages(exclude=['testapp', 'docs']),
48+
packages=find_packages(exclude=['client', 'testapp', 'docs']),
4949
include_package_data=True,
5050
zip_safe=False,
5151
)

0 commit comments

Comments
 (0)