Django Image Cropping 安装与配置指南

Django Image Cropping 安装与配置指南

django-image-cropping Django helper application to easily and non-destructively crop arbitrarily large images in admin and frontend. 项目地址: https://gitcode.com/gh_mirrors/dj/django-image-cropping

1. 项目基础介绍

Django Image Cropping 是一个开源的 Django 应用程序，用于在 Django 的管理后台中裁剪上传的图片。该项目允许用户上传任意尺寸的图片，同时确保在模板中显示时图片保持特定的宽高比。它通过使用 Jcrop 提供了一个易于使用的界面，让用户可以轻松地裁剪图片而不破坏页面布局。此外，原始图片会保持完整，只有在显示时才会进行裁剪。

主要编程语言：Python

2. 项目使用的关键技术和框架

• Django：一个高级的 Python Web 框架，它鼓励快速开发和干净、实用的设计。
• Jcrop：一个用于图片裁剪的 JavaScript 库。
• easy-thumbnails：一个用于生成图片缩略图的 Django 应用程序。

3. 安装和配置准备工作及步骤

准备工作：

• 安装 Python 和 pip。
• 安装 Django。
• 安装 Git（如果需要从 GitHub 克隆项目）。

安装步骤：

1. 首先，使用 pip 安装 Django Image Cropping：

   pip install django-image-cropping
   

2. 接着，安装 easy-thumbnails，因为 Django Image Cropping 默认使用它来生成缩略图：

   pip install easy-thumbnails
   

3. 在你的 Django 项目的 settings.py 文件中，添加 easy_thumbnails 和 image_cropping 到 INSTALLED_APPS：

   INSTALLED_APPS = [
       ...
       'easy_thumbnails',
       'image_cropping',
   ]
   

4. 同样在 settings.py 文件中，配置缩略图处理器，添加以下代码：

   from easy_thumbnails.conf import Settings as thumbnail_settings
   THUMBNAIL_PROCESSORS = (
       'image_cropping.thumbnail_processors.crop_corners',
   ) + thumbnail_settings.THUMBNAIL_PROCESSORS
   

5. 在你的 Django 模型中，添加一个 ImageRatioField 字段来存储裁剪图片的边界信息，并指定关联的 ImageField 和期望的裁剪尺寸：

   from django.db import models
   from image_cropping import ImageRatioField
   
   class MyModel(models.Model):
       image = models.ImageField(upload_to='uploaded_images')
       cropping = ImageRatioField('image', '430x360')
   

6. 在你的模型管理类中，添加 ImageCroppingMixin 以在 Django 管理后台中提供增强的图片小部件：

   from django.contrib import admin
   from image_cropping import ImageCroppingMixin
   
   class MyModelAdmin(ImageCroppingMixin, admin.ModelAdmin):
       pass
   
   admin.site.register(MyModel, MyModelAdmin)
   

7. 最后，运行你的 Django 项目的迁移命令来应用模型更改：

   python manage.py makemigrations
   python manage.py migrate
   

完成以上步骤后，你的 Django 项目就应该能够使用 Django Image Cropping 来裁剪图片了。

django-image-cropping Django helper application to easily and non-destructively crop arbitrarily large images in admin and frontend. 项目地址: https://gitcode.com/gh_mirrors/dj/django-image-cropping