使 docusaurus 上传到子目录而不是网络根目录

Question

来自 node_modules\docusaurus\lib\publish-gh-pages.js:

      const websiteURL =
        GITHUB_HOST === GITHUB_DOMAIN
          ? `https://${ORGANIZATION_NAME}.github.io/${PROJECT_NAME}` // gh-pages hosted repo
          : `https://${GITHUB_HOST}/pages/${ORGANIZATION_NAME}/${PROJECT_NAME}`; // GitHub enterprise hosting.

我的问题是...为什么要将文档上传到子目录？如果我想把它上传到根目录怎么办？我该怎么做？

docusaurus v1 网站的首页更像是带有“功能标注”等部分的醒目页面。总的来说，它似乎最适合作为根页面，因为它似乎适合 https://hermesengine.dev/ , https://hydra.cc/ 以及几乎所有其他 Facebook 开源项目。

此外，docusaurus 生成的 HTML 中包含 <link rel="stylesheet" href="/css/main.css"/>，当您使用 npm run start 构建网站时效果很好（这会导致文件存在于网络中root), 但在使用 publish-gh-pages.js 时不是那么多，因为 main.css 然后住在 /${PROJECT_NAME}/css/main.css.

那么我该如何做 - 使我的 docusaurus 构建的网站上传到网络根目录而不是子目录？

Answer 1

回购是回购未命名 project_name.github.io - 它被命名为 docs。这将导致 docusaurus 执行构建过程，从构建脚本中可以明显看出，但显然 github.com 本身将默认为 github.io 的子目录，除非你的 repo 名称是 project_name.github.io。这可以通过滚动到“设置”调出的页面底部看到。

使 docusaurus 上传到子目录而不是网络根目录

making it so docusaurus uploads to subdirectory instead of web root

docusaurus