mirror of
https://github.com/Ku6epXBOCTuK/easy-png-tools.git
synced 2026-11-13 17:08:20 +00:00
docs: update to slug - id changes
This commit is contained in:
+10
-11
@@ -2,13 +2,12 @@
|
||||
|
||||
> Статус: **active**. Живой документ для сверки с каталогом.
|
||||
>
|
||||
> **Карта перечисляет `id` записи реестра (`web/src/lib/registry/`), которые
|
||||
> одновременно являются адресами страниц:** `/tools/crop-png` — это
|
||||
> `id: "crop-png"`. Отдельного поля `slug` в `ToolEntry` нет, поэтому id и адрес
|
||||
> сейчас совпадают; их разделение — решённая, но не реализованная задача
|
||||
> (`docs/backlog.md`, раздел «Мелочи всякие», и `docs/architecture.md`, раздел
|
||||
> 3). Источник правды — реестр. Этот список навигационный: сверять перед
|
||||
> использованием. Формат записи: `id — параметры через запятую`. Сравнение с
|
||||
> **Карта перечисляет `slug` страниц (`web/src/lib/registry/pages/`) — то есть
|
||||
> адреса вида `/tools/crop-png`:** это `slug: "crop-png"` у страницы, которая
|
||||
> вызывает инструмент `id: "crop"`. Внутренние имена инструментов png-интента не
|
||||
> держат, поэтому они от карты отделены; модель — `docs/architecture.md`,
|
||||
> раздел 3. Источник правды — реестр. Этот список навигационный: сверять перед
|
||||
> использованием. Формат записи: `slug — параметры через запятую`. Сравнение с
|
||||
> каталогом источника (объём, нишевые клоны серий Logo*/Icon*/Stamp*Signature*)
|
||||
> — замер в `docs/plan-seo.md`, §2; здесь он не дублируется.
|
||||
>
|
||||
@@ -20,13 +19,13 @@
|
||||
|
||||
## 1. Реализовано
|
||||
|
||||
Ids приведены к фактическим в `web/src/lib/registry/`.
|
||||
Ids приведены к фактическим в `web/src/lib/registry/pages/`.
|
||||
|
||||
**Формат строки (проверяется тестом
|
||||
`web/src/lib/registry/tools-map-doc.test.ts`):** в буллите всё **до первого
|
||||
тире** `—` — это id инструментов через `/` или `,`; всё после тире — свободное
|
||||
описание параметров и не разбирается. Второй id нельзя оставлять после тире,
|
||||
иначе он не попадёт в разбор и инструмент будет считаться неописанным.
|
||||
тире** `—` — это slug страниц через `/` или `,`; всё после тире — свободное
|
||||
описание параметров и не разбирается. Второй slug нельзя оставлять после тире,
|
||||
иначе он не попадёт в разбор и страница будет считаться неописанной.
|
||||
|
||||
### Конвертация (`convert.ts`)
|
||||
|
||||
|
||||
Reference in New Issue
Block a user