3bb4598d04
- each release now carries a full docs snapshot (reference + handbook) under docs/releases/<v>/; the docs frontend loads a version's snapshot for /docs/vX.Y.Z/* and shows the handbook/reference of that version - version dropdown navigates to /docs/<version> (docs home) instead of the release notes page; old /docs/vX.Y.Z redirect removed - generator: --snapshot writes handbook + reference; build copies versioned snapshots (last 7 versions) into /docs/versions/<v>/ - fix Gitea tag links: /admin/tool-evaluator/tags/<v> was 404, correct URL is /releases/tag/<v> - add GuideHelp button to forms/pages linking to the matching handbook guide (rating, tool add/edit, costs, compare, watchlist, analytics)
47 lines
1.8 KiB
Markdown
47 lines
1.8 KiB
Markdown
|
||
# Tool anlegen
|
||
|
||
Um ein neues Tool zum Katalog hinzuzufügen, klicke auf **Tool hinzufügen**
|
||
(`/tools/new`). Das Anlegen erfordert ein Konto — ohne Anmeldung erscheint ein
|
||
Hinweis mit Login-Button.
|
||
|
||
## Formularfelder
|
||
|
||
| Feld | Pflicht | Hinweise |
|
||
| --- | --- | --- |
|
||
| **Name** | Ja | Mind. 2 Zeichen |
|
||
| **Kategorie** | Ja | Auswahlliste; neue Kategorien lassen sich direkt anlegen |
|
||
| **Website URL** | Nein | Gültige URL (z. B. `https://...`) |
|
||
| **Icon / Logo URL** | Nein | Gültige URL; Vorschau wird live angezeigt |
|
||
| **Beschreibung** | Ja | Mind. 10 Zeichen; beschreibe, was das Tool tut |
|
||
| **Features** | Nein | Dynamische Liste mit Autovervollständigung (max. 6) |
|
||
| **Tags** | Nein | Dynamische Liste mit Autovervollständigung |
|
||
|
||
Neben jedem Feld führt das **?‑Icon** direkt zur zugehörigen Feldbeschreibung
|
||
in der [Datenmodell-Referenz](/docs/reference/schemas/toolinput).
|
||
|
||
### Kategorie
|
||
|
||
- Tippe, um nach bestehenden Kategorien zu suchen.
|
||
- Wähle **+ Erstelle „..."**, um eine neue Kategorie anzulegen.
|
||
|
||
### Features & Tags
|
||
|
||
- **Feature hinzufügen** / **Tag hinzufügen** hängt eine neue Zeile an.
|
||
- Die Eingabefelder schlagen bestehende Features/Tags vor
|
||
(Autovervollständigung, max. 6 Vorschläge).
|
||
- Mit dem **×**‑Button entfernst du einzelne Zeilen.
|
||
- Features und Tags helfen beim Filtern und Wiederfinden.
|
||
|
||
## Speichern
|
||
|
||
Klicke auf **Tool hinzufügen**. Nach erfolgreicher Anlage wirst du auf die
|
||
Detailseite des neuen Tools weitergeleitet.
|
||
|
||
## API
|
||
|
||
- [`POST /tools`](/docs/reference/endpoints/tools#createTool) — Tool anlegen
|
||
- [`GET /categories`](/docs/reference/endpoints/tools#listCategories) — Kategorien
|
||
- [`GET /features/all`](/docs/reference/endpoints/tools#listAllFeatures) — Features
|
||
- [`GET /tags/all`](/docs/reference/endpoints/tools#listAllTags) — Tags
|