TeXtend

TeXtend 是一款面向 Typecho 的内容增强插件，负责把文章里的链接、媒体、短代码和统计能力组织成一套更现代的前台体验。
在当前重构版本中，Markdown 解析与 fence block 编辑增强主要由 AAEditor 负责，TeXtend 更专注于解析后的 HTML 增强、前端组件、旧语法兼容和文章统计。

插件简介

如果你希望 Typecho 在不改动写作习惯的前提下，获得更完整的内容表达能力，TeXtend 会是一个很实用的补强层：

自动把 GitHub / Gitee 链接转换成信息卡片
自动识别常见视频链接并嵌入播放器
提供一组更适合内容排版的轻量短代码
保留旧版 AAEditor 短代码的兼容渲染，方便历史文章平滑过渡
提供浏览数、点赞和文章末尾统计模块
补齐编辑器快捷插入按钮，减少重复手写短代码

它更像是 Typecho 内容层的一组“增强插件”，而不是新的 Markdown 解析器。

插件功能

内容增强

GitHub / Gitee 卡片
自动识别仓库链接和用户主页链接，转换为更直观的卡片组件。
智能视频嵌入
直接粘贴链接即可自动转换为播放器，支持：
- YouTube
- Vimeo
- Bilibili
- 直链视频文件（mp4、webm、ogg、ogv、mov、m3u8）
音频播放器
提供新的 {audio} / {audio-track} 语法，支持单曲与播放列表展示。

短代码支持

当前版本推荐使用新的花括号语法：

{center-title}标题{/center-title}
{span type="tip"}强调内容{/span}
{btn href="https://example.com" type="primary"}立即查看{/btn}
{link href="https://example.com" title="项目主页" /}
{github url="https://github.com/benzBrake/TeXtend" /}
{player src="https://www.youtube.com/watch?v=dQw4w9WgXcQ" /}
{bilibili id="BV1xx" p="1" /}
{audio url="https://example.com/song.mp3" name="曲名" artist="歌手" /}

旧语法兼容

这是这次重构里很重要的一部分。TeXtend 仍然会为旧内容提供 fallback 支持，避免历史文章因为升级而失效，例如：

[x-player src="视频URL" autoplay="off" /]
[x-bilibili id="BV1xx" p="1" /]
[audio src="https://example.com/song.mp3" name="曲名" /]
[tabs]...[tab]...[/tab][/tabs]
[card title="标题"]内容[/card]
[photos]...[/photos]

这些旧语法仍可继续渲染，但新的内容更建议统一迁移到当前语法或 AAEditor 的 fence block 体系。

文章统计

浏览数统计
点赞功能
Cookie 防重复
可选在文章末尾自动附加统计模块

后台增强

为 AAEditor 补充快捷插入按钮
根据插件启用项动态显示可用短代码
让编辑器预览和前台输出尽量保持一致

适用场景

希望在 Typecho 里直接获得更好的仓库卡片和媒体嵌入体验
已经在用 AAEditor，但还需要更完整的前端增强和兼容层
站点里有较多历史短代码内容，希望升级时尽量少动旧文章
需要简单实用的浏览统计和点赞功能

安装方式

下载最新版本
将 TeXtend 文件夹上传到 /usr/plugins/ 目录
在后台 控制台 -> 插件 中启用 TeXtend
按需进入插件设置，启用或关闭具体短代码与链接解析能力

使用说明

Markdown 解析、fence block 和编辑器语法增强由 AAEditor 负责
TeXtend 负责 解析后的 HTML 增强、短代码兼容、媒体嵌入、仓库卡片和统计功能
如果你同时安装了同类视频嵌入插件，建议避免重复启用相同能力
统计功能不能与 TeStat 同时使用

插件截图

插件优点

职责更清晰，和 AAEditor 分工明确
新旧语法都能照顾到，升级成本更低
前台输出、编辑器预览、CSS 类名尽量统一
常用能力都做成可配置开关，按需启用更灵活

插件缺点

旧短代码仍在兼容，但长期来看仍建议逐步迁移
GitHub / Gitee 卡片和外链媒体能力依赖目标站点可访问性
与同类统计或视频嵌入插件同时启用时，可能产生功能重叠

更新日志

1.0.2

重构插件定位，不再接管 HyperDown，Markdown 解析与 fence block 体系改由 AAEditor 负责
重写内容解析流程，聚焦 HTML 增强、短代码渲染、媒体嵌入和旧内容兼容
新增统一短代码注册表，支持独立开关、统一别名管理和默认启用状态
新增统一链接解析注册表，GitHub / Gitee 卡片和视频自动嵌入均可独立启停
新增 {center-title}、{span}、{btn}、{link}、{audio}、{audio-track}、{github} 等新语法
保留 [x-player]、[x-bilibili]、[audio]、[tabs]、[card]、[photos] 等旧语法兼容
新增音频播放器能力，支持单曲和播放列表
补齐 AAEditor 快捷插入按钮，并让编辑器预览与前台输出保持一致
优化前端样式结构，统一短代码类名前缀为 shortcode-*
完善统计模块，支持浏览数、点赞数和文章末尾自动附加统计信息
新增完整语法文档 SYNTAX.md