问题标签 [docusaurus]

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 回答
383 浏览

docusaurus - 在 docusaurus 中添加嵌入模式

我正在使用 docusaurus 1.14.4 我需要为每个文档创建嵌入模式,以删除页眉、页脚和左侧导航。

页面 url 看起来像这样http://localhost:3000/...../?mode=emb

我想出了一种方法,将这段脚本添加到每个 md 文件中

它可以工作,但看起来不是正确的方法。任何人都可以提出更好的方法吗?

0 投票
0 回答
84 浏览

documentation - ERR_FILE_NOT_FOUND 创建 Docusaurus 文件时

我正在使用 Docusaurus 创建文档。
使用以下命令创建静态文件。

但是构建目录有问题。它正在添加源如下:

因此在加载时会导致问题:

0 投票
2 回答
678 浏览

google-analytics - Docusaurus,使用 Google Analytics 跟踪操作

我有一个 docusaurus 作为我公司网站的前端。我想知道,如何跟踪对管理员页面中登录表单链接的点击。

此链接位于 siteconfig.js 中:

我尝试添加自定义标签,如下例所示,但 docusaurus 忽略了这种结构

有人对如何做到这一点有想法吗?

0 投票
1 回答
291 浏览

docusaurus - 如何在 Docusaurus 1.x 上添加顶部警报横幅?

我想在我的 Docusaurus 网站上显示一些全球信息。就像是:

例子

https://codesandbox.io/s/duudl

https://next.ant.design/components/alert/

这可能吗?

0 投票
2 回答
253 浏览

docusaurus - Docusaurus v2 - 主页的最近博客列表

在 Docusaurus v2 中,有没有一种方法可以生成最近的博客列表,然后可以使用这些列表来填充首页(src/pages/index.js)上的块?我正在考虑类似于features然后由<Feature ... />.

在 Docusaurus v1 中,下面的代码对此进行了补充,但我找不到一种简单的方法来获取所有博客文章的列表,相当于MetadataBlog

在对代码进行了一些研究之后,我相信我只想能够generateBlogPosts@docusaurus/plugin-content-blog/lib/blogUtils.js. 关于如何调用该函数的任何指针src/pages/index.js?谢谢

0 投票
2 回答
1009 浏览

documentation - 可以从多个存储库发布 docusaurus 交叉存储库,以将文档聚合在一起吗?

我的问题:是否有任何开箱即用的 docusaurus 功能(除了https://github.com/facebook/docusaurus/pull/764)可以使以下操作更容易?(我在这里问过这个问题,因为他们的 github 问题模板告诉我这种类型的问题将被关闭,而是在这里问他们)。

在我的公司,我们有几个不同的存储库,其中包含 markdown 文档以及从各种不同编码语言的源代码文档生成的 markdown。

我想探索使用 docusaurus 来定义一个中心站点,但从许多不同的存储库中提取文档。

我想这样做:

  • 得到一个集中的搜索索引
    • 帮助可发现性
  • 获得集中拥有的一致主题/UX
  • 继续发布到融合中,以便非技术用户可以找到和浏览内容,如果这成为公司使用的政策(:()
  • 保留 docs-close-to-code 的所有优点

这是 docusaurus 所期望的结构:

这是我想最终得到的已发布网站的结构:

v1是不是因为我预测我会忘记一些东西,它让我可以对冲这一点,并使以后的重大更改重定向更容易)

我认为因此这是我需要将事物聚合成的中间结构:

……这能连在一起吗?

我可以很容易地通过 bash 或子模块 git clone 来安排它;这不是一个特别的问题。我想知道是否已经存在一些东西可以让我避免需要这样做 - 例如文档站点工具的本机功能、bazel 规则等等。

0 投票
1 回答
135 浏览

docusaurus - Docusaurus v2 中博客的子域而不是路径

有没有办法配置 docusaurus v2,所以博客不是配置为路径,而是配置为子域?

想实现blog.page.tld而不是page.tld/blog

从有关如何将博客集成到 docusaurus v2 的文档中找不到这样做的方法。

0 投票
1 回答
197 浏览

css - 如何改变Docusaurus中文档的身体方向?

我在没有登录页面的情况下运行我的 Docusaurus 2 站点,而是重定向到侧边栏中的第一个 .md 文件。为此,我按照以下链接中的说明进行操作,效果非常好:

https://v2.docusaurus.io/docs/next/configuration#docs-only-mode

现在,我想要一个多语言网站,英语和波斯语。波斯语要求网站右对齐,但我不知道该怎么做。我在我的项目中不使用任何页面,我只使用 pages 文件夹中的 .js 文件来重定向到文档。

谁能帮我解决这个问题?

0 投票
1 回答
234 浏览

reactjs - 将 Docusaurus v2 部署到 GitHub 页面时,Travis CI 中未定义 Jest

我目前正在 GitHub 页面上设置 Docusaurus v2 站点。我为自己的组件编写了自己的 Jest 和 Enzyme 测试。目前 Jest 被列为 adevDependency和 my.travis.yml如下:

我已经更新了我的package.jsonscrips 部分以调用 jest 相对于node_modules这样的:

这在 travis 中运行得非常好,我看到我所有的测试都通过了。我遇到的问题是当它尝试将站点部署到 GitHub 页面时,如:scripts部分的最后一行所示。我随后收到以下错误:.travis.ymlnpm t && GIT_USER="${GH_NAME}" npm run deploy

我可能是错的,但我相信这是因为我的测试被部署为代码库的一部分,并且开玩笑的是,devDependency它在这个阶段不存在;因此,当它在我的文件中使用时,webpack 找不到它*.spec.js,即jest.mock(...). 因此,我认为将 jest 添加为正常依赖项可以解决此问题,尽管您可以理解这既不理想也不是正确的方法。作为参考,我没有我的测试文件__TESTS__或任何形式的测试目录。当我遵循容器模式时,我的所有规范文件都与他们正在测试的内容相邻。其结构与此类似:

快速旁注: 由于反应钩子,并不是我所有的组件都有容器,但有些组件确实使用了多个状态、事件处理程序等;在这些情况下,我觉得将它们分成一个容器更干净。

除了让 jest 成为常规依赖项之外,我还有更好的方法来解决这个问题吗?我之后的设置是:

  1. 用户提出拉取请求并 Travis 构建分支(仅传递要合并的 PR)。
  2. 一旦 PR 登陆 master Travis 就会运行上面的脚本并部署到 Github 页面。

任何帮助将非常感激 :)

0 投票
2 回答
352 浏览

docusaurus - Docusaurus V2 - 在文档中使用 og:title 的页面标题

目前我og:title正在使用配置中定义的标题而不是当前文档标题。

我已将文件从 更改.md.mdx并尝试在<Head>组件中定义它,但这不起作用。

任何帮助将非常感激。

谢谢。