我今天正在写一篇文章，并想将某些文本的MP3文件嵌入到语音输出中。雨果不会使用短码在本地支持这一点，因此我需要一种方法来添加它们，理想情况下，不添加任何HTML。

为此，我需要创建自己的短代码实现。事实证明，基于Hugo shortcode guide，这些并不复杂。

创建快捷代码

短代码现用在您的layout文件夹中的名为shortcodes的文件夹中，并以HTML文件为单位，称为<shortcode>.html。例如，如果您想创建一个称为audio的简编码，您将创建文件layout/shortcodes/audio.html。

短代码是可以传递给参数的HTML的摘要。 HTML音频播放器的HTML是：

<audio controls preload="auto">
 <source src="file.mp3">
</audio>

短代码也可以使用名称参数进行参数化，您可以使用{{ .Get "name" }}方法获得该参数的名称。对于音频短码，我需要传递音频文件，因此这可以是一个参数。这是在src字段中设置的，所以我称此参数为src：

<audio controls preload="auto">
 <source src="{{ .Get "src" }}">
</audio>

完成！这是我的整个短代码。

使用短代码

写了我的短码后，便易于使用。我添加了我想在博客文章的文件夹中播放的mp3文件，并在帖子的Markdown文件中添加了短代码标签：

{< audio src="intro-to-generative-ai.m4a" >}

完成后，音频播放器出现在我的页面上：

自己用这个

如果您想使用此快捷代码，可以找到on the GitHub repo for this site。