**Django S3 Folder Storage 使用指南**

本指南将详细介绍如何使用 django-s3-folder-storage 这一开源项目，它扩展了 django-storages 的 S3BotoStorage 功能，允许在单个 S3 存储桶内设置独立的上传媒体和静态文件夹。以下是关键内容模块：

1. 项目目录结构及介绍

项目遵循Python的常规包布局，其主要结构如下：

django-s3-folder-storage/
│  
├── CHANGELOG.md          # 版本更新日志
├── LICENSE               # 许可证文件，采用BSD-3-Clause许可
├── MANIFEST.in           # 包含在分发中但不明显的文件列表
├── README.md             # 项目简介与快速入门文档
├── requirements_test.txt # 测试环境所需依赖
├── setup.cfg             # 配置编译或安装过程的文件
├── setup.py              # 安装脚本，定义了包元数据和安装指令
└── s3_folder_storage     # 核心代码目录
    ├── __init__.py       # 初始化模块
    └── ...                # 其他相关模块和文件

核心模块 (s3_folder_storage) 包含了对S3存储特定功能的实现，如自定义路径处理。

2. 项目的启动文件介绍

虽然本项目本身不需要直接“启动”，它的集成发生在Django应用的配置阶段。一旦正确配置，Django应用会在处理静态文件和媒体文件时自动使用该项目提供的存储逻辑。因此，并没有传统意义上的“启动文件”。关键在于修改Django的配置文件（通常是settings.py），以启用并配置django-s3-folder-storage。

3. 项目的配置文件介绍

在Django中的集成与配置

• 安装: 首先，通过pip安装此库。

  pip install django-s3-folder-storage
  

• 添加到Django项目: 在你的settings.py的INSTALLED_APPS列表中加入s3_folder_storage。

  INSTALLED_APPS = (
      ...
      's3_folder_storage',
      ...
  )
  

• 关键设置: 配置AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY以及DEFAULT_S3_PATH和STATIC_S3_PATH来指定S3上的文件夹路径。

  AWS_ACCESS_KEY_ID = 'your_access_key'
  AWS_SECRET_ACCESS_KEY = 'your_secret_key'
  
  DEFAULT_S3_PATH = "media"
  STATIC_S3_PATH = "static"
  
  # 可选的其他Django storages的配置项
  DEFAULT_FILE_STORAGE = 's3_folder_storage.storage.S3DefaultStorage'
  STATICFILES_STORAGE = 's3_folder_storage.storage.S3StaticStorage'
  

确保你已经设置了AWS的访问密钥，并且这些设置反映了你在Amazon S3上希望存放文件的路径。

以上步骤完成后，Django将会使用这个库来管理媒体和静态文件到指定的S3文件夹下。这使得维护和组织不同类型的文件更加简便和高效。