Skip to content

Commit

Permalink
docs update
Browse files Browse the repository at this point in the history
  • Loading branch information
sehmaschine committed Feb 22, 2013
1 parent 8e63b28 commit 71cd35e
Show file tree
Hide file tree
Showing 13 changed files with 36 additions and 31 deletions.
5 changes: 2 additions & 3 deletions README.rst
Expand Up @@ -31,9 +31,8 @@ https://www.transifex.net/projects/p/django-filebrowser/
Releases
--------

* FileBrowser 3.5.2 (Development Version, not yet released, see Branch Stable/3.5.x): Compatible with Django 1.4/1.5
* FileBrowser 3.5.1 (November 09 2012): Compatible with Django 1.4/1.5
* FileBrowser 3.5.0 (July 20 2012): Compatible with Django 1.4
* FileBrowser 3.5.3 (Development Version, not yet released, see Branch Stable/3.5.x)
* FileBrowser 3.5.2 (February 22 2013): Compatible with Django 1.4/1.5
* FileBrowser 3.4.3 (April 2012): Compatible with Django 1.3

Older versions are availabe at GitHub, but are not supported anymore.
5 changes: 1 addition & 4 deletions docs/actions.rst
Expand Up @@ -65,7 +65,4 @@ Some actions may require user confirmation (e.g., in order to prevent accidental

def crop_image(request, fileobjects):
files = '&f='.join([f.path_relative for f in fileobjects])
return HttpResponseRedirect('/confirm/?action=crop_image&f=%s' % files)



return HttpResponseRedirect('/confirm/?action=crop_image&f=%s' % files)
2 changes: 1 addition & 1 deletion docs/admin.rst
Expand Up @@ -261,4 +261,4 @@ Here's a small example for using the above Signals::
print "Filesize:", kwargs['file'].filesize
print "Orientation:", kwargs['file'].orientation
print "Extension:", kwargs['file'].extension
signals.filebrowser_post_upload.connect(post_upload_callback)
signals.filebrowser_post_upload.connect(post_upload_callback)
2 changes: 1 addition & 1 deletion docs/api.rst
Expand Up @@ -443,4 +443,4 @@ Delete all ``VERSIONS``.
``delete_admin_versions()``
^^^^^^^^^^^^^^^^^^^^^^^^^^^

Delete all ``ADMIN_VERSIONS``.
Delete all ``ADMIN_VERSIONS``.
16 changes: 14 additions & 2 deletions docs/changelog.rst
Expand Up @@ -8,16 +8,28 @@
Changelog
=========

3.5.2 (not yet released)
3.5.3 (not yet released)
------------------------

3.5.2 (February 22, 2013)
------------------------

* Fixed: Use placeholder with version_generate (not only templatetags).
* Fixed: translate extension group name in upload form.
* Fixed: updated filter dropdown HTML.
* Fixed: Make setup.py work with Python 3.
* Fixed: File submit with search traversal.
* Fixed: Fixed fileobject path with Windows.
* Improved: Throwing an exception when in DEBUG and version is not generated (with using the templatetag).
* Compatibility with Django 1.5.

3.5.1 (November 09, 2012)
-------------------------

* Fixed: Documentation with Signals.
* Fixed: File Upload using basic submission.
* Fixed: Added site instance to Signals.
* Improved: Don´t hide errors during generate-command.
* Improved: Don't hide errors during generate-command.
* Improved: Follow symlinks with generate-command.
* Improved: Added some translations (e.g. for "Upload File").
* New: Setting OVERWRITE_EXISTING.
Expand Down
4 changes: 2 additions & 2 deletions docs/fieldswidgets.rst
Expand Up @@ -39,7 +39,7 @@ Attributes
FileBrowseField in Templates
^^^^^^^^^^^^^^^^^^^^^^^^^^^^

When using a ``FileBrowseField``, you´ll get a :ref:`fileobject` back.
When using a ``FileBrowseField``, you'll get a :ref:`fileobject` back.

With the above Model, you can use::

Expand Down Expand Up @@ -75,7 +75,7 @@ If you want to show a Thumbnail in the Changelist, you can define a Model-/Admin
Using the FileBrowseField with TinyMCE
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

You can also replace the TinyMCE Image/File Manager with the FileBrowser. What you have to do is a FileBrowser Callback. There´s an example in /media/js/ called TinyMCEAdmin.js (a TinyMCE Configuration File). You can copy the FileBrowserCallback to your own file, take a look at http://wiki.moxiecode.com/index.php/TinyMCE:Custom_filebrowser or just use tinymce_setup.js (which comes with django-grappelli).
You can also replace the TinyMCE Image/File Manager with the FileBrowser. What you have to do is a FileBrowser Callback. There's an example in /media/js/ called TinyMCEAdmin.js (a TinyMCE Configuration File). You can copy the FileBrowserCallback to your own file, take a look at http://wiki.moxiecode.com/index.php/TinyMCE:Custom_filebrowser or just use tinymce_setup.js (which comes with django-grappelli).

Just add these lines to your AdminModel::

Expand Down
9 changes: 4 additions & 5 deletions docs/index.rst
Expand Up @@ -98,9 +98,8 @@ Use the `FileBrowser Google Group <http://groups.google.com/group/django-filebro
Versions and Compatibility
--------------------------

* |filebrowser| 3.5.x: Requires |grappelli| 2.4 and Django 1.4 (3.5.1 is also compatible with Django 1.5)
* |filebrowser| 3.4.x: Requires |grappelli| 2.3 and Django 1.3

Older versions are availabe at GitHub, but are not supported anymore.

* FileBrowser 3.5.3 (Development Version, not yet released, see Branch Stable/3.5.x)
* FileBrowser 3.5.2 (February 22 2013): Compatible with Django 1.4/1.5
* FileBrowser 3.4.3 (April 2012): Compatible with Django 1.3

Older versions are availabe at GitHub, but are not supported anymore.
4 changes: 2 additions & 2 deletions docs/quickstart.rst
Expand Up @@ -11,7 +11,7 @@ For using the |filebrowser|, `Django <http://www.djangoproject.com>`_ needs to b
Requirements
------------

* Django 1.4, http://www.djangoproject.com
* Django 1.4/1.5, http://www.djangoproject.com
* Grappelli 2.4, https://github.com/sehmaschine/django-grappelli
* PIL, http://www.pythonware.com/products/pil/

Expand Down Expand Up @@ -70,4 +70,4 @@ Start the devserver and login to your admin site::

python manage.py runserver <IP-address>:8000

Goto ``/admin/filebrowser/browse/`` and check if everything looks/works as expected. If you're having problems, see :ref:`troubleshooting`.
Goto ``/admin/filebrowser/browse/`` and check if everything looks/works as expected. If you're having problems, see :ref:`troubleshooting`.
4 changes: 2 additions & 2 deletions docs/releasenotes.rst
Expand Up @@ -8,11 +8,11 @@
FileBrowser 3.5 Release Notes
=============================

FileBrowser 3.5 is compatible with Django 1.4 and Grappelli 2.4.
FileBrowser 3.5 is compatible with Django 1.4/1.5 and Grappelli 2.4.

Update from FileBrowser 3.4.x
-----------------------------

* Update Django to 1.4 and check https://docs.djangoproject.com/en/dev/releases/1.4/
* Update Django to 1.4 or 1.5 and check https://docs.djangoproject.com/en/dev/releases/1.4/ or https://docs.djangoproject.com/en/dev/releases/1.5/
* Update Grappelli to 2.4.x
* Update FileBrowser to 3.5.x
4 changes: 2 additions & 2 deletions docs/settings.rst
Expand Up @@ -165,7 +165,7 @@ SAVE_FULL_URL
^^^^^^^^^^^^^

.. deprecated:: 3.4.0
With custom storage engines, saving the full URL (including MEDIA_ROOT) doesn´t make sense anymore. Moreover, removing this settings allows for easily replacing a FileBrowseField with Djangos File- or ImageField.
With custom storage engines, saving the full URL (including MEDIA_ROOT) doesn't make sense anymore. Moreover, removing this settings allows for easily replacing a FileBrowseField with Djangos File- or ImageField.

STRICT_PIL
^^^^^^^^^^
Expand Down Expand Up @@ -263,4 +263,4 @@ OVERWRITE_EXISTING

``True`` in order to overwrite existing files, ``False`` to use the behaviour of the storage engine::

OVERWRITE_EXISTING = getattr(settings, "FILEBROWSER_OVERWRITE_EXISTING", True)
OVERWRITE_EXISTING = getattr(settings, "FILEBROWSER_OVERWRITE_EXISTING", True)
2 changes: 1 addition & 1 deletion docs/translation.rst
Expand Up @@ -13,4 +13,4 @@ Translation is done via `Transifex <https://www.transifex.net/projects/p/django-
Supported Languages
===================

see https://www.transifex.net/projects/p/django-filebrowser/resource/djangopo/
see https://www.transifex.net/projects/p/django-filebrowser/resource/djangopo/
2 changes: 1 addition & 1 deletion docs/troubleshooting.rst
Expand Up @@ -42,7 +42,7 @@ If you think you've found a bug, please `add a ticket <https://github.com/sehmas
* Tell us what you did in order to solve the problem.
* Tell us what version of the |filebrowser| you are using.
* Tell us what version of Django you are using.
* Please do NOT add tickets if you´re having problems with serving static/media-files (because this is not related to the |filebrowser|).
* Please do NOT add tickets if you're having problems with serving static/media-files (because this is not related to the |filebrowser|).
* Please do NOT add tickets referring to Djangos trunk version.
* At best: add a patch.

Expand Down
8 changes: 3 additions & 5 deletions docs/versions.rst
Expand Up @@ -13,7 +13,7 @@ With the FileBrowser, you are able to define different versions/sizes for Images
Versions and the grid
---------------------

First you need to know which versions/sizes of an image you´d like to use on your website. Let´s say you´re using a 12 column grid with 60px for each column and 20px margin (which is a total of 940px). With this grid, you could (for example) generate these image versions::
First you need to know which versions/sizes of an image you'd like to use on your website. Let's say you're using a 12 column grid with 60px for each column and 20px margin (which is a total of 940px). With this grid, you could (for example) generate these image versions::

VERSIONS = getattr(settings, "FILEBROWSER_VERSIONS", {
'admin_thumbnail': {'verbose_name': 'Admin Thumbnail', 'width': 60, 'height': 60, 'opts': 'crop'},
Expand Down Expand Up @@ -53,7 +53,7 @@ Don't forget to select one version for your admin-thumbnail::
Versions on your website
------------------------

In order to generate versions, you have two different tags to choose from: ``version`` and ``version_object``. With either using the version-tag or the version_object-tag, the Image-version will be generated "on the fly" if the version doesn´t already exist or if the original Image is newer than the version. This means that if you need to update an Image, you just overwrite the original Image - the versions will be re-generated automatically (as you request them within your template).
In order to generate versions, you have two different tags to choose from: ``version`` and ``version_object``. With either using the version-tag or the version_object-tag, the Image-version will be generated "on the fly" if the version doesn't already exist or if the original Image is newer than the version. This means that if you need to update an Image, you just overwrite the original Image - the versions will be re-generated automatically (as you request them within your template).

A Model example::

Expand Down Expand Up @@ -142,6 +142,4 @@ If you need to generate certain (or all) versions, type::
python manage.py fb_version_remove

.. warning::
Please be very careful with this command.


Please be very careful with this command.

0 comments on commit 71cd35e

Please sign in to comment.