在Hexo中放置本地视频的完整教程
在Hexo博客中嵌入本地视频文件可能会遇到各种问题，本文基于实际操作经验，提供一套完整的解决方案。通过使用hexo-tag-dplayer插件，可以优雅地在Hexo文章中嵌入本地视频文件。
一、安装hexo-tag-dplayer插件
首先，我们需要安装hexo-tag-dplayer插件，这是一个基于DPlayer的Hexo视频播放插件，支持丰富的视频播放功能。
注意：这里使用的是pnpm包管理器，你也可以使用npm或yarn。
pnpm install hexo-tag-dplayer --save --registry=https://registry.npmmirror.com
提示：使用国内镜像可以加速安装过程。
二、配置Hexo的文章资源文件夹功能
在Hexo的_config.yml文件中，确保以下配置项已启用，没有则在最后添加：
post_asset_folder: true
这个配置允许Hexo为每篇文章创建对应的资源文件夹，方便管理图片、视频等媒体文件。
三、配置hexo-tag-dplayer插件
在_config.yml文件中添加hexo-tag-dplayer插件的配置：
# hexo-tag-dplayer 插件配置
hexo_tag_dplayer:
cdn: https://cdn.jsdelivr.net/npm/[email protected]/dist/DPlayer.min.js
default:
loop: false
autoplay: false
theme: '#FADFA3'
mutex: true
preload: 'auto'
volume: 0.7
logo: ''
四、放置本地视频文件
-
在
source/_posts/目录下，在与md文章同级目录创建与文章同名的文件夹（例如：如果文章文件名是cad2fs.md，则创建cad2fs文件夹） -
将视频文件（如
cad2fs.mp4）放入这个文件夹中 -
文件夹中还可以存放相关的图片文件
五、在文章中嵌入视频
在Markdown文章中，使用以下语法嵌入视频：
{% dplayer "url=cad2fs.mp4" "loop=yes" "theme=#FADFA3" "autoplay=false" "token=tokendemo" %}
参数说明：
url：视频文件的相对路径（因为启用了post_asset_folder，所以直接使用文件名即可）loop：是否循环播放theme：播放界面主题色autoplay：是否自动播放（受浏览器策略限制，大多数情况下不会自动播放）token：用于弹幕功能的token（可选）
六、生成并预览网站
- 清理并重新生成网站：
pnpm hexo clean && pnpm hexo generate
- 启动本地服务器预览：
pnpm hexo server
