sicp/vaja/plan.org

152 lines
6.4 KiB
Org Mode
Raw Normal View History

* Plan za vajo
* predlogi
- tekstualna igra stavkov
- tista s sestavljanjem povedi je pa iz une igre, mi smo dostkrat igral, neki v smislu, da mora igrat 6+ ljudi in pol vsak napise na vrh lista eno stvar in pol prepogne in list krozi -- po vrsti grejo neki takega: kdo, kdaj, kje, zakaj, s cim, kaj dela ... pol pa ven loh pridejo kr zabavni stavki ... in da je odprto na spletni strani skos naslednje vprasanje, ko se odgovori zadnja stvar (kaj dela), se izpise poved med ze dokoncane, in se zacne nova
- igra v [[https://dthompson.us/projects/chickadee.html][chickadee]]-ju
- klon she-bo? (https://www.myabandonware.com/game/she-bo-a6f)
- igra v canvasu (preko hoot) - v brskalniku
- Command line tool za prevode - prepis [[https://git.kompot.si/lio/PonsapiCli][ponsapi-cli]] v guile
- CI (continuous integration) sistem:
- https://codeberg.org/jjba23/byggsteg
- tegale bi lahko uporabili ^
- ideja: imeti spletno stran, ki jo na njej sami lahko v zivo urejas (ima vgrajen urejevalnik) in v kolikor testi passajo, se kar sproti deploya
'
* tekstualna igra stavkov p
** meta
Sem pišemo plan za program igranja igre. Poskušamo kratko in jedrnato opisati prvi prototip, ki naj čimprej deluje in je zavoljo enostavnosti karseda podoben igranju v živo. Ob pisanju se poraja veliko idej, za katere je bolje, da se potencialno uvedejo kasneje, sicer se cilj delujočega prototipa sproti prehitro oddaljuje.
** homepage
Na home page imamo kratka navodila in formo nova igra s poljem stevilo igralcev.
Submitanje forme te pelje na zgeneriran link, ki ga posljes soigralcem.
Na tem koraku se generira seja glede na število igralcev.
** seja igre
Meta Podatki
- hash, ki je url
- stevilo igralcev
Vsak igralec dobi svoj id (in session). Nato se mu po vrsti prikazujejo vprasanja in on izpolnjuje vprasanja. Novo vprasanje se ti pojavi, ko vsi odgovorijo na trenutno vprasanje (lahko imamo nek semaforcek, kdo je ze odgovoril).
Igra "prepozna" obiskovalca nekako unikatno - lahko je session in cookie (kar se uporablja za user tracking), lahko pa je nek ID v browser local storage, ki zavaruje uporabnika pred cross-site trackingom. (@TODO tole je manjša komplikacija). Unikatna prepoznava je pomembna za deterministično prelivanje odgovorov.
Ko oddaš odgovore, te pelje na link za rezlultate, kjer piše, koliko odgovorov igralcov še čakamo.
Ko so vsi oddali odgovore, se ti izpiše stavek, ki ga lahko prebereš ostalim igralcem.
** program
Izbrali smo artanis web framework: https://artanis.dev/
Namestitev:
- GNU guix: ~guix install artanis~
- Debian: ~apt install guix; guix install artanis~
*** boilerplate
Artanis ima orodje za terminal, imenovano ~art~. Z orodje mdr. pripravimo skelet novega projekta: ~art create igra-stavkov~.
Strežnik potem lahko poženemo z ukazoma:
- ~cd igra-stavkov~
- ~art work~
Strežnik se nam odpre na naslovu http://127.0.0.1:3000
[[file:./igra-stavkov-1.png]]
Stran tako deluje samo lokalno, če jo želimo deliti z drugimi na omrežju, spremenimo konfiguracijo; v datoteki ~conf/artanis.conf~ spremenimo ~host.addr = 127.0.0.1~ v lasten IP naslov (v mojem primeru ~host.addr = 10.27.3.12~)
Drugi potem stran vidijo na naslovu ~http://<ip_naslov>:3000~, v času in kraju pisanja tega dokumenta je to ~http://10.27.3.12:3000~ (deluje pa samo CTK wifi omrežju, na katerega sem trenutno povezan).
*** navodila za igro
Igro lahko igrata dva ali več igralcev. Igralci skupaj sestavljajo stavke, tako da vnaprej odgovarjajo na vprašanja:
- Kdo?
- Kdaj?
- Kje?
- zakaj?
- S čim?
- Kaj dela?
**** v živo
Vsak igralec potrebuje listek in pisalo. Igralci skupaj odgovarjajo na
vprašanja, po vsakem odgovoru pa listek prepognejo in podajo naprej. Svoj
naslednji odgovor nato napišejo pod prepognjen del in spet podajo listek naprej.
Ko odogovorijo na vsa vprašanja, še enkrat podajo listek naprej naslednjemu
igralcu in preberejo cel stavek.
**** na naši aplikaciji
Na naši aplikaciji je igra zelo podobna. Izberete število igralcev in ustvarite
novo sobo za igranje. Povezavo do sobo pošljete soigralcem in po vrsti
odgovarjate na vprašanja, dokler ne izpolnite vseh. Vsakemu igralcu se na koncu
izpiše en sestavljen stavek.
Ustvarimo nov fajl na lokaciji ~pub/index.html~:
#+begin_src html :tangle ./igra-stavkov/pub/index.html
<html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>igra stavkov</title>
</head>
<body>
<h1>igra stavkov</h1>
<h2>v živo</h2>
<p>
Vsak igralec potrebuje listek in pisalo. Igralci skupaj odgovarjajo na
vprašanja, po vsakem odgovoru pa listek prepognejo in podajo naprej. Svoj
naslednji odgovor nato napišejo pod prepognjen del in spet podajo listek naprej.
Ko odogovorijo na vsa vprašanja, še enkrat podajo listek naprej naslednjemu
igralcu in preberejo cel stavek.
</p>
<h2>prek spleta (naša varianta)</h2>
<p>
Vsak igralec potrebuje računalnik z brskalnikom in internetno povezavo. Dobavna veriga obsega rudnike redkih kovin, silicij, proizvodnjo čipov, komunikacijsko mrežo, etcetera.
</p>
<p>
Na naši aplikaciji je igra zelo podobna. Izberete število igralcev in ustvarite
novo sobo za igranje. Povezavo do sobo pošljete soigralcem in po vrsti
odgovarjate na vprašanja, dokler ne izpolnite vseh. Vsakemu igralcu se na koncu
izpiše en sestavljen stavek.
<form>
<label for="num-of-players">Izberi število igralcev</label>
<input type="number" min="1" name="num-of-players" id="num-of-players"></input>
<input type="submit" value="igraj">
</form>
</body>
</html>
#+end_src
Ker artanis privzeto ne prikazuje ~index.html~ datoteke, mu to zaukažemo z vnosom v fajlu ~ENTRY~:
#+begin_src scheme
(get "/" (lambda (rc) (redirect-to rc "index.html")))
#+end_src
Sprememba se ne zgodi "avtomatsko", ampak moramo prekiniti proces ~art work~ (~Ctrl+C~), in ga ponovno pognati (~art work~). Lahko ga pa poženemo tudi z ~art work -g~, načinu za razhroščevanje, ki ponovno naloži izvorno kodo, ko se le ta spremeni.
Domača stran se nam zdaj naloži!
[[file:igra-stavkov-2.png]]
** Nova soba
Zavoljo enostavnosti v ~conf/artanis.conf~ omogočimo podporo za sqlite3 bazo (ki je v fajlu in tako nismo odvisno od dodatne programske opreme za shranjevanje stanja):
#+begin_src conf
db.dbd = sqlite3
db.enable = true
#+end_src
In ponovno poženemo strežnik: ~art work -g~