问题标签 [docusaurus]

我正在尝试渲染浏览器，如 Docusaurus 指南中所示：

• 文件应该file-name.mdx代替.md吗？（我试过了，没用。）
• 我试图从这里复制代码，但没有运气。任何人都可以帮忙。这是一个相当新的框架，我在互联网上找不到任何解决方案。有船长救援吗？

据我所知，Docusaurus 支持自定义页面，但是有没有办法在一个 Docusaurus 项目中拥有两个文档？

原始导航栏项目有：

• 文档
• 博客
• ...

我想要这样的东西：

• 文档 1
• 文档 2
• 博客
• ...

我知道我可以在一个文档中创建许多子文件夹，但出于某种原因，我想要一个两个文档结构，这为我提供了一种更简洁的方式来访问文档。

如果 Docusaurus 目前无法提供此功能，请问是否有其他文档框架提供此功能？

有没有一种简单的方法可以在 Docusaurus V2 markdown 中创建可折叠部分？

会在 GitHub 上寻找类似的东西：https ://gist.github.com/joyrexus/16041f2426450e73f5df9391f7f7ae5f

I've been trying to get environment variables to work in my documentation build.
I've had some success with adding a dotenv-webpack plugin and substituting values that way. This has the downside of needing a .env file of some kind

I would like to have my build know of environment variables automatically ie. everything that is output from printenv

I've tried adding this to package.json: TEST_ENV_VAR=working docusaurus start" But when I log the process.env object there is nothing there.

How can I make this work?

我们正在制作一个V2 Docusaurus网站。

在服务器中建好网站后，我们可以很好地使用 https。这是一部分my_server_block.conf：

在 localhost 中，http 有效。但是，我们现在需要在 localhost 中测试 https。但是 https 返回一个错误，虽然我是从HTTPS=true yarn start:开始This site can’t provide a secure connection localhost sent an invalid response. ERR_SSL_PROTOCOL_ERROR的

有谁知道我应该怎么做才能使 https 在 localhost 中工作？

编辑1：我试过了HTTPs=true SSL_CRT_FILE=certs/server.crt SSL_KEY_FILE=certs/server.key yarn start，https://localhost:3001仍然返回同样的错误。请注意certs/server.crt和certs/server.crt是使 https 通过 ngnix 在我们的生产服务器中工作的文件：

我正在接管V2 Docusaurus的网站。

我们网站的一个特殊之处是我们需要加载office.js和css-vars-ponyfill.min.js，并在一开始就进行一些操作。所以之前的开发者决定使用下面的方法。

在每一.mdx.md页中，他都用一个组件包装了内容MainWrapper：

MainWrapper/index.js定义如下

CssvarsWrapper/index.js定义如下

OfficejsWrapper/index.js定义如下

lib/Patches.js包含实际操作：

但是，我的测试表明，无论defer标签如何，此实现都不能始终遵守正确的文件加载顺序。例如，如下面的屏幕截图所示，css-vars-ponyfill.min.js fully loaded in CssvarsWrapper并且office.js fully loaded in OfficeWrapper是 before patches.js fully loaded，因此onCssVarsPonyfillLoad在onOfficejsLoad调用它们时还没有准备好。

实际上，我们应该确保patches.js总是在css-vars-ponyfill.min.js和office.js之前加载。有谁知道如何确保这一点？

此外，这种方法（即，围绕每个页面的内容包装一个组件以在上游进行一些操作）是否正确？

我正在努力配置 Algolia 搜索，以便它只返回当前版本的结果。我试图将其包含在 algolia 配置部分中；但是，它现在不返回任何内容。如果我删除此代码，搜索栏会建议来自多个版本的结果。你们对如何让它工作有什么建议吗？谢谢

我正在通过V2 Docusaurus建立一个网站。

我想在页面中嵌入一个 youtube 视频。我希望框架的宽度是100%页面的宽度。我尝试了很多解决方案，但没有找到完美的解决方案。目前，我正在使用以下代码：

它在桌面上运行良好，但我意识到它在手机上运行不佳：

有人有什么主意吗？

我们想在我们的在线网站中实施 Google Analytics，但是当我们添加代码时，我们的菜单和页脚就会消失。

根据官方网站https://v2.docusaurus.io/docs/using-plugins/#docusaurusplugin-google-analytics上的文档，这可以通过更新docusaurus.config.js和添加插件@docusaurus/plugin-google-analytics或添加到 present 来实现@docusaurus/preset-classic。

1. 使用以下代码作为插件安装，隐藏了我们的菜单和页脚（只是消失了）。但谷歌分析确实记录了实时流量。

2. 尝试通过现有的激活它@docusaurus/present-clasic不会处理任何事情（Chrome 检查器没有访问 Google 的流量并且 AdBlock 未激活）

有人在 Docusaurus V2 上成功激活了 Google Analytics 吗？

感谢您的帮助！

我们可以使用 Docusaurus 来记录我们的商业项目吗？我们想在我们的公共领域发布带有 docusaurus 的文档。

问候， 富尔坎