django-embed-video 1.4.10

文档

文档位于：http://django-embed-video.rtfd.org/

快速开始

1. 安装 django-embed-video

   pip install django-embed-video

   或从源代码安装

   pip install git+https://github.com/jazzband/django-embed-video

2. 将 embed_video 添加到您的 Django 设置中的 INSTALLED_APPS。

3. 如果您想在模板标签中检测 HTTP/S，您必须在 settings.TEMPLATES 中设置 request 上下文处理器

   TEMPLATES = [
       {
           'BACKEND': 'django.template.backends.django.DjangoTemplates',
           # ...
           'OPTIONS': {
               'context_processors': [
                   # ...
                   'django.template.context_processors.request',
               ],
           },
       },
   ]

4. 模板标签的使用

   {% load embed_video_tags %}
   
   <!-- The video tag: -->
   {% video item.video as my_video %}
     URL: {{ my_video.url }}
     Thumbnail: {{ my_video.thumbnail }}
     Backend: {{ my_video.backend }}
   
     {% video my_video "large" %}
   {% endvideo %}
   
   <!-- Or embed shortcut: -->
   {% video my_video '800x600' %}

5. 模型字段的用法

   from django.db import models
   from embed_video.fields import EmbedVideoField
   
   class Item(models.Model):
       video = EmbedVideoField()  # same like models.URLField()

贡献

这是一个 Jazzband 项目。通过贡献，您同意遵守 贡献者行为准则 并遵循 指南。

版本 1.4.10（2024年5月7日）

• 更新 Python 和 Django 版本。

• 使用 importlib.metadata 而不是已弃用的 pkg_resources。

版本 1.4.9（2023年7月1日）

• 更新 Python 和 Django 版本。

• 修复 Soundcloud 测试。

• 添加示例站点。

版本 1.4.8（2022年11月19日）

• 迁移和文档中的修复。

版本 1.4.7（2022年9月28日）

• 修复 rST 文件格式以获得发布自动化审批。

版本 1.4.6（2022年9月28日）

• 示例项目使用 Django 3.2 LTS。

• 将 URLvalidator 添加到管理小部件以验证输入。

版本 1.4.5（2022年9月1日）

• 添加对 Django 4.1 的支持。

版本 1.4.4（2022年4月18日）

• 将 EMBED_VIDEO_YOUTUBE_CHECK_THUMBNAIL 添加到设置中。

• 停止对 EOL Django 2.2 的支持。

版本 1.4.3（2022年4月8日）

• 添加对 YouTube 短网址的支持。

版本 1.4.2（2022年3月17日）

• 添加波兰语翻译。

版本 1.4.1（2022年1月6日）

• 将行为准则添加到存储库中。

• 添加对 Python 3.10 的支持。

• 添加对 Django 3.2 和 Django 4.0 的支持。

• 停止对 EOL Python 3.6 的支持。

• 停止对 EOL Django 3.0 和 EOL Django 3.1 的支持。

• 由于版本不兼容，从依赖项中删除 Nose。

版本 1.4.0（2020年12月18日）

• 为视频模板标签添加懒加载。

• 处理 Vimeo 管理员“管理”URL。

• 从 Travis CI 迁移到 GitHub Actions。

• 停止支持 2.2 之前的所有 Django 版本。

• 添加对 Python 3.9 及以上版本的支持。

• 添加对 Django 3.1 及以上版本的支持。

• 改进代码格式。

版本 1.3.3（2020年6月10日）

• 修复与表单验证相关的管理 UI 异常。

版本 1.3.2（2020年3月29日）

• 添加对 Soundcloud 移动 URL 的支持。

版本 1.3.1（2020年1月6日）

• 添加对 Vimeo 审查视频 URL 的支持。

• 更新示例项目代码。

版本 1.3（2019年8月30日）

• 停止支持 3.6 之前的所有 Python 版本。

• 停止支持 1.11 之前的所有 Django 版本。

• 添加对包括 PyPy 在内的 Python 3.8 及以上版本的支持。

• 添加对 Django 2.2 及以上版本的支持。

• 改进项目结构、文档和语言。

• 改进 CI 和 CD 基础设施和自动化。

• 将项目迁移到 Jazzband 组织。

版本 1.2.0（2018年10月4日）

• 修复 hotfix 指令（#94）

• 更新文档（#92）

• 使用 tests_require 和 setup_requires 为 nose 测试要求（#91）

• 将 renderer 参数添加到 Widget 渲染方法以支持 Python 2.1 及以后版本（#88）

• 为 YouTube、VimeoBackend、SoundCloudBackend 启用默认 HTTPS 支持（#86）

• 在 README.rst 中添加语法高亮（#81）

• 更新 requests >=2.19

版本 1.1.2（2017年4月27日）

• 修复 pypi

版本 1.1.1（2017年3月24日）

• 为 Django 1.10 和 1.11 更新 (#73)

• 更新示例项目的安装要求 (#72)

• 使用安全连接查询 SoundCloud 终端 (#68)

版本 1.1.0（2016年1月19日）

• 增加了对 Django 1.9 的支持 (#52)

• 如果可能，YouTube 缩略图将以更好的分辨率返回 (#43)

版本 1.0.0（2015年5月1日）

向后不兼容的更改

• 已移除过滤器 embed_video_tags.embed

• 更改了视频标签中额外参数的行为 (#34，#36)

向后兼容的更改

• 增加了对 Django 1.7 和 Django 1.8 的支持

• 增加了对 Vimeo 频道的支持 (#47)

• 修复了 SoundCloud iframe 的缩放问题 (#41)

版本 0.11（2014年7月26日）

• 添加了对 YouTube 移动网址的支持 (#27)

• 修复了在调用请求库时传递参数的问题 (#28)

• 修复了 URL 验证问题 (#31)

版本 0.10（2014年5月24日）

• video 标签接受 kwargs (#20)

• video 标签将不再在传递 None 作为 URL 时崩溃 (#24)

版本 0.9（2014年4月4日）

• 添加 VideoBackend.template_name 并从文件中渲染嵌入代码。

• 在模板标签中允许使用相对大小 (#19)。

• 修复了处理 SoundCloud 无效 URL 的问题 (#21)。

• 在模板标签和后台小部件中捕获 VideoDoesntExistException 和 UnknownBackendException。

• 添加基本异常 EmbedVideoException。

版本 0.8（2014年2月22日）

• 将 EMBED_VIDEO_TIMEOUT 添加到设置中。

• 修复了未提供 URL 时渲染模板标签的问题 (#18)

• 如果在模板中达到 EMBED_VIDEO_TIMEOUT 超时，则不会引发异常，错误只是记录下来。

• 修复了模板标签中的默认大小。 (查看更多…)

版本 0.7（2013年12月21日）

• 支持在 HTTPS 上运行的网站

• 已弃用 embed 过滤器，并由 video 过滤器替换。

• 移除了整个后端的支持并替换为缓存属性

• 对示例项目（ fixtures，urls）进行了细微改进

版本 0.6（2013年10月4日）

• 能够覆盖后端的嵌入代码

• 缓存后端属性

• PyPy 兼容性

• 后台视频混合和视频小部件

版本 0.5（2013年9月3日）

• 添加了 Vimeo 缩略图支持

• 添加了结果的缓存

• 添加了示例项目

• 修复了模板标签 embed

• 修复了在 YouTube 检测中引发 UnknownIdException

版本 0.4（2013年8月22日）

• 文档已被重写并移动到 http://django-embed-video.rtfd.org/ .

• 自定义后端 (http://django-embed-video.rtfd.org/en/latest/examples.html#custom-backends).

• 改进了 YouTube 和 Vimeo 的正则表达式。

• 支持 Python 3。

• 将 base 重命名为 backends。

版本 0.3（2013年8月20日）

• 安全修复：将伪造的URL视为无效。更多信息请参阅此页面。

• 修复内容

  • 允许视频字段为空。

  • setup.py中的要求

• 添加了一种更简单的方法在单行模板标签中嵌入视频。

  {{ 'http://www.youtube.com/watch?v=guXyvo2FfLs'|embed:'large' }}

• video模板标签中的backend变量。

  用法

  {% video item.video as my_video %}
      Backend: {{ my_video.backend }}
  {% endvideo %}

版本 0.2（2013年6月25日）

• 支持SoundCloud

版本 0.1（2013年6月1日）

• 初始发布