A dokumentáció fizetős modul
Havi 19 amerikai dolláros kiegészítő, és egy új fiókhoz nem jár. Ha a fiókodban nincs meg, az Új menü dokumentáció pontja lakat ikonnal, Dokumentáció — csomagváltással felirattal jelenik meg, nem pedig hibára fut, ha rákattintasz.
1. Hozz létre egy dokumentációt
- Menj ide: Márka → Tudás. (Új neked ez a menü? Lásd: mi a márka a Yapletben.)
- Kattints a táblázat fölötti Új gombra, és válaszd az Új dokumentáció pontot.
- Azonnal létrejön alapértelmezett névvel, te pedig a szerkesztőjében találod magad. A Beállítások oldalán bármikor átnevezheted.
Egy márkában több dokumentációt is tarthatsz — bármelyik fizetős csomagon márkánként legfeljebb ötöt. Mindegyik táplálja az AI-t, és pontosan egy lehet közülük a márka nyilvános webcímén egyszerre.
2. Adj hozzá kategóriákat
A kategóriák navigációs fülekként jelennek meg a nyilvános oldal tetején. Gondolj rájuk úgy, mint a kézikönyv részeire: „Első lépések”, „API-referencia”, „Konfiguráció”.
- Nyisd meg a dokumentációdat.
- Kattints az Új kategória gombra.
- Adj neki nevet — ez lesz a fül felirata — és egy opcionális leírást.
- Ismételd, ahány kategóriára szükséged van.
Ha csak egy kategória van, a fülsáv elrejtőzik, ami egy kisebb dokumentációnál jobban is olvasható. A sorrendről és a szerkezetről lásd: hogyan szervezd a dokumentáció kategóriáit.
3. Adj hozzá oldalakat
Egy kategórián belül az oldalak fát alkotnak: az oldalaknak lehetnek gyermekoldalaik, azoknak pedig további gyermekeik, olyan mélyen, ahogy szükséged van rá.
- Nyiss meg egy kategóriát a nevére kattintva.
- A bal oldali fapanel alján kattints a Gyökér elem hozzáadása gombra.
- Add meg az oldal címét a jobb oldali panelen, a törzsszöveget pedig írd meg a markdown-szerkesztőben.
- Gyermekoldalhoz nyisd meg a szülő hárompontos menüjét, és válaszd a Gyermek hozzáadása pontot. Amelyik oldalnak már van gyermeke, annál a gyermeklista végén is megjelenik egy Gyermek hozzáadása link.
4. Tedd ki a nyilvános webcímedre
Nincs mit chat widgethez kötni. A Márka → Tudás oldalon nyisd meg a dokumentáció hárompontos menüjét, és válaszd a Megjelenítés itt: a-cimed.yaplet.help pontot. Ezután itt szolgálódik ki:
https://a-cimed.yaplet.help/d/Egy márka egyszerre egy dokumentációt szolgál ki, tehát ha kiteszel egy másodikat, az első lekerül — nem törlődik semmi, és az AI-ból sem kerül ki semmi, csak nem szolgálódik ki tovább. Maga a cím márkabeállítás, itt: Márka → Márkabeállítások → Nyilvános cím. Chat widget ehhez az egészhez nem kell.
5. Tedd közzé a kategóriákat és az oldalakat
Az, hogy valami a webcímen van, nem ugyanaz, mint hogy látszik is. Minden kategóriának és minden oldalnak saját Közzétett kapcsolója van, és egy oldal csak akkor jelenik meg, ha a kategóriája is közzé van téve. A sorrendről és a tömeges lehetőségekről lásd: Tedd láthatóvá a dokumentációdat a látogatóknak.
Hol van a logó és a nyelv
A nyilvános dokumentációd tetején lévő logót nem dokumentációnként töltöd fel. A Beállítások oldalán egy megjegyzés áll — „A logó mostantól a márkánál van” — és egy gomb a Márkabeállításokhoz, ahol az Általános fülön, a Márkaképek részben, a Márkalogó alatt egyszer állítod be, és onnantól mindenhol ez jelenik meg, ahol ez a márka publikál. Amelyik dokumentációnak saját logója van, addig azt használja, amíg a márka nem kap egyet.
A nyelv egy beépített választó a Márka → Tudás oldal Nyelv oszlopában, és rögtön mentődik, ahogy módosítod. Azt dönti el, hogyan keres az AI-d ebben a szövegben — semmit nem fordít le.