robossembler.org/README.md

76 lines
2.1 KiB
Markdown
Raw Normal View History

# Документация проекта "Робосборщик"
2021-04-02 14:38:59 +03:00
## Внесение изменений
2021-04-02 14:38:59 +03:00
### В существующие страницы
2021-04-02 14:38:59 +03:00
Войти в директорию `docs/` и редактировать нужный документ:
`docs/doc-to-be-edited.md`
```markdown
---
id: page-needs-edit
title: This Doc Needs To Be Edited
---
Edit me...
2021-04-02 14:38:59 +03:00
```
## Создание новых страниц
2021-04-02 14:38:59 +03:00
### Добавление новых страниц в существующие директории
1. Создайте документ с расширением .md в директории `/docs`, например `docs/newly-created-doc.md`(id должен совпадать с названием файла без расширения .md):
```md
---
id: newly-created-doc
title: Заголовок страницы
---
Новый контент..
```
1. Создайте ссылку на новый документ через id в боковое меню в файле `website/sidebars.json`:
```javascript
// Добавить документ newly-created-doc в раздел "Введение" в docs
{
"docs": {
"Введение": [
"quick-start",
"newly-created-doc" // сюда добавляется новый документ, название без .md
],
...
},
...
}
2021-04-02 14:38:59 +03:00
```
Дополнительная информация по редактированию контента [here](https://docusaurus.io/docs/en/navigation)
Этот сайт создан с помощью [Docusaurus 2](https://v2.docusaurus.io/), a modern static website generator.
2021-04-02 14:38:59 +03:00
## Установка
2021-04-02 14:38:59 +03:00
```console
yarn install
2021-04-02 14:38:59 +03:00
```
## Запуск сервера для локальной разработки
2021-04-02 14:38:59 +03:00
```console
yarn start
```
Можно смотреть изменения в коде онлайн - перезапуск сервера не требуется
## Сборка
2021-04-02 14:38:59 +03:00
```console
yarn build
2021-04-02 14:38:59 +03:00
```
Команда генерирует статический контект в директории `build`. Контент потом можно разместить как html на хостинге.