多媒体
嵌入多媒体
面向技术内容创作者设计。你只需专注内容,底层的 Hugo Blox 会处理好其余部分。
可嵌入视频、播客、代码、LaTeX 公式,甚至用于自测的题目!
本页展示了可用的技术内容渲染示例。
视频
可以通过以下几种方式分享视频:
YouTube:
{{< youtube w7Ft2ymGmfc >}}
哔哩哔哩(Bilibili):
{{< bilibili id="BV1WV4y1r7DF" >}}
本地视频文件
视频可放在 assets/media/ 媒体库,或放在页面文件夹中,然后用 video shortcode 嵌入:
{{< video src="my_video.mp4" controls="yes" >}}
播客 / 音频
把 MP3 文件放在页面文件夹或媒体库目录,然后用 audio shortcode 嵌入:
{{< audio src="ambient-piano.mp3" >}}
试试看:
自测题目
用 spoiler shortcode 折叠答案,实现简单有趣的自测:
{{< spoiler text="👉 点击查看答案" >}}
找到我啦!
{{< /spoiler >}}
渲染效果:
👉 点击查看答案
找到我啦 🎉
数学公式
支持 $\LaTeX$ 数学公式。可在 config/_default/params.yaml 中打开 math 选项。
行内或块级公式,分别用 {{< math >}}$...${{< /math >}} 或 {{< math >}}$$...$${{< /math >}} 包裹。
Note
我们用 math shortcode 包裹 LaTeX,防止 Hugo 把公式当成 Markdown 渲染。该提示框使用的是标准 Markdown 提示框语法!
块级公式示例:
{{< math >}}
$$
\gamma_{n} = \frac{ \left | \left (\mathbf x_{n} - \mathbf x_{n-1} \right )^T \left [\nabla F (\mathbf x_{n}) - \nabla F (\mathbf x_{n-1}) \right ] \right |}{\left \|\nabla F(\mathbf{x}_{n}) - \nabla F(\mathbf{x}_{n-1}) \right \|^2}
$$
{{< /math >}}
渲染效果:
$$\gamma_{n} = \frac{ \left | \left (\mathbf x_{n} - \mathbf x_{n-1} \right )^T \left [\nabla F (\mathbf x_{n}) - \nabla F (\mathbf x_{n-1}) \right ] \right |}{\left \|\nabla F(\mathbf{x}_{n}) - \nabla F(\mathbf{x}_{n-1}) \right \|^2}$$行内公式 {{< math >}}$\nabla F(\mathbf{x}_{n})${{< /math >}} 渲染为 $\nabla F(\mathbf{x}_{n})$
。
多行公式(使用 \\ 换行):
{{< math >}}
$$f(k;p_{0}^{*}) = \begin{cases}p_{0}^{*} & \text{if }k=1, \\
1-p_{0}^{*} & \text{if }k=0.\end{cases}$$
{{< /math >}}
渲染效果:
$$ f(k;p_{0}^{*}) = \begin{cases}p_{0}^{*} & \text{if }k=1, \\ 1-p_{0}^{*} & \text{if }k=0.\end{cases} $$代码
使用 Hugo 的 Markdown 语法高亮扩展,代码主题可在 config/_default/params.yaml 中选择。
```python
import pandas as pd
data = pd.read_csv("data.csv")
data.head()
```
渲染效果:
import pandas as pd
data = pd.read_csv("data.csv")
data.head()
行内图标
{{< icon name="python" >}} Python
渲染为
Python