Creating your site · Docusaurus

Docusaurus был создан, чтобы максимально упростить для вас создание сайтов и документации к вашим проектам с открытым исходным кодом.

После установки и настройки, большая часть работы по созданию основы сайта для вашей документации уже должна быть завершена.

Структура сайта

Структура вашего сайта может выглядеть следующим образом:

root-directory
├── docs
└── website
    ├── blog
    ├── core
    │   └── Footer.js
    ├── package.json
    ├── pages
    ├── sidebars.json
    ├── siteConfig.js
    └── static

Предполагается, что вы удалили образцы .md файлов, установленные командой инициализации.

Все файлы вашей документации должны представлять собой .md файлы markdown и быть размещены в каталоге docs. Любое сообщение блога должно быть размещено в каталоге blog.

Сообщения блога должны иметь имя вида YYYY-MM-DD-your-file-name.md

Создание основы вашего сайта

Чтобы создать полнофункциональный сайт, вам нужно выполнить всего несколько шагов:

Добавьте документацию в виде .md файлов в каталог /docs, убедитесь что каждый файл имеет надлежащий заголовок. Ниже представлен пример простейшего заголовка, где id - это наименование ссылки (например, docs/intro.html), а title - это заголовок страницы в браузере.
```
---
id: intro
title: Getting Started
---

My new content here..
```
Add zero or more docs to the sidebars.json file so that your documentation is rendered in a sidebar if you choose them to be.

Если вы не укажите свои документы в файле sidebars.json, то они будут обработаны, но ссылки на них будут доступны только из других документов и перейти на них можно будет только зная их URL.

Чтобы настроить сайт, измените файл website/siteConfig.js, следуя указаниям из комментариев в каталоге docs и в файле website/siteConfig.js.
Создайте любые пользовательские страницы и/или настройте файл website/core/Footer.js, в котором содержится футер вашего сайта.
Разместите ресурсы, такие как изображения, в каталоге website/static/.
Запустите сайт, чтобы увидеть результат изменений.

cd website
yarn run start # или `npm run start`
# перейдите по адресу http://localhost:3000

Особые настройки

Посадочная страница

Если вы желаете разместить свою посадочную страницу прямо среди своей документации, вы можете следать это с помощью переадресации.

Удалите файл index.js из каталога website/pages, если он там есть.
Добавьте пользовательскую статическую страницу index.html в каталог website/static, содержащую следующий код:

<!DOCTYPE HTML>
<html lang="en-US">
    <head>
        <meta charset="UTF-8">
        <meta http-equiv="refresh" content="0; url=docs/id-of-doc-to-land-on.html">
        <script type="text/javascript">
            window.location.href = "docs/id-of-doc-to-land-on.html"
        </script>
        <title>Заголовок вашего сайта</title>
    </head>
    <body>
        Если ваш брузер не поддерживает автоматическую переадресацию, перейдите по этой ссылке: <a href='docs/id-of-doc-to-land-on.html'>link</a>.
  </body>
</html>

Вы получите идентификатор документа для привязки к его метаданным в формате .md.

Блог без документации

Вы также можете использовать Docusaurus чтобы создать блог без документации.