问题标签 [docsy]

For questions regarding programming in ECMAScript (JavaScript/JS) and its various dialects/implementations (excluding ActionScript). Note JavaScript is NOT the same as Java! Please include all relevant tags on your question; e.g., [node.js], [jquery], [json], [reactjs], [angular], [ember.js], [vue.js], [typescript], [svelte], etc.

0 投票
1 回答
268 浏览

internationalization - Hugo Docsy 多语言图片路径引用

我是主题为Docsy的静态站点生成器Hugo,但我很难提供正确的路径以便 Hugo 可以找到我的图像?

我读过 Hugo 的内容组织将在Page Bundle或项目static目录 中搜索图像。请参阅 Hugo 目录结构:静态

我正在为我的项目中的图像使用 Page Bundle 组织。
我的图像的路径是: My_Hugo_Docsy_Project/content/en/docs/My_Page_Bundle/assets/image_file.jpg

我正在使用常规降价来包含图像,但这不起作用:

![Image1](/assets/image_file.jpg)

我相信 Docsy 的多语言功能(国际化)导致挂起,它按语言嵌套内容目录结构。

0 投票
2 回答
18315 浏览

node.js - 意外的令牌 { ../node_modules/fs-extra/lib/mkdirs/make-dir.js:85 } 捕捉 {

我在构建我的应用程序时遇到了这个问题-

语法错误:意外的令牌 {

我无法理解是什么原因造成的。我正在尝试将代码从 cfn 迁移到 cdk。请帮我解决这个问题。

0 投票
2 回答
300 浏览

hugo - 不支持带有协议 (http) 的 hugo URL

我正在使用 hugo ( https://gohugo.io/ ) 并尝试在菜单中创建外部链接 (docsy 主题)。

我将 _index.md 更改为:

然而,雨果报告:

谁能建议如何直接在菜单上创建外部 URL 链接?

谢谢,格雷戈尔

0 投票
0 回答
371 浏览

node.js - CircleCI 在 fs-extra node_modules 失败

我一直在做一个项目,最近在 Circle CI 管道中,我开始遇到这个错误。

我在网上看到一些关于它的讨论。

https://github.com/google/docsy/issues/265

https://www.gitmemory.com/issue/jprichardson/node-fs-extra/790/614647362

版本是 12.16.1 fs-extra 版本是 9.0.1,在这种nodejs情况下,它被称为 ^9.0.0。

有谁知道这个错误来自哪里,以及如何解决它?似乎我与我的节点版本(超过 v10)和 fs-extra 保持一致。我不喜欢降级,除非它是唯一的解决方案。

0 投票
1 回答
198 浏览

swagger-ui - Hugo Docsy SwaggerUI 短代码不呈现规格文件

我正在尝试使用Hugo Docsy SwaggerUI Shortcode呈现 OAS 文件,但呈现的页面不包含预期的结果。

这是我的rest-api.md文件:

这是渲染的页面:

呈现的页面

如您所见,HTML 包含以下尝试呈现 OAS 文件的脚本:

需要注意的是,http://localhost:1313/access.yaml成功解析到access.yaml文件。

是什么阻止了 OAS 文件被呈现?