hugo-fixit 收录于 GitHub 和开源项目

2025-01-08 2025-01-18 约 200 字预计阅读 1 分钟 - 次阅读

shortcode-asciinema | FixIt

一个带有 asciinema-embed shortcode 的 Hugo 主题组件。

Demo

安装主题#CLI | FixIt

要求

适用于所有 Hugo 主题。

安装组件

安装方式与安装主题相同，有多种安装方式，任选一种即可，这里介绍两种主流方式。

作为 Hugo 模块安装

首先确保你的项目本身是一个 Hugo 模块。

然后将此主题组件添加到你的 hugo.toml 配置文件中：

1
2
3
4
5
[module]
  [[module.imports]]
    path = "github.com/hugo-fixit/FixIt"
  [[module.imports]]
    path = "github.com/hugo-fixit/shortcode-asciinema"

在 Hugo 的第一次启动时，它将下载所需的文件。

要更新到模块的最新版本，请运行：

1
2
hugo mod get -u
hugo mod tidy

作为 Git 子模块安装

将 FixIt 和此 git 存储库克隆到你的主题文件夹中，并将其作为网站目录的子模块添加。

1
2
git submodule add https://github.com/hugo-fixit/FixIt.git themes/FixIt
git submodule add https://github.com/hugo-fixit/shortcode-asciinema.git themes/shortcode-asciinema

接下来编辑项目的 hugo.toml 并将此主题组件添加到你的主题中：

1
theme = ["FixIt", "shortcode-asciinema"]

记录终端

你可以使用 asciinema 命令记录终端并将其上传到 asciinema.org。

1
2
3
asciinema rec demo.cast
# press <ctrl-d> or type "exit" when you're done
asciinema upload demo.cast

使用 Shortcode

以下是一个使用示例：

1
{{< asciinema-embed 697494 >}}

呈现效果如下：

A Hugo theme component with asciinema-embed shortcode.