translate

Non nella tua lingua

Questa pagina non è ancora disponibile in it. Stai leggendo la versione de.

Hub Module

Das Hub-Modul liefert die Inhalte für die Self-Documentation — Wiki-Pages, FAQs, Glossare, Knowledge-Bases. Es ist der Backbone hinter ayoune.com/de/docs/.... Routing: hub-api.ayoune.app.

Hauptentitäten

KnowledgeBases

Eine KB ist ein Buch — sie bündelt zusammengehörige WikiPages.

Feld	Hinweis
`slug`	URL-Pfad-Segment, z.B. `developer-portal`
`title`	Display
`description`	1-2 Zeilen
`theme`	Farb-Schema (`indigo`, `emerald`, `amber`, ...)
`icon`	Material-Icon
`published`	bool
`order`	Sortierung in Hub-Sidebar

Beispiel-KBs (siehe kbSeeder.ts INITIAL_KBS):

Slug	Theme	Icon
cli	slate	terminal
developer-portal	indigo	code
admin-handbook	emerald	shield
self-hosting	amber	server
api-reference	teal	plug
release-notes	violet	calendar

WikiPages

Einzelne Markdown-Seiten innerhalb einer KB.

Feld	Hinweis
`kbslug`	KB-Zugehörigkeit (auch im Frontmatter erlaubt)
`slug`	unique pro KB
`parentSlug`	Hierarchie (optional)
`order`	Sort within Parent (10er-Schritten)
`title`	H1
`locale`	`de`, `en`, ...
`contentFormat`	`markdown` / `html`
`body`	Roh-Inhalt
`bodyHtml`	Gerendert (von `worker-content-modifications`)
`tags`	string[]
`published`	bool

FAQs

Q&A-Format. Enger als WikiPages — gedacht für Schnellinfos.

slug: how-do-i-reset-password
question: "Wie setze ich mein Passwort zurück?"
answer: "Auf der Login-Seite ..."
category: account

Glossaries

Glossar-Einträge, die im Wiki-Render automatisch verlinkt werden (siehe linkGlossaryTerms im Render-Worker).

Feld	Hinweis
`term`	"AY Singleton"
`definition`	Markdown
`aliases`	["AY", "ay-instance"]

Routen

GET  /knowledgebases
GET  /knowledgebases/:slug
GET  /wikipages
GET  /wikipages?kbslug=developer-portal
GET  /wikipages/:id
POST /wikipages
PATCH /wikipages/:id
POST /wikipages/:id/actions/publish
POST /wikipages/:id/actions/translate

GET  /faqs
GET  /glossaries

Suche

Hub nutzt Atlas-Search (siehe Self-Hosting → Kubernetes). Index: hub_search über wikipages + faqs + glossaries.

GET /search?q=auth+jwt&kbslug=developer-portal

Antwort enthält Highlights, Score und Cross-Refs.

Render-Pipeline

Wenn eine WikiPage gespeichert wird, läuft worker-content-modifications:

Markdown → HTML
Sanitize (XSS-Schutz)
Glossar-Linking
Mermaid → SVG
TOC-Generation
Cross-Link-Auflösung (wiki:<kb>/<slug> → URL)
Hash-Check (Idempotenz)
bodyHtml aktualisiert
Pub/Sub wikipage.rendered → consumer-app invalidiert Cache

CLI-Workflow

ay create wikipages "Mein Beitrag" \
  --set kbslug=developer-portal \
  --set slug=mein-beitrag \
  --set body="# Hi" \
  --set published=true

ay exec hub:seed --file ./tooling/cli/docs/pages/de/...   # Bulk-Import

Der Seeder liest kbslug aus dem Frontmatter — sonst zweites Pfad-Segment, sofern in der Whitelist (developer-portal | admin-handbook | self-hosting | api-reference | release-notes).

Verbindungen

CMS-Module — public-facing Pages (anders gerendert)
Self-Hosting — Atlas-Search-Setup

Continuare a lavorare con questa pagina

Istruzioni pronte per il tuo strumento di IA. Copia, incolla e inizia: l’IA recupera il contenuto da sola tramite l’indirizzo indicato nel testo.

Riassumere i passaggi per me L’essenziale, nell’ordine giusto.

Apri in ChatGPT

Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/api-reference/hub-module.md
La raccolta completa: https://ayoune.com/it/docs/api-reference.md

Riassumi il contenuto per me.

- Prima, in due frasi: di cosa si tratta?
- Poi i passaggi nell’ordine in cui devo affrontarli.
- Una riga per passaggio, in linguaggio semplice.
- Alla fine: che cosa dovrei avere pronto in anticipo.

Non tralasciare nulla che mi serva per arrivare davvero in fondo.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.

Spiegare a cosa mi serve A cosa serve e quando conviene.

Apri in ChatGPT

Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/api-reference/hub-module.md
La raccolta completa: https://ayoune.com/it/docs/api-reference.md

Spiegami a cosa mi serve.

1. Quale problema risolve? In una frase, dal mio punto di vista.
2. Tre situazioni tipiche in cui mi aiuta davvero.
3. Quando NON mi serve: così risparmio tempo.
4. Che cosa posso fare invece, se non fa al caso mio.

Attieniti a quanto dice la fonte. Dove non dice nulla, dillo apertamente invece
di tirare a indovinare.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.

Aiutarmi con la configurazione Passo dopo passo, chiedendomi man mano.

Apri in ChatGPT

Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/api-reference/hub-module.md
La raccolta completa: https://ayoune.com/it/docs/api-reference.md

Accompagnami passo dopo passo nella configurazione.

- Dimmi prima che cosa devo avere pronto (accessi, dati, tempo).
- Poi guidami UN passaggio alla volta. Aspetta il mio "avanti".
- Per ogni passaggio, indica come capisco che ha funzionato.
- Se qualcosa va storto, chiedimi il messaggio esatto invece di indovinare.

Se le istruzioni lasciano un punto aperto, dimmelo invece di inventarlo.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.

Aiutarmi con un problema Circoscrivere la causa invece di indovinare.

Apri in ChatGPT

Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/api-reference/hub-module.md
La raccolta completa: https://ayoune.com/it/docs/api-reference.md

Aiutami a circoscrivere un problema.

- Chiedimi prima che cosa osservo e che cosa mi aspettavo.
- Da lì ricava le cause più probabili coerenti con questa fonte.
- Per ogni causa dammi UNA verifica che la confermi o la escluda.
- Ordinale in modo che la verifica più economica venga per prima.

Non tirare a indovinare. Se la fonte non copre il problema, dimmi dove dovrei
cercare ancora.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.

Spiegarlo con parole semplici Senza termini tecnici, da zero.

Apri in ChatGPT

Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/api-reference/hub-module.md
La raccolta completa: https://ayoune.com/it/docs/api-reference.md

Spiega il contenuto in modo che lo capisca chi non ha conoscenze pregresse.

- Parti dallo scopo: perché esiste tutto questo?
- Spiega i termini tecnici in mezza frase alla prima occorrenza.
- Un paragone quotidiano dove regge davvero, nessuno dove zoppica.
- Alla fine: le tre cose da ricordare.

Non accorciare omettendo condizioni. Una semplificazione che nasconde un
prerequisito è un’affermazione falsa.
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.

Una lista da spuntare Da seguire mentre procedi.

Apri in ChatGPT

Leggi la seguente documentazione di tolinax UG e lavoraci.

Questa pagina: https://ayoune.com/it/docs/api-reference/hub-module.md
La raccolta completa: https://ayoune.com/it/docs/api-reference.md

Trasformalo in una **lista di controllo** da spuntare per la pratica.

- Esattamente un’azione per punto, all’imperativo.
- Ordinala in modo che nessun punto dipenda da un prerequisito successivo.
- Prerequisiti e insidie come sotto-punti rientrati.
- Chiudi con una verifica finale: come faccio a sapere che è tutto corretto?
Nota sulle fonti:
- Ogni pagina di questa documentazione è disponibile come Markdown (lo stesso indirizzo con `.md`).
- Una panoramica leggibile da macchina di tutti i contenuti pubblici è su `/llms.txt`.
- Se hai accesso al server MCP di aYOUne, puoi lavorare su dati in tempo reale
  invece che su questa istantanea. Altrimenti ignora questo punto.

Was this article helpful?

👎 No (0)