wikifab / embed-video
This package is auto-updated.
Last update: 2024-09-20 23:03:39 UTC
README
##关于
EmbedVideo 扩展是一个 MediaWiki 扩展，它添加了一个名为 #ev 的解析函数，用于嵌入来自22个以上流行视频分享服务的视频剪辑，支持多种语言和地区。它还添加了视频和音频媒体处理程序，以支持将标准的 [[File:Example.mp4]] 文件链接转换为嵌入的 HTML5 <video> 和 <audio> 标签。
有关 EmbedVideo 的更多信息，请下载、贡献以及报告错误和问题，请访问 GitHub 项目页面
https://github.com/HydraWiki/mediawiki-embedvideo
在问题跟踪器中创建问题、错误报告和功能请求
https://github.com/HydraWiki/mediawiki-embedvideo/issues
MediaWiki 扩展页面位于
https://www.mediawiki.org/wiki/Extension:EmbedVideo
##历史
EmbedVideo 的原始版本由 Jim R. Wilson 创建。后来，Mohammed Derakhshani 以 EmbedVideoPlus 扩展的形式进行了分支。到2010年初，Andrew Whitworth 开始积极维护这两个扩展，并将它们合并为 "EmbedVideo"。后来在2014年9月，Alexia E. Smith 在无法联系当前维护者的情况下强制接管。
EmbedVideo 的新版本旨在与旧的 EmbedVideo 和 EmbedVideoPlus 扩展完全向后兼容。
##许可
EmbedVideo 在 MIT 许可下发布
https://open-source.org.cn/licenses/mit-license.php
有关更多信息，请参阅 LICENSE 文件
##安装
##下载
您可以从三个地方下载 EmbedVideo 扩展。第一个是它的 GitHub 项目页面，那里进行着活跃的开发。如果您有 git，可以使用以下命令检查扩展源代码的只读副本
git clone https://github.com/HydraWiki/mediawiki-embedvideo.git
从 GitHub 项目页面还可以获取编号发布的可下载存档包。
##安装说明
- 下载扩展内容，如上所述。
- 在您的 MediaWiki 安装中的 extensions/ 文件夹中创建一个 EmbedVideo 文件夹。
- 将此发行版的内容复制到该文件夹中
对于 Mediawiki 1.19 到 1.23，将以下行添加到您的 LocalSettings.php 中
require_once("$IP/extensions/EmbedVideo/EmbedVideo.php");
对于 Mediawiki 1.24 及以上版本，将以下行添加到您的 LocalSettings.php 中
wfLoadExtension("EmbedVideo");
##使用方法
媒体处理程序
对于本地上传的内容，显示在页面上的过程与图像相同。请参阅 MediaWiki.org 上的图像语法文档以获取此功能的完整参考。
此示例将使用 HTML5 <video> 标签在页面上显示视频。
[[File:Example.mp4]]
在媒体中使用开始和结束时间戳时，请使用 start 和 end 参数。时间戳可以格式化为以下之一：ss、:ss、mm:ss、hh:mm:ss 或 dd:hh:mm:ss。
[[File:Example.mp4|start=2|end=6]]
##标签
EmbedVideo 解析函数可以以下任何方式调用
#ev - 经典解析标签
{{#ev:service|id}}{{#ev:service|id|dimensions}}{{#ev:service|id|dimensions|alignment}}{{#ev:service|id|dimensions|alignment|description}}{{#ev:service|id|dimensions|alignment|description|container}}{{#ev:service|id|dimensions|alignment|description|container|urlargs}}{{#ev:service|id|dimensions|alignment|description|container|urlargs|autoresize}}
但是，如果需要，可以通过在管道之间不放置任何内容来留空可选参数
{{#ev:service|id|||description}}
#evt - 模板解析标签
“#evt”解析标签允许使用键值对，这使得模板化和可读性更简单。
{{#evt:
service=youtube
|id=https://www.youtube.com/watch?v=pSsYTj9kCHE
|alignment=right
}}
#evu - URL解析标签
“#evu”解析标签与“#evt”标签类似，但其第一个参数是一个URL，该URL将被解析以自动确定服务。
{{#evu:https://www.youtube.com/watch?v=pSsYTj9kCHE
|alignment=right
}}
<embedvideo> - 标签钩子
可以使用 <embedvideo></embedvideo> 标签钩子轻松嵌入视频。ID/URL作为标签之间的输入，参数可以作为标签参数添加。
<embedvideo service="youtube">https://www.youtube.com/watch?v=pSsYTj9kCHE</embedvideo>
解析标签的属性
示例
示例 #1
例如，来自YouTube的视频使用‘youtube’服务选择器，可以输入原始ID
{{#ev:youtube|pSsYTj9kCHE}}
或完整的URL
{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE}}
示例 #2
为了显示相同视频作为右对齐的大缩略图以及描述
{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE|1000|right|Let eet GO|frame}}
要使YouTube视频从特定时间码开始播放，请使用urlargs（URL参数）参数。将自定义URL中的其余URL参数放入urlargs中。请注意，并非所有视频服务都支持额外的URL参数，或它们的URL参数可能有不同的键。
https://www.youtube.com/watch?v=pSsYTj9kCHE&start=76
{{#ev:youtube|https://www.youtube.com/watch?v=pSsYTj9kCHE|||||start=76}}
对VideoLink标签的支持
自版本2.5以来，已添加对未维护的VideoLink扩展的标签的支持。
原始扩展文档中的内容
The VideoLink extension allows embedding of YouTube videos in articles; allowing for multiple linked videos to be played in a single embedded video player, first shown when a user clicks on a video link.
The <vplayer /> specifies where the player should appear within the page, and the {{#vlink}} parser function allows creation of links that load a specific video.
<evlplayer> - 视频容器标签钩子
请注意，为了向后兼容，这里也可以使用 <vplayer> 标签。
此evlplayer标签用于在页面上定位视频播放器容器。
<vplayer id="player id" w="width" h="height" class="class" style="style">default content</vplayer>
需要特别注意的一个重要情况是，w 和 h 属性仅影响包含在容器div中的视频，而不影响实际容器。对于容器的样式，请使用 class 或 style 属性。
#evl - 视频链接解析函数
请注意，为了向后兼容，这里也可以使用 {{#vlink}} 解析函数。
{{#evl:<video id>|<Link text>|service=youtube|player=<player id>}}
除了支持所有“#evt”标签的属性外，这些特定属性还适用于“#evl”（和“#vlink”）标签。为了保持向后兼容性，如果您没有定义“service”，则默认为“youtube”。
支持的服务
截至版本2.x，EmbedVideo支持从以下服务嵌入视频内容
#配置设置
#致谢
EmbedVideo的原始版本由Jim R. Wilson编写。由Andrew Whitworth、Alexia E. Smith和其他贡献者进行了重大升级。
请参阅CREDITS以获取详细信息