问题标签 [hugo-shortcode]

免责声明：这是对Hugo 论坛上未回答的问题的重新发布。如果这不酷，请告诉我，我会删除/编辑它。

我正在尝试使用Hugo（静态网站生成器）来替换企业营销网站。我可能会解决这个问题，所以在我进入我的黑客解决方案之前，我会尝试表达我的愿望。

我的目标

对于我公司的网站，我们有几类迭代内容，例如“案例研究”和“顾问”。这些类别已经组织在树中。

我想创建 *.md 页面，允许非技术内容创建者自定义页面顶部的标题和一些内容，在此之下，我想添加一系列部分，每个部分列出其中一个子目录的帖子。

示例输出可能如下所示：

我现在怎么做

我正在为每个基于准列表的索引页面创建自定义布局，并且布局使用部分呈现与自定义 .Params.type 匹配的每个页面。所以我的 /content/about/index.md 页面在 /layouts/about.html 文件中进行了大量定制。

我觉得应该有更好的方法来至少执行以下操作之一：

• 使用可以访问 .Site.Pages 对象的简码，因此我的内容创建者可以{{< list 'leader' >}}在内容页面的任何位置编写类似内容，以获取所有内容的列表.Params.type = 'leader'
• 使用自定义布局，但遍历该页面的“子”页面，而不是按类型过滤所有页面。
• 使用 list.html 页面模板，而不会牺牲为内容创建者轻松定制降价内容的能力。

这些方法在现有技术上是否可行，而我只是在文档中遗漏了一些核心概念？理想情况下，我希望能够做的不止一个，这样网站的主页就可以通过简码挑选一些内容列表，但有几个部分会自动分组其子目录的列表。这样，内容创建者可以自由添加小节，而不会牺牲微调主页的能力。

我正在尝试在 Hugo 静态生成的站点的内容中使用变量。例如，内容如下所示：

1. 转到您网站的网址 ( {{ .Site.BaseURL }})
2. 输入您的凭据
3. .....（等等等等等等）

当它被渲染时，该{{ .... }}部分没有得到处理......它与我上面所说的保持不变。我也试过$在前面加上。模板中的变量似乎工作得很好。我是否需要创建一个简码以在内容页面中使用？

我正在使用HUGO建立一个博客，作为评论代码仓库，并且我正在包含来自帖子仓库的源文件。

我已经能够让它进入工作状态并想要改进它，但我被卡住了。

我做了什么

在 HUGO 站点根目录中有一个 .gitignore 的repos目录，它包含源代码 repos。

有一个getSourceFile.html短代码：

然后，在帖子中，我可以像这样使用简码：

我明白了：

这非常好，因为我不必复制和粘贴代码，它是 100% 最新的，我相信它可以编译。

但这就是我卡住的地方！

我想做什么

1) 在前面设置 repo root 以便简码更易于使用，如下所示：

2）能够将语言作为参数传递给简码以在突出显示功能中使用它，就像这样（这不起作用）：

获取源文件.html：

或者更好的是，从文件扩展名中推断出来！;-)

我认为这应该不会太难，但这是我第一次使用 Hugo、Go 和模板，所以，有人可以帮我解决这个问题吗？

提前致谢。

我想使用 blogdown 在 RMarkdown 文件中通过简码显示图像。我使用代码：

我没有收到错误消息，只是网站上有一个空白区域。图片不显示。简码通常有效，我用推特卡尝试过。

路径是正确的，因为用knitr显示的是同一张图片。（该路径在普通文档中也可用作简码.md。）如果我不在.Rmd文件中使用 alt 参数，那么简码命令的代码会显示在网站上 -- 不仅适用于该命令，而且适用于所有其他命令（以前工作）短代码。例如，我得到了以下网页片段：

另一个与数字有关的问题：如果我使用标准命令：

网页在图片下方显示替代文字“一些替代文字”。

我正在使用 hugo-academic 主题，这是我的会话信息：

我正在尝试为引导选项卡创建一个简码。我有以下 HTML 结构，

该结构还包含 Hugo 占位符。但是代码的内部部分，即，

与相应的内容 div 一起需要多次，即，

现在的问题是我必须将其id作为内部结构的参数传递，并且应该与其父级分离。我应该能够通过以下方式使用简码：

我怎样才能做到这一点？

我一直在考虑将 blogdown 用于我现有的 Hugo 博客，我认为我已经将其缩小到一个缺点。我正在使用 .Rmarkdown 文件扩展名，因为我想使用 Blackfriday 降价处理器来利用 Hugo 功能。

其中包括我添加到我的主题中的自定义项，它使用内置短代码嵌入的任何图像使用 PhotoSwipe 使它们在点击时出现在灯箱中。我已经做到了，任何使用{{< figure >}}简码的东西都可以做到这一点。

是否可以通过 blogdown 或 knitr（假设 knitr 是渲染 Rmarkdown 过程的一部分）来自定义绘图的输出，以便将它们包装在短代码而不是 HTML 标签中？我认为如果我至少可以在 Markdown 中格式化绘图，甚至可以使用 Go/Blackfriday 来做到这一点![](/path/to/img.jpg)，如果这会更容易的话。

我正在使用 blogdown 和 kakawait/hugo-tranquilpeak-theme 来写一篇普通的降价博客文章。当我添加带有短代码选项标签的图像时，例如

我无法打破图像的标题。我现在有

但我想

顺便说一句，这些休息：

不要为我工作。知道如何解决这个问题吗？

我想在我的博客上发布一张图片（是的，就是这么简单！）

我的网站托管在 GitLab Pages 上并使用 Hugo 框架 (v0.23)。我从这里分叉了我的网页，https://gitlab.com/pages/hugo（因此我的博客文件夹结构是相同的）。

我的内容发布正常并存储在这里：home/content/post

我在这里创建了一个存储图像的文件夹：home/content/post/images

当我将图像插入帖子时，图像不会发布。我试过在帖子（下面）中使用相关的短代码，但没有成功：

1. {{< 图 src="image/image_name.png" title="图片标题" >}}
2. {{< 图 src="/image/image_name.png" title="图片标题" >}}

在哪里：

• 图片存储在这里：home/content/post/images/image_name.png
• 帖子存储在这里：home/content/post/post_title.md

我怀疑问题是我添加的新图像文件夹不知何故没有“看到”。

请帮忙！

我尝试创建一堆本地 HTML 文件，这些文件应该作为某些软件的文档。不应该涉及网络服务器，只需要网络浏览器查看的 HTML 文件。我使用 hugo 创建页面，但在链接到主页 (index.html) 时遇到问题。

我config.toml的是这样的：

我的主页_index.md在根文件夹中。

如何创建短代码或任何创建到index.html根文件夹（contenthugo 中的文件夹）的相对链接的内容。该index.html页面已创建，但我尚未成功创建指向该页面的链接。当然，我可以对链接进行硬编码，但这不是我想要的。

示例存储库位于https://github.com/pgundlach/hugoexample/。

我尝试了一个具有类似定义的简码，{{ with .Site.GetPage "section" "_index.md" }}{{ .Relpermalink }}{{ end}}但这没有用。

披露：这实际上是我在https://discourse.gohugo.io/上尝试过的一个问题，但没有任何运气。所以这个问题可能是“愚蠢的”，或者我遗漏了一些明显的东西。

Hugo 有一个YouTube 短代码。我想将它与数据模板结合使用，以显示由 JSON 文件内容驱动的视频列表。

理想情况下，在 中site/content/index.md，我会有这样的东西：

在 中site/data/youtube.yml，我会有这样的东西：

这样我在.yml文件中列出的每个视频 ID 都会在我的主页上呈现为嵌入的 YouTube 视频。

这里的问题是我似乎无法像range在.md文件中那样使用 hugo 函数。当我尝试这个时，第一个代码片段只是被呈现为文本，而不是被 YouTube 视频替换：

很公平，让我们将代码提取到一个部分中site/layouts/partials/youtube-list.html：

然后我们将修改site/content/index.md以引用部分：

现在，当我尝试运行服务器时，Hugo 告诉我我不能使用<部分字符：

伟大的。我想我可以创建一个自定义简码，但它们似乎有相同的限制 - 简码不能引用另一个简码：

我想我可以在 Hugo 的 GitHub 存储库中找到 YouTube 短代码的源代码并“借用”它批发用于我的新短代码，但这似乎是不必要的代码重复。

tl; dr：有没有办法在 Hugo 中组合数据模板和简码，以便使用相同的简码来呈现从数据模板读取的列表中的每个元素？