django-sparkle-external 0.4

# django-sparkle-external

Django-sparkle-external是django-sparkle-1.5的衍生版本，提供Sparkle更新和外部文件源。

我使用[Heroku](https://www.heroku.com)托管我的应用站点，在那里为Django启用媒体文件上传非常痛苦。因此，我将文件源更改为`URLField`，以便可以使用[GitHub](https://github.com)下载提供更新。自django-sparkle-1.5提供的某些其他钩子因在Heroku上无法工作而已删除。

我还使用了[Django Ghostdown](https://github.com/uranusjr/django-ghostdown)来提供更好的发布说明文本字段。这一优势是，该项目不再依赖于`Markdown`，但您可以根据需要使用任何Markdown渲染库。有关配置的更多信息，请参阅Django Ghostdown的描述。

以下为django-sparkle-1.5的原始README。



# django-sparkle-1.5

Django-sparkle-1.5是一个Django应用程序，用于简化使用[sparkle](http://sparkle.andymatuschak.org/)发布mac应用更新的过程。

除了通过appcast源发布更新外，Django-sparkle还可以收集系统配置信息，如果sparkle被配置为报告这些信息。

此版本的django-sparkle旨在与Django 1.5一起使用，并添加了一些新功能。如果您正在寻找django-sparkle的基础版本，请访问[https://github.com/Mobelux/django-sparkle](https://github.com/Mobelux/django-sparkle)

# 要求

* Django >= 1.5
* Markdown > 2.1（用于发布说明）
* django-absolute（用于appcast链接字段的绝对URL）

## 可选要求

* OpenSSL（如果您想对发布进行签名）
这必须在命令行上作为`openssl`命令可用。



# 设置

1. 使用 `easy_install django-sparkle-1.5` 或 `pip install django-sparkle-1.5` 进行安装。
2. 确保正确安装了 `django-absolute`（这可能需要一些额外的设置）。
3. 将 `sparkle` 添加到已安装的应用程序中。
4. 在 `urls.py` 中通过添加类似 `(r'^sparkle/', include('sparkle.urls'))` 的内容来包含 sparkle 的 URL。
5. 确保 `MEDIA_URL` 设置正确。
6. 执行 `python manage.py syncdb` 以创建 sparkle 所需的表格。
7. 可选：在 `settings.py` 中添加 `SPARKLE_PRIVATE_KEY_PATH`，这是您用于签名发布版本的私钥路径。
8. 可选：将 `SPARKLE_UPLOAD_PREFIX` 添加到设置中（默认为 `sparkle/`）。该组件将被添加到您上传版本的媒体 URL 中。

# 使用方法

创建一个应用程序，并可选地添加一些版本。

应用程序的 appcast 源将可在 `/your_configured_urls_py/(/P<application_slug>\d+)/appcast.xml` 中找到。

您的上传版本将可在 `{{ MEDIA_URL }}/SPARKLE_UPLOAD_PREFIX/application_slug/version_number.extension` 中找到。您可以通过调用 `instance.latest().update.url` 获取应用程序的最新版本的 URL。

将 Info.plist 中的 `SUFeedURL` 键设置为指向 sparkle 应用程序的 appcast URL。例如，`http://example.com/sparkle/app/appcast.xml`。

如果您想启用系统分析，请确保在 Info.plist 中将 `SUEnableSystemProfiling` 键设置为 `YES`。

# 设置

* `SPARKLE_PRIVATE_KEY_PATH`
用于签名发布的 DSA 私钥路径。默认为 `None`。如果未提供，上传时将不会自动签名。
* `SPARKLE_UPLOAD_PREFIX`
将添加到上传文件的路径前缀。默认为 `sparkle/`。使用此前缀来配置发布文件将结束的上传目录。请注意，此前缀将成为下载 URL 的一部分。如果您想要一个目录，请确保以 `/` 结尾。


# 待办事项

* 当然是测试！

# 许可证

本软件根据 BSD 许可证条款授权

版权所有 (c) 2011, Jason Emerick
版权所有 (c) 2013, Johannes Spielmann
保留所有权利。

重新分发和使用源代码和二进制代码，无论是修改后还是未经修改，只要满足以下条件

* 源代码的重新分发必须保留上述版权声明、本许可协议列表和以下免责声明。
* 二进制形式的重新分发必须在文档和/或随同分发的其他材料中复制上述版权声明、本许可协议列表和以下免责声明。

本软件由版权所有者和贡献者按“原样”提供，不提供任何明示或暗示的保证，包括但不限于适销性和针对特定目的的适用性的暗示保证。在任何情况下，版权所有者或贡献者不对任何直接、间接、偶然、特殊、示范性或后果性损害（包括但不限于替代商品或服务的采购、使用、数据或利润损失；业务中断）承担责任，无论此类损害是根据合同、严格责任、侵权（包括疏忽或不作为）或其他理论提出的，即使已告知此类损害的可能性。