Jazyk Rea

Rea je jazyk s čistým textom pre interaktívne príbehy. Jeho určujúca vlastnosť je, že obyčajný text je už platný Rea dokument — bežný odsek prózy je úplný, vykresliteľný príbeh. Formátovanie, voľby, premenné, logika, multimédiá, kooperatívne čítanie a interakcia s reálnym svetom sú voliteľné nadstavby vrstvené na próze. Nič nie je povinné; po syntaxi siahnete, len keď ju potrebujete.

Rea existuje pre vetviace sa rozprávanie, ktoré človek napíše v textovom editore a verzuje v gite, a ktoré stroj dokáže overiť, vykresliť a izolovať v sandboxe. Ten istý súbor je čitateľný pre človeka aj spustiteľný enginom — neexistuje samostatná skompilovaná podoba.

Nasledujúce tri fázy sú všetky platné Rea. Prvý riadok je už úplný príbeh; druhý pridáva jednu premennú, tretí jednu voľbu:

Cesta sa vetvila pri starom dube.

{set story.player.torch = true}

* [Vydaj sa ľavou cestou]
* [Vydaj sa pravou cestou]

Súborové typy

• .rea — súbor príbehu: próza plus ľubovoľná voliteľná Rea syntax.
• .rext — Rea rozšírenie: iba deklarácie (funkcie, konštanty {set} na najvyššej úrovni, {use} a komentáre — žiadna próza). Pozri Kde sa pravidlá líšia v .rext súboroch.
• .reast — distribuovateľný ZIP balík: jeden alebo viac súborov .rea, voliteľné rozšírenia .rext a médiá, plus manifest.json v zabalenej štruktúre. Pozri referenciu formátu balíka .reast v dokumentácii jadra.

Čím Rea nie je

Rea nie je programovací jazyk na všeobecné použitie, nie je HTML a nie je herný engine. Jej funkcie sú izolované v sandboxe a zámerne obmedzené, jej vykresľovanie riadi platforma a nemá žiadny priepust surového značkovania. Úplný zoznam zámerných vylúčení nájdete v časti Čo Rea zámerne neobsahuje.

Ako ďaleko je ktorá funkcia?

Rea 1.0 je prvým vydaním jazyka a nie každá funkcia v tejto špecifikácii je rovnako ďaleko. Každá nesie pod vlastným nadpisom značku stavu:

• stable — vydané a zmrazené; zmeniť to môže len nová verzia MAJOR. Toto je prozaické jadro: odseky, formátovanie, nadpisy, odkazy, médiá, poznámky.
• experimental — vydané a použiteľné, ale syntax sa v rámci 1.x ešte môže upraviť. Dnes je tu väčšina jazyka.
• development — navrhnuté a práve sa stavia; zatiaľ nepoužiteľné.
• draft — špecifikované a prediskutované; implementácia sa nezačala.
• cancelled — zvážené a zámerne vylúčené.

Index funkcií uvádza každú funkciu zoskupenú podľa toho, na čo slúži, s filtrom podľa stavu. Prečítajte si ho skôr, než začnete plánovať príbeh okolo čohokoľvek nad rámec prozaického jadra.

Poradie čítania

Špecifikácia je rozdelená na päť častí, ktoré sa pri prvom čítaní odporúča prejsť v poradí:

1. Základy — štruktúra dokumentu, formátovanie textu, nadpisy, odkazy, médiá, kotvy a voľby.
2. Logika a dáta — príkazy, premenné, výrazy a riadenie toku. Pozri aj Vlastné funkcie.
3. Naratív a interakcia — dialóg, karty, hlas, vstup, kooperatívne čítanie a interakcie s reálnym svetom. Pozri aj Storylety a balíčky.
4. Utility — množné číslo, lokalizácia, ochrana obsahu a titulky. Pozri aj Spracovanie chýb.
5. Referencia — identifikátory, vstavané funkcie, rozšíriteľnosť, prístupnosť a úrovne zhody.

Hľadáte skôr rýchly prehľad syntaxe než celú špecifikáciu? Pozrite Ťahák.