Hogyan működnek a kategóriák a dokumentációban
A dokumentáció minden kategóriája egy navigációs fülnek felel meg a nyilvános dokumentációs oldalon. Amikor rákattintasz egy fülre, az adott kategória oldalsora megjelenik bal oldalon. Ha csak egy kategória van, a fülsáv el van rejtve — az egykategóriás oldalak közvetlenül jelennek meg, ami tisztább olvasási élményt ad egyszerű dokumentációknál.
Minden kategórián belül az oldalak egy fastruktúrában szerveződnek — gyökéroldalak a legfelső szinten, alattuk gyermek-oldalak beágyazva. A fa mélységének nincs szigorú korlátja.
Kategória létrehozása
- Nyisd meg a dokumentációdat (Dashboard → Dokumentáció → [a te dokumentációd]).
- Kattints az Új kategória gombra.
- Add meg a nevet (a nyilvános oldalon ez lesz a fül felirata) és egy opcionális leírást.
- Mentsd el.
Kategóriák sorba rendezése
A kategóriák súly szerint rendezők — az alacsonyabb súlyú számok kerülnek előre (legbaloldalibb fül). Az átrendezéshez:
- Nyisd meg a kategória melletti hárompontos menüt, és válaszd a Mozgatás felfelé vagy Mozgatás lefelé lehetőséget. A kategóriatáblázatban látható sorrend mező csak olvasható.
Beágyazott oldalak egy kategórián belül
A kategórián belüli oldalak hierarchiát alkotnak. Néhány fontos tudnivaló:
- Gyökéroldalak a fa legfelső szintű elemei. Lehetnek gyermek-oldalaik, amelyeknek szintén lehetnek saját gyermekeik.
- Üres szülő-oldalak engedélyezve vannak — a tartalom nélküli oldal csak mappaszerű tárolóként működik. Gyermekei mégis navigálhatók és olvashatók.
- Gyermek-oldal hozzáadásához nyisd meg a szülő-oldal hárompontos menüjét, és válaszd a Gyermek hozzáadása lehetőséget. Olyan oldalaknál, amelyeknek már vannak gyermekei, a gyermeklista végén megjelenik egy + Gyermek hozzáadása link is.
- Oldalak átrendezéséhez használd a Mozgatás felfelé / Mozgatás lefelé opciókat az oldal hárompontos menüjében — ez az azonos szülő alatti testvér-oldalakat rendezi át.
Kategória törlése
Nyisd meg a hárompontos menüt egy kategória neve mellett, és válaszd a Törlés lehetőséget.
Egy kategória törlése véglegesen eltávolítja az összes benne lévő oldalt. Ez nem vonható vissza. Ha csak átmenetileg szeretnéd offline állapotba helyezni a tartalom elvesztése nélkül, először vond vissza a kategória közzétételét.
A kategóriák és oldalak közzétételéről lásd: Dokumentáció közzététele nyilvános URL-re.