Update Readme

Author: 2ik

README.md

@@ -4,13 +4,18 @@ Django plugin for using [Editor.js](https://editorjs.io/)
 
 > This plugin works fine with JSONField in Django >= 3.1
 
+[![Python versions](https://img.shields.io/pypi/pyversions/django-editorjs-fields)](https://pypi.org/project/django-editorjs-fields/)
+[![Python versions](https://img.shields.io/pypi/djversions/django-editorjs-fields)](https://pypi.org/project/django-editorjs-fields/)
+[![Downloads](https://pepy.tech/badge/django-editorjs-fields/month)](https://pepy.tech/project/django-editorjs-fields/month)
+
 ## Installation
 
 ```bash
 pip install django-editorjs-fields
 ```
 
-Add django_editorjs_fields to INSTALLED_APPS in settings.py for your project:
+Add `django_editorjs_fields` to `INSTALLED_APPS` in `settings.py` for your project:
+
 ```python
 # settings.py
 INSTALLED_APPS = [
@@ -22,6 +27,7 @@ INSTALLED_APPS = [
 ## Usage
 
 Add code in your model
+
 ```python
 # models.py
 from django.db import models
@@ -37,10 +43,32 @@ class Post(models.Model):
 
 Or add custom Editor.js plugins and configs ([List plugins](https://github.com/editor-js/awesome-editorjs))
 
+**django-editorjs-fields** includes this list of Editor.js plugins by default:
+
+```python
+[
+    '@editorjs/paragraph',
+    '@editorjs/image',
+    '@editorjs/header',
+    '@editorjs/list',
+    '@editorjs/checklist',
+    '@editorjs/quote',
+    '@editorjs/raw',
+    '@editorjs/code',
+    '@editorjs/inline-code',
+    '@editorjs/embed',
+    '@editorjs/delimiter',
+    '@editorjs/warning',
+    '@editorjs/link',
+    '@editorjs/marker',
+    '@editorjs/table',
+]
+```
+
 ```python
 # models.py
 from django.db import models
-from django_editorjs_fields import EditorJsJSONField, EditorJsTextField  # import
+from django_editorjs_fields import EditorJsJSONField, EditorJsTextField
 
 
 class Post(models.Model):
@@ -70,7 +98,8 @@ class Post(models.Model):
 
 ```
 
-If you want to upload images to the editor then add django_editorjs_fields.urls to urls.py for your project:
+If you want to upload images to the editor then add `django_editorjs_fields.urls` to `urls.py` for your project with `DEBUG=True`:
+
 ```python
 # urls.py
 from django.contrib import admin
@@ -79,14 +108,40 @@ from django.conf import settings
 from django.conf.urls.static import static
 
 urlpatterns = [
-    path('admin/', admin.site.urls),
+    ...
     path('editorjs/', include('django_editorjs_fields.urls')),
+    ...
 ] + static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
 ```
 
+In production `DEBUG=False` (use nginx to display images):
+
+```python
+# urls.py
+from django.contrib import admin
+from django.urls import path, include
+
+urlpatterns = [
+    ...
+    path('editorjs/', include('django_editorjs_fields.urls')),
+    ...
+]
+```
+
 See an example of how you can work with the plugin [here](https://github.com/2ik/django-editorjs-fields/blob/main/example)
 
+## Configure
+
+The application can be configured by editing the project's `settings.py`
+file.
+
+| Key                            | Description                                                                     | Default                                                |
+| ------------------------------ | ------------------------------------------------------------------------------- | ------------------------------------------------------ |
+| `EDITORJS_IMAGE_UPLOAD_PATH`   | Path uploads images                                                             | `settings.MEDIA_URL + 'uploads/images/'`               |
+| `EDITORJS_IMAGE_NAME_ORIGINAL` | To use the original name of the image file?                                     | `False`                                                |
+| `EDITORJS_IMAGE_NAME_POSTFIX`  | Image file name postfix. Ignored when `EDITORJS_IMAGE_NAME_ORIGINAL` is `True`  | `token_urlsafe(5) # from secrets import token_urlsafe` |
+| `EDITORJS_IMAGE_NAME`          | Image file name postfix. Ignored when `EDITORJS_IMAGE_NAME_ORIGINAL` is `False` | `token_urlsafe(8) # from secrets import token_urlsafe` |
 
 ## Support and updates
 
-Use github issues https://github.com/2ik/django-editorjs-fields/issues
+Use github issues https://github.com/2ik/django-editorjs-fields/issues