Add code-block segments to documentation

docs/quickstart.rst

@@ -3,6 +3,8 @@ Quickstart
 
 To get started using ``django-admin-sortable`` simply install it using ``pip``::
 
+    .. code-block:: bash
+
     $ pip install django-admin-sortable
 
 Add ``adminsortable`` to your project's ``INSTALLED_APPS`` setting.
@@ -11,6 +13,8 @@ Ensure ``django.core.context_processors.static`` is in your ``TEMPLATE_CONTEXT_P
 
 Define your model, inheriting from ``adminsortable.Sortable``::
 
+    .. code-block:: python
+
     # models.py
     from adminsortable.models import Sortable
 
@@ -25,6 +29,8 @@ Define your model, inheriting from ``adminsortable.Sortable``::
 
 Wire up your sortable model to Django admin::
 
+    .. code-block:: python
+
     # admin.py
     from adminsortable.admin import SortableAdmin
     from .models import MySortableClass

docs/testing.rst

@@ -9,4 +9,6 @@ Inlines may be drag-and-dropped into any order directly from the change form.
 
 Unit and functional tests may be found in the ``app/tests.py`` file and run via:
 
+    .. code-block:: bash
+
     $ python manage.py test app

docs/usage.rst

@@ -6,6 +6,8 @@ Models
 
 To add sorting to a model, your model needs to inherit from ``SortableMixin`` and at minimum, define an inner ``Meta.ordering`` value
 
+    .. code-block:: python
+
     # models.py
     from adminsortable.models import Sortable
 
@@ -22,7 +24,7 @@ It is also possible to order objects relative to another object that is a Foreig
 
 .. note:: A small caveat here is that ``Category`` must also either inherit from ``Sortable`` or include an ``order`` property which is a ``PositiveSmallInteger`` field. This is due to the way Django admin instantiates classes.
 
-::
+    .. code-block:: python
 
     # models.py
     from adminsortable.fields import SortableForeignKey
@@ -53,6 +55,8 @@ If you're adding Sorting to an existing model, it is recommended that you use `d
 
 Example assuming a model named "Category"::
 
+    .. code-block:: python
+
     def forwards(self, orm):
         for index, category in enumerate(orm.Category.objects.all()):
             category.order = index + 1
@@ -65,6 +69,8 @@ Django Admin
 
 To enable sorting in the admin, you need to inherit from ``SortableAdmin``::
 
+    .. code-block:: python
+
         from django.contrib import admin
         from myapp.models import MySortableClass
         from adminsortable.admin import SortableAdmin
@@ -76,6 +82,8 @@ To enable sorting in the admin, you need to inherit from ``SortableAdmin``::
 
 To enable sorting on TabularInline models, you need to inherit from SortableTabularInline::
 
+    .. code-block:: python
+
     from adminsortable.admin import SortableTabularInline
 
     class MySortableTabularInline(SortableTabularInline):
@@ -83,6 +91,8 @@ To enable sorting on TabularInline models, you need to inherit from SortableTabu
 
 To enable sorting on StackedInline models, you need to inherit from SortableStackedInline::
 
+    .. code-block:: python
+
     from adminsortable.admin import SortableStackedInline
 
     class MySortableStackedInline(SortableStackedInline):
@@ -90,6 +100,8 @@ To enable sorting on StackedInline models, you need to inherit from SortableStac
 
 There are also generic equivalents that you can inherit from::
 
+    .. code-block:: python
+
     from adminsortable.admin import (SortableGenericTabularInline,
         SortableGenericStackedInline)
         """Your generic inline options go here"""
@@ -108,6 +120,8 @@ Overriding ``queryset()`` for an inline model
 
 This is a special case, which requires a few lines of extra code to properly determine the sortability of your model. Example::
 
+    .. code-block:: python
+
     # add this import to your admin.py
     from adminsortable.utils import get_is_sortable
 
@@ -137,6 +151,8 @@ It is also possible to sort a subset of objects in your model by adding a ``sort
 
 An example of sorting subsets would be a "Board of Directors". In this use case, you have a list of "People" objects. Some of these people are on the Board of Directors and some not, and you need to sort them independently::
 
+    .. code-block:: python
+
     class Person(Sortable):
         class Meta(Sortable.Meta):
             verbose_name_plural = 'People'
@@ -170,6 +186,8 @@ By default, adminsortable's change form and change list views inherit from Djang
 
 These attributes have default values of::
 
+    .. code-block:: python
+
     change_form_template_extends = 'admin/change_form.html'
     change_list_template_extends = 'admin/change_list.html'