mrfrys-node-server/views/man.ejs
YourFriendlyNeighborhoodDealer 8091c2d4e9 Sleepy update
2019-04-07 11:05:42 +02:00

399 lines
17 KiB
Text

<html>
<meta charset="UTF-8">
<body bgcolor="#212127">
<head>
<title>Moodle/Elearning/KMOOC manual</title>
<style>
body {
font: normal 17px Verdana;
color: #999999;
}
a {
color: #9999ff;
}
textarea {
font: normal 17px Verdana;
color: white;
background-color: #212127;
width: 90%;
height: 250px;
}
</style>
</head>
<center>
<h1>Moodle/Elearnig/KMOOC manual</h1>
</center>
<center>
Ez a userscript Moodle/Elearnig/KMOOC tesztek megoldása során segítséget jelenít meg.
</center>
</p>
<b>A válasz ablakban jobb felül lévő százalék jelzi, hogy mekkora eséllyel jó a megoldás. Ez
sokszor jó viszonyítás, de semmi sem biztos! Bármikor előfordulhat, hogy nem jó a
megjelenített válasz! Ezért csak saját felelősségedre használd!</b> Sok kikerülhetetlen
hibalehetőség van, amit egyszerű nem lehet scriptben lekezelni (Pl rosszul megadott kérdés
tanár részéről). Kézzel is lehet keresni a elmentett kérdések között. Ezért mindég
legyen egy letöltött verziód a kérdésekről, mert nem 100% hogy mindég elérhető a szerver!
Továbbá ha a moodle oldalán a layout megváltozik, a script nem fog működni! Ez nem annyira
gyakori, de bármikor megtörténhet! Érdemes nem kikapcsolni a tampermonkey-ban a userscript
frissítést. Ez nem windows update, itt tényleg hibajavítások jönnek ki. Hiba, észrevétel
esetén : <a target="_blank" href="https://qmining.tk">Script Feedback</a> (ezt
gyakran még aznap megnézem.
</p>
</p>
<b>Továbbá ez a userscript HTTP requestekket küldhet egy szerver felé (ha ezt engedélyezed),
ahova az összes megoldott tesztjeid kérdéseit és (helyes)válaszait feltölti! Ezzel garantálja,
hogy neked, és mindenki másnak a legfrissebb adatok állnak rendelkezésre. Ezt letilthatod, ha a
menüben a helyi fájl használatát választod, vagy a userscript kiegészítőknél nem engeded meg
ezeket a kéréseket továbbítani. Ez alapból engedélyezve van,</b>
<center>
<% include aludni.ejs %>
<h3>Tartalomjegyzék</h3>
</center>
<hr>
<ul>
<li>
<b>Használat</b> - Ez szuper fontos, elsőnek olvasd el
</li>
<li>
<b>Eddigi teszt kérdések</b> - Itt elérhető az eddigi összes ismert teszt
kérdés-válaszai
</li>
<li>
<b>Beüzemelés (online)</b> - Beüzemelés, online verzió
</li>
<li>
<b>Beüzemelés (helyi)</b> - Beüzemelés, helyi fájlos verizó
</li>
<li>
<b>Több tárgy hozzáadása</b> - Ez csak helyi fájlos verziónál kell, de akkor
fontos
</li>
<li>
<b>Beolvasott kérdések struktúrája</b> - Ha bármikor (neten, vagy helyi fájlon)
változtatni akarsz, akkor illik tudni
</li>
<li>
<b>Gyakran előforduló kérdések</b> - Ha itt nincs kérdésed, akkor <a
href="http://qmining.tk">itt alul</a> tedd fel!
</li>
<li>
<b>Adat egyszerűsítés</b> - Ha túl sok egyforma kérdésed van ;)
</li>
<li>
<b>Other stuff</b>
</li>
</ul>
<center>
<h3>Használat</h3>
</center>
<hr>
<table style="table-layout:fixed;vertical-align:top;width:100%">
<td>
</p> Ha először használod, olvasd el a lenti beüzemelés részt.
</p> Ha másodszor, és tesztet akarsz megoldani, akkor először nézd meg a menüben, hogy aktív-e a
tárgyad. Teszt közben a script a megadott tárgy már lementett kérdéseiből próbál segíteni.
</p>
</p> Teszt közben még több dolog történhet:
</p>
<ul>
<li><b>Nem jó kérdésre ad választ a script:</b> Ilyenkor az van, hogy nincs meg a kérdés a
txt-ben, vagy több hasonló kérdés/válasz van. Ilyenkor a jobbra/balra gombbal váltogathatsz
azok a kérdés/válasz combók közül, amit talált a script</li>
<li><b>Több teszt kérdés van egy oldalon:</b> Fel le gombbal váltogathatsz a kérdések között.
Ilyenkor is működik az előbb említett funkció. Az indexek, amit kiír a bal felső sarokban:
aktuális kérdés száma / aktuális találat száma.</li>
<li><b>Nem jelenik meg semmi, vagy nem működik a script:</b> Megesik az ilyesmi. Ha
a webszerver még elérhető akkor ott meg bírod nézni a kérdéseket, és ott lehet
keresgélni Ctrl + F -el Ha nincs webszerver, akkor lehet hogy jól jön ha van egy
lementett kérdés gyűjteményed.</li>
</ul>
</p> Fontos hogy kijelöld a tárgyat amit szeretnél "tanulni" mielőtt nekikezdesz. Ha egy
olyan tárgynak kezdesz neki, ami még nincs benne az adatbázisban, akkor az új tárgyként
fog bekerülni (obviously). <b>De azt neked kell utána aktívnak jelölnöd!</b> Ha nem
használsz egy tárgyat, akkor kapcsold ki, mert picit belassulhat!
</p> Egyéb funkciók:
<ul>
<li>
Ha esetleg videókat nézel, akkor spaceval lehet play/pausolni, és jobbra/balra
gombbal ugrani a videóban.
</li>
<li>
Menüben el lehet rejteni a kérdéseket a felugró ablakról, így az
kisebb helyet foglal, de így nem bírod ellenőrizni, hogy tényleg jó kérdés/választ talált-e.
</li>
<li>
Ugyanitt az üdvözlő üzenetet is el lehet rejteni. Ez frissítésnél vagy hibánál így is
úgyis megjelenik, mert azok nagyjából fontosak.
</li>
<li>
Ha bármikor nem kell a script, akkor a menü gomb alatt bekapcsolhatod a passzív
módot, ami nem olvassa be a kérdéseket. Vagy kikapcsolhatod magát a scriptet
tampermonkey-ban. Ha bármiért is el akarod tüntetni a következő oldalig az éppen
megjelenő script ablakot, akkor középső egér gombbal kattintva rajta ezt
megteheted.
</li>
</ul>
<h3>TL; DR:</h3>
Olvasd csak el. Az összes bonyodalom abból adódik, hogy a tampermonkey API-je korlátozott, és
néhány dolgot neked kell megcsinálni, megérteni. Ha az online kérdéseket használod, akkor nagy
eséllyel semmi teendőd, de azért jó ha tudod hogy működik, ha esetleg valami elromlik teszt
közben, tudd hogy lehet megcsinálni gyorsan. <b> Legyen mindég nálad egy másolat az online
kérdésekről, mert bármikor eltűnhet!</b>
</td>
<td width=20%>
<img src="img/rtfm.jpg" alt="img"/>
</td>
</table>
<center>
<h3>Eddigi teszt kérdések:</h3>
</center>
<hr>
<a target="_blank" href="http://qmining.tk/legacy"><b>Eddigi összes kérdés</b></a> Használat: Ha
régi módszerrel fájlból olvasod be a kérdéseket, akkor abba kell bemásolni az egészet. Továbbá
ez még arra jó, hogy ha valamiért bugos a script, akkor itt tudsz ctrl-f el nézegetni, vagy ha
lemented az összes kérdést, akkor még akkor is biztonságban vagy, ha netán leáll a szerver, vagy
elmegy a neted. Bár úgy nehezen moodlezel, de mind1
<table style="table-layout:fixed;width:100%">
<td style="vertical-align:top">
<center>
<h3>Beüzemelés (helyi adatokkal)</h3>
</center>
<hr>
</p>
<b>Ha netről használod a kérdéseket, akkor ezt a részt kiskippelheted. De csak ezt</b>
</p>Ezt minden frissítésnél el kell játszanod, mert az egész script (beleértve az elérési
utadat) felülíródik. Frissítés után a 3. pontot ismételd.
</p>Kérdés fájl lehet json vagy saját formátumban (amit később írok le). De vegyes nem lehet!
<ul>
<li>
<b>1. :</b>
<a target="_blank"
href="https://greasyfork.org/en/scripts/38999-moodle-elearning-kmooc-test-help">Greasyfork</a>-ról
telepítsd a scriptet. Ha ezt látod, akkor ez nagy eséllyel sikerült.
</p>
<b>2. :</b>
<ul>
<li><b>a/</b> Ha van kérdés adatbázisod. Ugorj a 3.-as pontra.
</li>
</p>
<li><b>b/</b> Ha nincs kérdés adatbázisod. Hozz létre egy üres .txt-filet, vagy
fentebb az Eddigi kérdések pontnál tölts le párat. Indításnál ha üres a file, akkor
hibát jelez, de miután feltöltöd nem kellene. Ha több tárgyat szeretnél használni,
akkor feltétlen olvasd el az ez alatti útmutatót!
</li>
</ul>
</li>
<li>
<b>3. :</b> Nyisd meg a tampermonkey-d. Böngésző jobb felesősarkánál nagy eséllyel van
tampermonkey ikon. Katt, majd dashboard. Ott fel lesz sorolva egy pár script. Válaszd ki
az Moodle helper-t.
</br> Rögtön az elején látsz csomó cuccot.// ==UserScript== meg @name meg ilyesmi.
Keresd meg a @resource taget.
</br> Most jön a .txt-d. Az elérési útját másold be, hogy nagyjából hasonló legyen:
</br>
</p> // @resource data file:///D:/OE/Elektronika/Elektro%20All%20ELearning.txt
</p> Ide másold be a sima elérési utat, majd convert! Ezután az eredményt
bemásolhatod a @resouce taghoz. Kiterjesztésről (.txt) ne feledkezz meg ;)
<input style="width:60%;" type="text" id="tex" /><button onclick="conv()"> Convert!
</button><br> Másik jó megoldás, hogy a fájlodat megnyitod böngészöben, és az url-jét
másolod be a script fejlécébe.
</br> Ez csak windowson jó, ha netán Mac-et vagy GNU/Linux-ot használsz akkor írj
feedback-et az oldalon, és leírom hogy kell.
</li>
</p>
<li>
<b>4. :</b> Kész! Mentsd el, és hf. Nagy eséllyel először hibával fogsz találkozni.
Dont worry! A Hibák részben pont ezt fogom leírni.
</p>
<b>Teszt végén teendők ha helyi fájlban vannak az adataid:</b> Ha egy teszt végére
értél, akkor megjelenik a megoldásos oldal, ahol minden kérdés fel van sorolva. Itt a
script szépen összegyűjti a kérdés/válasz combókat, aztán feldob egy ablakot, amire
kattintva ezt megjeleníti. Az ott megjelenített kérdéseket be kell másolnod a .txt-be, a
megfelelő tárgy után (+tárgynév...). Userscript nem tud fájlba írni.
</li>
</ul>
<center>
<h3>Több tárgy kérdéseinek használata helyi adatokkal: (1.2)</h3>
</center>
<hr>
</br> Röviden: Kérdések +tárgynév sorral elválasztva külön tárgynak számítanak
</p> Hosszabban: Vegyük például, hogy Elektornika, és Jazz kérdésekre szeretnéd használni a
scriptet. Ekkor a .txt-d két részre lesz fel osztva a következő módon: Első sora: "+Elektró
(moodle)". Ez a neve annak a tárgynak, amihez a sor után következő kérdések tartoznak,
mindaddíg, amíg egy másik "+" kezdetű sor nem következik. Ha ez történik, akkor meg kell adnod a
következő tárgy nevét, ez esetben: "+Jazz (kmooc). Ebből tudja a script, hogy ez egy másik
tárgy. Minden kmooc és moodle oldalon megjelenik egy Menü a jobb alsó sarokban, amire kattintva
ki bírod választani, hogy mely tárgy legyen aktív. Ha valamely tárgy aktív, akkor a script a
tárgy kérdései közül fogja keresni a választ az aktuális kérdésre. Ha egy sincs bejelölve, akkor
nem lesz találta soha.
</p>
A jobb alsó sarokban 1.2 óta található egy menü gomb. Ha rákattintasz, akkor megjelenik egy
új ablak az oldal közepefele. Ezt be tudod zárni, vagy a listázott tárgyakat tudod
aktiválni/inaktiválni. Ha egy tárgy aktív, akkor annak a kérdés-válaszai között keres a
script választ az aktuális kérdésre.
<center>
<h3>Beolvasott kérdések struktúrája</h3>
</center>
<hr>
</p> A .txt-ben "?" jelöli a kérdést, "!" a választ, ">" a kérdéshez tartozó képneveket (ez
optimális) és "+" a tárgy nevét. Ami más karakterrel kezdődik, és kérdés előtt van, az
figyelmen kívül van hagyva, <b>egyéb helyen hibát eredményezhet egy ismeretlen sor!</b> Ha új
tárgyat szeretnél hozzáadni, egyszerűen másold be az aljára a kérdéseket sorban, egy új
+[tárgynév]-el kezdődő sor után. <b>Ha online adatokat szerkesztesz, akkor ezt érdemes tudni,
különben elronthatod!</b>
</td>
<td style="vertical-align:top">
<center>
<h3>Beüzemelés (online)</h3>
</center>
<hr>
</p> 1.5-ben bekerült egy új feature, ez pedig az, hogy szervertől szedi a kérdéseket a script.
Elküldött, és letöltött adatokról lentebb tudsz olvasni. 2 opció elérhető, amit a menüben lehet
állítgatni:
<ul>
<li>
</p> Helyi fájlból: a script a forráskódban általad megadott útvonalon
található fájlból olvassa be a kérdéseket, és ott keres. A tesztek végén mindég be kell
másolnod az új kérdéseket. Erről a következő szekció mesél többet
</li>
<li>
Netről: interneten hostolt adatbázis letöltése, és használata. Azonnal feltölti az
éppen megoldott tesztek kérdés-válaszait, ezért azonnal látnod kell(ene) azokat.
</li>
</ul>
</td>
</table>
<center>
<h3>Gyakran előforduló kérdések</h3>
</center>
<hr>
<ul>
<li>
<b>1. Mindent megcsináltam, mégsem hajlandó beolvasni a fájlt</b>
</br> Ha netről szeded a kérdéseket, akkor nem online a webszerver, vagy éppen nem aktív
a tárgyad a menüben. Jobb alsó sarokban lévő 'M' gombra kattintva fel kell ugorjon egy
menü, és ott az éppen megoldani kívánt tárgy mellett ki kell hogy legyen pipálva a
tickbox.
</br> Helyi fájl használata: Ha (tényleg) rendesen bemásoltad a @resource-hoz az elérési
utat, és még mindég nem működik: A böngésződ nem éri el a file-t. Chrome/Opera:
bővítményeknél engedélyezni kell a fájlelérést. (Allow acces to file URLs
bővítményeknél) Firefoxnál csak a tampermonkey-nél kell állítgatni más böngészőt
meg nem ismerek. Ezután Tampermonkey beállítása, hogy használja a @resource-ot: Klikk az
ikonra böngésződnél, majd dashboard -> Settings tab -> "Config mode: " Advanced. Ezután
meg kell jelennie egy olyan részlegnek, hogy "Security" (ha nem frissítsd az oldalt).
Ott : "Allow scripts to access local files" -> "Externals (@require and @resource) Ha
üres a txt-d, akkor még hibát fog jelezni, de amint első kérdésekkel feltöltöd jónak
kellene lennie. Ha mégsem, akkor F12-> console -> és ott van egy pár log, ami hátha
segít.
</li>
</p>
<li>
<b>2. Egyik kérdésre sincs válasz / előző fix után sem olvassa be a fájlt</b>
</br> UTF-8-as kódolással mentsd a txt-det! Ha frissítés volt, akkor újra be kell írnod
a txt elérési útját. Ha a beírt elérési utat a böngésző címsorába bemáslva nem nyílik
meg, akkor elírtad, ha igen, akkor próbálkozz másik böngészővel
</li>
</p>
<li>
<b>3. Az első tárgy nevét NONAME-nek írja, pedig megadtam +-al a nevét</b>
</br> A szöveges fájlod első sorába írj be valamit. Vagy csak rakj egy entert. Script
minden sort figyelmen kívül hagy, ami nem a következő karakterekkel kezdődik: + ? ! >.
Néha ha olyan kedve van nem sokszor olvassa be az első sort.
</li>
</p>
<li>
<b>4. Olyan helyeken fut le a script, ahol nem kellene, vagy zavar</b>
</br> Tampermonkey bővitmény ikon -> click -> scriptet kapcsold ki. Csak ne felejtsd
visszakapcsolni ;) Meg passzív módot is bekapcsolhatod a menü gomb alatt.
</li>
</p>
<li>
<b>5. Túl nagy a kérdést és a választ megjelenítő ablak, nem tudok a válaszra kattintani</b>
</br> Zommolj ki egy kicsit, vagy kapcsold ki addig a scriptet. Továbbá középső
egérgombra kattintva rá el bírod tüntetni az ablakot, amíg újra nem töltöd az oldalt,
vagy másikra ugrasz.
</li>
</p>
<li>
<b>6. Online adatokat használok, de a script hibát jelez</b>
</br> Ennek több oka is lehet:
<ul>
<li>Nem engedélyezted az http requestek küldését a usercript menedzselő
programodnál. Ez nélkül nem működik.</li>
<li>Nem elérhető a szerver. Ezt ellenőrizheted: <a
href="http://qmining.tk/">link</a></li>
<li>Nincs kiválasztva a megoldani kívánt tárgy a menüben.</li>
</ul>
</li>
<li>
<b>7. Mi ez a ... ?</b>
</br>
<img height=40% src="img/imgq.jpg" alt="img"/>
</li>
</p>
<li>
Egyéb:<br><a target="_blank"
href="https://greasyfork.org/en/scripts/38999-moodle-elearning-kmooc-test-help/feedback">Script
Feedback</a> vagy <a target="_blank" href="http://qmining.tk/">észrevétel</a> vagy <a
target="_blank" href="http://qmining.tk/irc">IRC.</a>
</li>
</ul>
<hr> Jogosultságok:
</br>GM_openInTab: help megnyitása új lapon, GM_xmlhttpRequest: online adatbázishoz.
GM_getResourceText: a txt beolvasáshoz. Mást nem bír beolvasni, csak amit megadsz a @resouces
tagnál. GM_info: a scriptről információ, a verzióváltozás érzékeléséhez. GM_getValue/
GM_setValue: oldal bezárásakor megmaradó változók kezelése. Előző verzió tárolására, ugyanúgy
verzióváltozás érzékeléséhez, néhány beállítás, illetve hogy melyik tárgyakból keressen
kérdéseket. Ezek függvények, és a sciptben néhol meg vannak hívva, keresd meg.
</p> Elküldött adatok online módban: Minden teszt végén az összes kérdés, és rá a moodle szerint
helyesnek vélt válaszok. Fogadott adatok: az összes eddig ismert moodle kérdés
<hr>
<center>
<h1>
<a target="_blank"
href="https://greasyfork.org/en/scripts/38999-moodle-elearning-kmooc-test-help">Script
Greasyforkon</a>
|
<a target="_blank"
href="https://greasyfork.org/en/scripts/38999-moodle-elearning-kmooc-test-help/feedback">Script
Feedback</a>
|
<a target="_blank" href="http://qmining.tk/">Weboldal</a>
</h1>
</center>
<script>
function conv() {
var a = document.getElementById("tex").value;
a = a.replace(/ /g, "%20");
a = a.replace(/\\/g, "");
if (!a.includes(".txt")) {
a += ".txt";
}
document.getElementById("tex").value = "// @resource data file:///" + a;
}
</script>
<% include b.ejs %>
</html>
</body>