Preskočiť na obsah
Na tejto stránke

Úprava stránok

Každá stránka administrácie je napísaná v MDX: Markdown s niekoľkými značkami. Správca môže zmeniť, čo stránka hovorí a v akom poradí ukazuje svoje časti, pridať vlastné tlačidlá a dať všetkým stránkam štýly. Stránka, ktorú nikto nezmenil, vyzerá presne tak, ako ju LosOS dodáva.

Zatiaľ sa dajú meniť Prehľad a Úložisko. Ostatné obrazovky a aplikácie pribudnú.

Kto ich môže meniť​

Iba správcovia. Časť Stránky v Nastavenia → Vzhľad vidia len oni a zariadenie zmenu od nikoho iného neprijme. Každý prihlásený vidí stránky tak, ako ich správca nechal, v každom prehliadači, so zapnutým aj vypnutým JavaScriptom.

Úprava stránky​

Nastavenia → Vzhľad → Stránky uvádza každú stránku s označením Ako ju dodáva LosOS alebo Zmenená. Ceruzka vedľa nej otvorí stránku s editorom vedľa (na telefóne pod ňou). Náhľadom je samotná stránka: čo píšete, sa na nej hneď ukáže, a nič sa neuloží, kým nestlačíte Uložiť.

Stránka sa skladá z troch druhov vecí v poradí, v akom ich napíšete:

  • Text: nadpisy, odseky, zoznamy, odkazy a ostatný Markdown.
  • Bloky stránky: časti, ktoré kreslí LosOS, napríklad aplikácie alebo disk, každý na samostatnom riadku, napríklad <Apps />. Blok, ktorý vynecháte, sa nezobrazí. Editor uvádza bloky upravovanej stránky a čo ktorý kreslí.
  • Komponenty: tie, ktoré môže použiť dokument LosOS (Callout, Columns, Steps, Badge a ďalšie), a Button.

Prehľad, ako ho LosOS dodáva, sú len jeho bloky:

<BoxName />

<Applying />

<Apps />

<Glance />

Tá istá stránka s privítaním, tlačidlom a aplikáciami bez pásu s úložiskom pod nimi:

<BoxName />

## Vitajte na kancelárskom zariadení

Sú tu súbory a kód. Pred inštaláciou aplikácie sa opýtajte.

<Button href="/apps" variant="secondary">Otvoriť aplikácie</Button>

<Apps hideStorage />

Editor ukáže, čo je na stránke zle, s riadkom a stĺpcom, a Uložiť počká, kým nie je nič. Zariadenie kontroluje každé uloženie rovnako, takže stránka, ktorá sa nedá prečítať, sa nikdy neuloží. Na stránke nie je žiadny skript: import, export a {výrazy} z MDX sú odmietnuté a kreslia sa len uvedené značky.

Tlačidlá​

<Button href="…">Text</Button> nakreslí jedno z vlastných tlačidiel stránky. Adresa je cesta na tomto zariadení (/apps, /settings/look) alebo odkaz https:, http: či mailto:. variant je primary (predvolené), secondary, outline, ghost alebo link; size je sm, md (predvolené) alebo lg. Tlačidlo je odkaz: otvorí stránku a samo nič nezmení.

Štýly​

Riadok Štýly otvorí editor CSS. Po uložení ich používa každá stránka a prichádzajú po štýloch LosOS, takže vaše pravidlo vyhrá nad rovnako silným. Každá stránka sa pomenúva na koreňovom elemente, takže html[data-page="overview"] je Prehľad a html[data-page="settings.storage"] je Úložisko. Text, ktorý ste napísali, je vnútri .mdx-page-text. Kým je editor otvorený, každá stránka, ktorú navštívite, ukazuje štýly, ktoré práve píšete.

História a návrat​

Každé uloženie, návrat aj zmena štýlov je commit na vaše meno vo vlastnom repozitári Git na zariadení: /var/lib/losos/pages, oddelene od konfigurácie zariadenia. História v editore uvádza commity stránky. Späť na predvolenú vráti stránku do podoby, v akej ju LosOS dodáva, a Odstrániť štýly odstráni tie vaše. Aj to sú commity, takže história zostáva.

Keď aktualizácia LosOS zmení predvolenú podobu stránky, ktorú ste zmenili, editor to povie. Vaša stránka zostane, ako ste ju nechali; Otvoriť novú predvolenú podobu ukáže tú novú, aby ste si z nej mohli vziať, čo pribudlo.