标签: docusaurus
如何在Docusaurus V2的index.html的头部添加自定义脚本？
我们正在使用Docusaurus V2创建一个网站。
在Docusaurus V1中，有一个scripts设置siteConfig.js可以定制html的头部内容。但是，我在Docusaurus V2中找不到相应的设置。
根据https://docusaurus.io/blog/2018/09/11/Towards-Docusaurus-2#layout，似乎可以自定义<head>V2中的html 部分。
布局
Docusaurus的当前状态是它负责整个布局和样式，无意中使用户很难根据自己的意愿自定义网站的外观。
对于Docusaurus 2，布局和样式应由用户控制。Docusaurus将处理内容的生成，路由，翻译和版本控制。受create-react-app和VuePress的启发，Docusaurus仍将提供默认主题，用户可以从中弹出该主题，以进行进一步的布局和样式自定义。这意味着用户甚至有可能通过使用React Helmet来更改HTML元数据。基于社区的主题也很有可能。大多数静态站点生成器都采用这种允许用户负责布局和样式的方法。
我试图用react-helmet的src/pages/index.js，用下面的代码：
function Home() {
const context = useDocusaurusContext();
const { siteConfig = {} } = context;
return (
<Layout
title={`Hello from ${siteConfig.title}`}
description="Description will go into a meta tag in <head />">
<Helmet>
<script src="https://appsforoffice.microsoft.com/lib/1/hosted/office.js"></script>
</Helmet>
</Layout>
);
}
}
但是脚本https://appsforoffice.microsoft.com/lib/1/hosted/office.js没有出现在里面<head></head>
有没有人遇到过类似的问题，有人可以提供帮助吗？
推荐指数
解决办法
查看次数
从 docusaurus v2 中的登录页面重定向到文档
由于我没有登陆页面，我想重定向到主文档页面 docs/main
我尝试按照 v1 中的说明进行操作：https://docusaurus.io/docs/en/site-creation#docs-landing-page ，但它们似乎不适用于 v2。有人可以给我详细说明如何完成此任务吗？
我对 React 的经验非常有限。
推荐指数
解决办法
查看次数
Docusaurus - 如何在新选项卡中打开外部链接？
我正在使用 Docusaurus，并且想在新选项卡中打开外部链接。
我更愿意使用代码来实现此目的，而不是根据此答案在我的 markdown 文档中编写 html 代码的解决方案。
我已经尝试过这个答案：
[link](url){:target="_blank"}
以及这个答案：
[Google](https://google.com" target="_blank)
我认为这篇文章可能会做我想要的，我尝试将代码添加到 _index.js，但 Docusaurus 停止构建。
(function() {
var links = document.getElementsByTagName('a');
for (var i = 0; i < links.length; i++) {
if (/^(https?:)?\/\//.test(links[i].getAttribute('href'))) {
links[i].target = '_blank';
}
}
})();
我将 JavaScript 代码上传到GitHub并将其添加到siteConfig.js：
// Add custom scripts here that would be placed in <script> tags.
scripts: [
"https://buttons.github.io/buttons.js",
"https://msdcanderson.github.io/docusaurus-open-link-new-tab.github.io/open-link-new-tab.js"
],
该脚本似乎已加载，但未按预期工作。
我希望用 Markdown 编写的链接能够在新的浏览器选项卡中打开：
[the rmarkdown website](https://rmarkdown.rstudio.com) …推荐指数
解决办法
查看次数
我们如何将 Docusaurus 网站链接到数据库？
我正在用Docusaurus V2建立一个网站。
由于 Docusaurus 网站基本上是一个 React 应用程序，我想知道我们如何向网站添加身份验证系统。
是否有将 Docusaurus 网站链接到数据库、后端或调用 API 的指南或示例？
推荐指数
解决办法
查看次数
Docusaurus 中的超链接或图像居中
我正在使用Docusaurus V2构建一个网站。
我有一个文件链接：
[10Studio-Sample-EN.xlsx](https://www.10studio.tech/files/10Studio-Sample-EN.xlsx)
现在，我想将该链接放在中间（传统上使用text-align: center）。
我尝试了以下代码：
export const Center = ({children}) => (
<div
style={{
"textAlign": "center"
}}>
{children}
</div>
)
<Center>hahahaha</Center>
<Center>[10Studio-Sample-EN.xlsx](https://www.10studio.tech/files/10Studio-Sample-EN.xlsx)</Center>
它返回了这个：
hahahaha
[10Studio-Sample-EN.xlsx](https://www.10studio.tech/files/10Studio-Sample-EN.xlsx)
有谁知道居中超链接（或图像）的最简单方法是什么？
推荐指数
解决办法
查看次数
可以从多个存储库发布 docusaurus 交叉存储库，将文档聚合在一起吗？
我的问题：是否有任何开箱即用的 docusaurus 功能（除了https://github.com/facebook/docusaurus/pull/764）可以使以下操作更容易？（我在这里问这个是因为他们的 github 问题模板告诉我那种类型的问题将被关闭，而是在这里问他们）。
在我的公司，我们有几个不同的存储库，其中包含 Markdown 文档以及从各种不同编码语言的源代码文档生成的 Markdown。
我想探索使用 docusaurus 来定义一个中央站点，但从许多不同的存储库中提取文档。
我想这样做：
- 获取集中搜索索引
- 帮助可发现性
- 获得集中拥有的一致主题/用户体验
- 继续发布到 Confluence 中，以便非技术用户可以查找和浏览内容（如果这成为公司使用的政策）（:(）
- 保留 docs-close-to-code 的所有优点
这是 docusaurus 期望的结构：
docs/ # all documentation should be placed here
website/
blog/
build/ # on yarn run build
core/
Footer.js
package.json
pages/
sidebars.json
siteConfig.js
static/
这是我想要结束的已发布网站的结构：
/v1/products/{product}/{version}/{language}/{content as from docs/}
# e.g.
/v1/products/spanner/{version}/en-GB/readme.html
/v1/internal/{gh-org}/{gh-repo}/{language}/{content as from docs/}
#e.g.
/v1/my-org/my-repo/{version}/en-GB/readme.html
/v1/my-org/my-repo/{version}/en-GB/proto-generated.html
（v1是不是因为我预测我会忘记一些东西，它让我可以避免这种情况，并使以后的重大更改重定向更容易）
我认为因此这是我需要将事物聚合成的中间结构：
docs/
product/
language/
prose|generated-lang
gh-org/
repo/
language/
prose|generated-lang …推荐指数
解决办法
查看次数
在 Docusaurus 上，如何禁用外部链接 SVG？
我正在尝试在 Docusaurus 导航栏上实现Sign in和按钮...Sign up
...但由于我的应用程序位于子域中，Docusaurus 认为它们是外部链接并添加了这个丑陋的 SVG。
如何禁用外部行为？我正在寻找external:false导航栏配置，但找不到它。我也尝试过设置target:_self，但没有删除 SVG。
https://docusaurus.io/docs/api/themes/configuration#navbar
推荐指数
解决办法
查看次数
Docusaurus：如何在每个文档页面上显示“编辑此页面”链接？
我认为这将是一个相当简单的问题，但对于我的一生，我无法找出答案。
我想要的是：
- 我想显示我的 Docusaurus 文档页面，并在每个页面上都有“编辑此页面”链接。
我尝试过的：
- 我的理解是，通过配置该
editUrl属性，我会自动获得该行为（参见https://docusaurus.io/docs/api/plugins/@docusaurus/plugin-content-docs#editUrl）。
问题：
- 页面显示正常，但没有显示“编辑此页面”链接！
可能有助于解决问题的相关信息：
我有一个 docusaurus 网站，具有以下参数：
package.json（已编辑）
{
...
"scripts": {
"docusaurus": "docusaurus",
"start": "docusaurus start",
"build": "docusaurus build",
"swizzle": "docusaurus swizzle",
"deploy": "docusaurus deploy",
"serve": "docusaurus serve --build"
},
"dependencies": {
...
"@docusaurus/core": "^2.0.0-beta.14",
"@docusaurus/plugin-client-redirects": "^2.0.0-beta.14",
"@docusaurus/preset-classic": "^2.0.0-beta.14",
"@mdx-js/react": "^1.6.22",
"clean": "^4.0.2",
"clsx": "^1.1.1",
"docusaurus-gtm-plugin": "0.0.2",
"install": "^0.13.0",
"react": "^17.0.2",
"react-dom": "^17.0.2",
"redux": "^4.0.5",
"webpack": "^5.54.0",
"webpack-cli": "^4.8.0"
},
...
"devDependencies": {
"@babel/core": "^7.15.5"
}
}
docusaurus.config.js
module.exports …推荐指数
解决办法
查看次数
Github codespaces 项目实时预览无法正常工作
我正在运行一个简单的 Docusaurus 项目，npm start该项目运行成功。
使用 Github Codespaces 运行项目，但转发的路由似乎不起作用。
附上环境截图。
推荐指数
解决办法
查看次数
如何在 Docusaurus V2 中包含（导入）markdown 文件内容？
有没有办法将 Markdown 文件内容包含到 Docusaurus V2 中的另一个 Markdown 文件中？我正在尝试组织我的文档文件夹结构。
\n当我们创建一个 Markdown 文件时，例如在文档中，Docusaurus 会自动在其他一些项目文件中设置文件路径。我想知道如何使其与文档文件夹中的文件夹一起使用？
\n.\n\xe2\x94\x9c\xe2\x94\x80\xe2\x94\x80 docc\n\xe2\x94\x82 \xe2\x94\x9c\xe2\x94\x80\xe2\x94\x80 chapter1\n\xe2\x94\x82 \xe2\x94\x82 \xe2\x94\x9c\xe2\x94\x80\xe2\x94\x80 index.md\n\xe2\x94\x82 \xe2\x94\x82 \xe2\x94\x9c\xe2\x94\x80\xe2\x94\x80 session1.md\n\xe2\x94\x82 \xe2\x94\x82 \xe2\x94\x94\xe2\x94\x80\xe2\x94\x80 session2.md\n\xe2\x94\x82 \xe2\x94\x94\xe2\x94\x80\xe2\x94\x80 chapter2\n\xe2\x94\x82 \xe2\x94\x9c\xe2\x94\x80\xe2\x94\x80 index.md\n\xe2\x94\x82 \xe2\x94\x9c\xe2\x94\x80\xe2\x94\x80 session1.md\n\xe2\x94\x82 \xe2\x94\x94\xe2\x94\x80\xe2\x94\x80 session2.md\n\xe2\x94\x9c\xe2\x94\x80\xe2\x94\x80 doc1.md\n\xe2\x94\x9c\xe2\x94\x80\xe2\x94\x80 doc2.md\n\xe2\x94\x94\xe2\x94\x80\xe2\x94\x80 doc3.md\n推荐指数
解决办法
查看次数
标签 统计
docusaurus ×10
reactjs ×3
javascript ×2
markdown ×2
codespaces ×1
github ×1
hugo ×1
nginx ×1
react-helmet ×1