Блог

Главная - Вопросы по программированию - как сделать так, чтобы docusaurus загружался в подкаталог вместо веб-корня

как сделать так, чтобы docusaurus загружался в подкаталог вместо веб-корня

#docusaurus

#докузавр

Вопрос:

От node_modulesdocusauruslibpublish-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 с открытым исходным кодом.

Кроме того, HTML, который генерирует docusaurus, содержит <link rel="stylesheet" href="/css/main.css"/> в себе, что отлично работает при создании вашего сайта npm run start (что приводит к тому, что файлы находятся в корневом каталоге web), но не так много при использовании publish-gh-pages.js поскольку main.css затем живет по адресу /${PROJECT_NAME}/css/main.css .

Итак, как я могу сделать то же самое — сделать так, чтобы мой веб-сайт, созданный на docusaurus, загружался в корневой каталог web, а не в подкаталог?

Ответ №1:

Проблема заключалась в том, что репо не было названо project_name.github.io — он назывался docs. То, что это приведет к тому, что docusaurus выполнит процесс сборки, видно из сценария сборки, НО, по-видимому github.com сам по умолчанию будет иметь подкаталог для github.io, если только ваше имя репо не project_name.github.io . Это можно увидеть, прокрутив страницу «Настройки» до нижней части страницы.

Метки: ,