docs(editorial policy)#52
Conversation
Closes #3760
|
@gizeasy хочу заменить пример компонента на какой-нибудь более простой и короткий. посмотри, пожалуйста, как выйдешь с больничного |
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
|
@linturaven , посмотри, пожалуйста, страницу "Структура документации". Получится ли переделать эту схему и другие картинки так, чтобы было красиво и не громоздко. |
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
edit documentation structure and add setting up documentation
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
|
|
||
| ## Настройки раздела | ||
|
|
||
| В файле с раширением `.tsx` вы можете задать настройки раздела: |
There was a problem hiding this comment.
раширением -> расширением
| Документация состоит из двух типов файлов: | ||
|
|
||
| - [страница раздела](#страницы-раздела) – файл с расширением `.mdx`. | ||
| - [настройки раздела](#настройки-раздела) – файл с расширением `.tsx`. |
There was a problem hiding this comment.
Давай будем писать про расширение .ts. .tsx - используется в как обозначение jsx синтаксиса а в настройках его обычно нет. Просто сборка по может кушать и .ts, и.tsx. Но правельнее использовать .ts
|
|
||
| Где: | ||
|
|
||
| - `title` – название страницы. Оно будет отображаться вверху страницы в качестве заголовка H1. |
| - `group` – группа (раздел), к которой принадлежит страница. Все группы разделов можно посмотреть в папке `stand` в файле `standConfig.ts`. | ||
| - `order` – порядок отображения страницы на портале. Так, чтобы отобразить страницу в первом разделе второй, задайте значение `120`. | ||
| - `alias` – ключевые слова для поиска по порталу. | ||
| - `description` – краткое описание содержимого страницы. Отображается на портале внизу названия страницы. |
There was a problem hiding this comment.
Отображается на портале внизу названия страницы.
->
Отображается под заголовком страницы.
|
|
||
| Где: | ||
|
|
||
| - `title` – название страницы. Оно будет отображаться вверху страницы в качестве заголовка H1. |
| <> | ||
|
|
||
| ```jsx | ||
| import { createStand } from '##/stand/standConfig'; |
There was a problem hiding this comment.
Кажется что не нужно спутывать понятия раздел, страница, группа.
createStand - создает страницу, страница может быть о компоненте а может в общем рассказывать о принципах(и т.п.)
Страница существует в группе, группа в библиотеке.
| </> | ||
| </MdxTabs> | ||
|
|
||
| ## Страницы раздела |
| - [страница раздела](#страницы-раздела) – файл с расширением `.mdx`. | ||
| - [настройки раздела](#настройки-раздела) – файл с расширением `.tsx`. | ||
|
|
||
| ## Настройки раздела |
There was a problem hiding this comment.
ввести понятие стенда
раздел это стенд
.stand.mdx - главная страница стенда
dev.stand.mdx и прочие tab.stand.mdx - второстипеные страницы
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
|
мб не "предупреждение", а "важно" |
|
убрать блок "Заметки" |
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
2169f1f to
03848c2
Compare
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |
1 similar comment
|
🎉 Deployed at http://refs-pull-52-merge---portal.consta.design |

closes consta-design-system/uikit#3760
Добавленные разделы:
Разделы будут обновляться по мере добавления новых разделов в связи с:
Informerв доку!Не заливать на портал до момента добавления всех разделов. Я отпишусь, когда добавлю всё