New readme

This commit is contained in:
Andy Baker 2015-06-20 13:06:54 +01:00
parent 599d1991c7
commit f101c3410e
2 changed files with 92 additions and 21 deletions

21
README
View File

@ -1,21 +0,0 @@
==================
django-admin-tools
==================
django-admin-tools is a collection of extensions/tools for the default django
administration interface, it includes:
* a full featured and customizable dashboard,
* a customizable menu bar,
* tools to make admin theming easier.
The project code and bugtracker is hosted on
`Bitbucket <http://bitbucket.org/izi/django-admin-tools/>`_.
Django-admin-tools is generously documented, you can
`browse the documentation online
<http://django-admin-tools.readthedocs.org/>`_.
a good start is to read `the quickstart guide
<http://django-admin-tools.readthedocs.org/quickstart.html>`_.
Thanks for downloading django-admin-tools.

92
README.rst Normal file
View File

@ -0,0 +1,92 @@
django-admin-tools
==================
.. image:: https://travis-ci.org/django-admin-tools/django-admin-tools.svg?branch=master
:target: https://travis-ci.org/django-admin-tools/django-admin-tools
django-admin-tools is a collection of extensions/tools for the default django
administration interface, it includes:
* a full featured and customizable dashboard;
* a customizable menu bar;
* tools to make admin theming easier.
The code is hosted on `Github <https://github.com/django-admin-tools/django-admin-tools/>`_.
Django-admin-tools is generously documented, you can
`browse the documentation online
<http://django-admin-tools.readthedocs.org/>`_.
a good start is to read `the quickstart guide
<http://django-admin-tools.readthedocs.org/quickstart.html>`_.
The project was created by `David Jean Louis <http://www.izimobil.org/>`_ and was previously hosted on `Bitbucket <http://bitbucket.org/izi/django-admin-tools/>`_.
Please join the `mailing list <http://groups.google.fr/group/django-admin-tools>`_ if you want to discuss of the future of django-admin-tools.
************
Installation
************
To install django-admin-tools, run the following command inside this directory:
python setup.py install
If you have the Python **easy_install** utility available, you can also type
the following to download and install in one step::
easy_install django-admin-tools
Or if you're using **pip**::
pip install django-admin-tools
Or if you'd prefer you can simply place the included "admin_tools" directory
somewhere on your python path, or symlink to it from somewhere on your Python
path; this is useful if you're working from a Mercurial checkout.
An `installation guide <http://django-admin-tools.readthedocs.org/en/latest/installation.html>`_ is available in the documentation.
*************
Documentation
*************
`Extensive documentation <http://django-admin-tools.readthedocs.org/>`_ is available, it was made with the excellent `Sphinx program <http://sphinx.pocoo.org/>`_
************
Translations
************
There is a `a transifex project <https://transifex.net/projects/p/django-admin-tools/>`_ for django-admin-tools.
************
Screenshots
************
The django admin login screen:
.. image:: http://www.izimobil.org/django-admin-tools/images/capture-1.png
:alt: The django admin login screen
The admin index dashboard:
.. image:: http://www.izimobil.org/django-admin-tools/images/capture-2.png
:alt: The admin index dashboard
The admin menu:
.. image:: http://www.izimobil.org/django-admin-tools/images/capture-3.png
:alt: The admin menu
Dashboard modules can be dragged, collapsed, closed etc.:
.. image:: http://www.izimobil.org/django-admin-tools/images/capture-4.png
:alt: Dashboard modules can be dragged, collapsed, closed etc.
The app index dashboard:
.. image:: http://www.izimobil.org/django-admin-tools/images/capture-5.png
:alt: The app index dashboard