From 77216180e767129c2d1bbeefec174e265146681e Mon Sep 17 00:00:00 2001 From: sijanec Date: Thu, 4 Jun 2020 16:28:29 +0200 Subject: readme fix --- README.md | 75 +++++++++++++++++++++++++++++++++++++++++++-------------------- 1 file changed, 51 insertions(+), 24 deletions(-) diff --git a/README.md b/README.md index ed69792..3f703dc 100644 --- a/README.md +++ b/README.md @@ -1,33 +1,60 @@ -# for developers (rstular) +# BežiApp -from sijanec +BežiApp je bolj tako uporabnikom kot strojem prijazen sistem za povezavo in pridobivanje informacij Gimnazije Bežigrad, ki ga +razvija ekipa gimb-dev (@rstular in @asijanec). -I was frustrated by the fact that I needed to change side navigation on 10+ individual html files if I added a page or wanted -to change a single icon. So I wrote this small script that includes html files from other html files. Syntax `<@?i -navigation@>` in a .bvr file in [pages-src](pages-src) will include [`navigation.bvr` from -`pages-src/misc/`](pages-src/misc/navigation.bvr). PATH (where to search for files to include) can be set in -[`global.bvr`](global.bvr) (separated with a space). Variables can also be set without touching the disk (faster, idrk) with -`<@?s variable_name variable value@>` and read with `<@?s variable_name@>`. To execute a command and surpress output, use -`<@#?x arg@>` where `x` is the command. +## zakaj? -So pages are now in pages-src and before deployment, `./compose_html pages-src/ pages/` has to be run to update the pages -dir. +brez BežiApp orodij je uporaba eRedovalnice za dijake in starše grozna uporabniška izkušnja. Uradna aplikacija je bila narejena +leta 2009, in teče na Microsoft ASPX .NET C# okolju. Verjamemo, da uporaba takih orodij nikakor ni dobra izbira, saj na dolgi rok +prinaša vedno več težav. BežiApp lepo izgleda, je izdelan v minimalističnem, a kompaktnem slogu, ki deluje na dlančnikih in +računalniških zaslonih in ima lepo dokumentirane APIje. Poleg tega je 100% odprtokoden. +brez BežiApp orodij je strojno upravljanje s podatki oteženo. GimB za podatke nima APIja, vse gre prek izdelanih HTML strani. -idkr, it seemed like a good idea, but feel free not to use it (write about it here so I won't override your commits). +za bežigrajske programe je znanih veliko programskih lukenj, ki ogrožajo uporabniško varnost. Najditelji napak zgimsisa in ostalih +storitev njihove razvijalce o svojih varnostnih pomislekih opozorili, vendar programerji napak nikoli niso odpravili. Ker večina +ljudi, s tem tudi jaz, nočemo uporabljati programov, ki naša računalniška orodja vzpostavljajo napadalcem, smo razvili 100% +preverljivo programje, ki med drugim te napake tudi večinoma odpravi. -the compiled binaries work on "`Linux kondenzator 5.3.0-46-generic #38~18.04.1-Ubuntu SMP Tue Mar 31 04:17:56 UTC 2020 x86_64 -x86_64 x86_64 GNU/Linux`". +## APIji -there's now a configure script (bash) that compiles all binaries (use if the prebuilt binaries don't work). +BežiApp programerji izdelujemo knjižnice za integracijo avtomatskih zahtev v bežigrajske storitve, kot so lopolis in +zgimsisext. Te knjižnice so javno dostopne. -``` -# install dependencies -sudo apt install git gcc -# run from project directory -./configure -``` -creates binaries so you can use the ./install everytime you make changes (and hook to post-commit) +* https://github.com/rstular/lopolis-api se uporablja za avtomatizirano naročanje hrane +* `gsec.js` se uporablja za avtomatizirano obdelavo podatkov GimSISExt platforme v Javascript jeziku +* https://github.com/sijanec/gimsisextclient se uporablja za avtomatizirano obdelavo podatkov GimSISExt platforme v PHP jeziku -should there be any conflicts with the developers on different platforms, .gitignore files will be created to ignore binaries -from being comitted every time. +## uporaba BežiAppa + +za uporabnike bo verjetno najlažje BežiApp uporabljati iz strežnikov, ki jih vzpostavlja ekipa gimb-dev (gimb.tk). Aplikacija je +dostopna iz trgovine Android Market (Google Play Store). + +za uporabnike iPhone telefov je proces nastavitve malce drugačen, vendar sila preprost. Navodila so na naši instagram strani, +https://www.instagram.com/p/B8bZGkugjKp/. + +### namestitev na lasten strežnik. + +pogruntaj sam! + +## gimb.tk strežniki + +dijaki GimB, ki so člani gimb-dev skupine postavljajo strežnike v dobro Gimnazije. Te strežniki so javno dostopni na domeni +gimb.tk in kdorkoli se lahko poslužuje njihovih storitev, povsem brezplačno. + +med drugim te strežniki gostujejo: + +* GimB Meet aplikacijo za videokonference (video.gimb.tk), +* spletne učilnice s šifrirano povezavo in lajševalniki za izdelavo kvizov (ucilnice.gimb.tk), +* zgimsisext s šifrirano povezavo (zgimsis.gimb.tk), +* avtentikacijski strežnik GimB osebja, dijakov in staršev (auth.gimb.tk), +* portal za prijavo napak razvijalcem BežiAppa (beziapp-report.gimb.tk), +* BežiApp (app.gimb.tk, dev.gimb.tk) +* gimsisextclient inštalacijo (gimb.tk/test.php) +* reddit bota za preverjanje pristnosti dijakov podbralnika r/bezigrad (reddit.gimb.tk) + +in še veliko več. + +strežniki delujejo povsem v skladu z zakoni in so povezani v akademsko in raziskovalno internacionalno omrežje GÉANT. Vanj jih +povezuje operater akademskega in izobraževalnega omrežja Grčije, grNET. -- cgit v1.2.3