FAQ / script update

This commit is contained in:
mrfry 2021-05-18 11:10:57 +02:00
parent 9d71b64e92
commit 98deeb1706
5 changed files with 287 additions and 235 deletions

View file

@ -64,154 +64,87 @@ function PasswordSection() {
function FAQSection() {
return (
<>
<div className={'manualBody'}>
<ul>
<li>
<b>
Hogy kell a scriptet telepíteni, milyen oldalakon működik és hogy
működik?
</b>
<Link href="/script">
<a>Ezen az oldalon van leírva</a>
</Link>{' '}
</li>
<li>
<b>
Lehet-e valahol szerkeszteni, törölni, illetve manuálisan
hozzáadni a meglévő kéréseket?
</b>
Igen,{' '}
<a
href={`${constants.siteUrl}dataeditor`}
target="_blank"
rel="noreferrer"
>
ezen az oldalon
</a>{' '}
van lehetőség erre.
</li>
<li>
<b>
A teszt ellenőrző oldal nem elérhető. Ilyenkor lehet valamit
tenni, hogy mégis el legyenek mentve a válaszok?
</b>
A{' '}
<a
href={`${constants.siteUrl}dataeditor`}
target="_blank"
rel="noreferrer"
>
dataeditor
</a>{' '}
oldal erre is , a <i>Kitöltetlen tesztek</i> részhez a script
automatikusan feltölti a kérdéseket még megoldás közben. Ehhez nincs
lementve helyes válasz, de ezt te utólag bejelölheted, és
beküldheted.
</li>
<li>
<b>
Mennyire anonymus a weboldal/script, és kiderülhet-e hogy
használom?
</b>
A weboldal teljesen anonymus, mindenki csak egy számként van
nyilvántartva (ami a user ID), random generált uuidv4 jelszavak
vannak (így nicknevek sem kellenek), és még IP cím sincs sehol
letárolva szerver oldalon.
<br />
Több infó a kockázatok résznél ezen az oldalon.
</li>
<li>
<b>
Olyan helyeken fut le a script, ahol nem kellene, vagy
ideiglenesen ki akarom kapcsolni
</b>
Tampermonkey bővítmény ikon böngészőben -{'>'} click -{'>'} a
scriptet kapcsold ki. Csak ne felejtsd el visszakapcsolni ;)
</li>
<li>
<b>
Túl nagy a kérdést és a választ megjelenítő ablak, nem tudok a
válaszra kattintani
</b>
A felugró ablakot ha minden jól megy akkor a szélénél fogva tudod
mozgatni, vagy egeret rajtatartva a görgővel tudod állítani az
áttetszőségét, vagy be tudod zárni jobb felül X-el, vagy egér
középső gombbal.
</li>
<li>
<b>Script felugró ablakon szereplő adatok és gombok értelmezése</b>
<img className={'manual_img'} src="img/script-3.png" alt="img" />
<ul>
<li>
Felső középső szöveg:
<br />
[Talált kérdés tárgya] - [Talált kérdés adatbázisának neve]
</li>
<li>
Jobb oldalt nyilak:
<br />
Ha több kérdés van egy oldalon, akkor azzal lehet váltogatni
</li>
<li>
Bal oldalt felső szám (3./1.)
<br />
Azt jelöli, hogy éppen hanyadik kérdés válasza van megjelenítve.
Itt a 3./1. azt jelenti, hogy a tesztben a 3. kérdés 1. talált
válasza.
</li>
<li>
Bal oldalt %
<br />A szerver szerint hány százalékban egyezik a talált válasz
azzal, amit tényleg keresni kell
</li>
<li>
Középen
<br />
Első sorban kérdés, másodikban válasz (ha a sor hosszú, akkor
megtörhet)
</li>
</ul>
<img className={'manual_img'} src="img/script-1.png" alt="img" />
<ul>
<li>
Alul nyilak:
<br />
Itt egy kérdésre több találat van, így közöttük neked kell
eldönteni, hogy mi a helyes válasz. Ez akkor van, ha a kérdés
szövege ugyan az, de más válasz is lehet. A nyilak segítségével
válogathatsz a válaszok között.
</li>
<li>
Bal oldalt felső szám (1./3.)
<br />
Itt az 1. azt jelenti hogy az oldalon az első kérdéshez van
megjelenítve a válasz, a 3. pedig azt, hogy a sok talált
válaszok közül a 3.
</li>
<li>
A kérdés mellett lévő [0]
<br />A teszt kérdésben itt épp egy kép van, és azt jelenti a
szögletes zárójelben lévő szám. A tesztben lévő képnél is
megjelenik ez a [0] azonosító, hogy könnyen párosítani lehessen.
<br />
Ez akkor hasznos, ha képekhez tartozik a válasz. Ekkor figyelni
kell, mert a képek nem biztos hogy sorrendben vannak a
tesztben a talált válaszhoz képest, de a []-ben lévő azonosítók
segítenek.
</li>
</ul>
</li>
</ul>
</div>
</>
<div className={'manualBody'}>
<ul>
<li>
<b>
Lehet-e valahol szerkeszteni, törölni, illetve manuálisan hozzáadni
a meglévő kérdésekhez?
</b>
Igen,{' '}
<a
href={`${constants.siteUrl}dataeditor`}
target="_blank"
rel="noreferrer"
>
ezen az oldalon
</a>{' '}
van lehetőség erre.
</li>
<li>
<b>
Mennyire anonymus a weboldal/script, és kiderülhet-e hogy használom?
</b>
A weboldal teljesen anonymus, mindenki csak egy számként van
nyilvántartva (ami a user ID), random generált uuidv4 jelszavak vannak
(így nicknevek sem kellenek), és még IP cím sincs sehol letárolva
szerver oldalon.
<br />
Több infó a{' '}
<Link href="/faq?tab=risk">
<a>kockázatok résznél</a>
</Link>
.
</li>
<li>
<b>Ki és miért csinálja ezt a weboldalt?</b>
Az egész projektet (szerver, weboldal és script) egy személy
fejlesztette (oldalon id-ja: #1). A weboldal designját #1677
készítette, illetve egy pár apróbb hozzájárulás (fejlesztésben és
hardverben) is érkezett a projekthez.
<br />
Az egész projekt egy hobby, csupán azért csinálom (#1) mert
időtöltés, és szeretem az ilyen kihívásokat.
</li>
</ul>
</div>
)
}
function RiskSection() {
return (
<>
Itt {'"én"'} alatt a szerver, weboldal és script egyedüli üzemeltetője
értendő, az egyetlen személy, aki hozzáfér akármilyen szolgáltatással
kapcsolatos adathoz, pl.: szerver statisztikák, szerver operációs
rendszere, beküldött fájlok. A weboldalon a felhasználó azonosítója:{' '}
<i>#1</i>
<ul>
<li>
<b>Beküldött fájlok kezelése</b>A beküldött fájlokban szerepelhet
személyes adat, pl.: név. Ha ilyen információval találkozok, akkor azt
ki szoktam törölni. Ezekhez a fájlokhoz és információkhoz csak én
férek hozzá, és sehova sincs kiadva. Ezek az információk nincsenek
sehol gyűjtve.
</li>
<li>
<b>
Ha esetleg {'"'}lebukik{'"'} a szerver, és tárolt személyes infók
</b>
Semmi személyes információ nincs eltárolva szerveren. Egyedüli
információ amit egyáltalán ki tudnék deríteni az amúgy is az IP címed,
de az nincs letárolva. Ha nagyon gonosz lennék, akkor a script el
tudná küldeni a neved és talán még 1-2 adatot a szervernek, de ezt nem
teszi.
<p />
Bizonyíték? A script, weboldal és szerver teljesen nyílt forráskódú,{' '}
<Link href="/contribute#gitrepo">
<a>ezek repository-ja publikus</a>
</Link>{' '}
(contribute oldal alja), és akármikor felülvizsgálható. A script a te
böngésződben fut, tampermonkey bővítmény menüjében megtekinthető
milyen kód fut pontosan.
</li>
<li>
<b>Bármikor észrevehetik hogy használod a scriptet</b>A weboldalt már
kevésbé, de úgy nem menti el a kérdéseket a script, mert nem fut.{' '}
@ -248,24 +181,6 @@ function RiskSection() {
<b>Akármelyik válasz rossz lehet</b>
Pl.: ha a script rosszul menti le, vagy rossz kérdésre ad választ
</li>
<li>
<b>
Ha esetleg {'"'}lebukik{'"'} a szerver, és személyes infók
</b>
Semmi személyes információ nincs eltárolva szerveren. Egyedüli
információ amit egyáltalán ki tudnék deríteni az amúgy is az IP címed,
de az nincs letárolva. Ha nagyon gonosz lennék, akkor a script el
tudná küldeni a neved és talán még 1-2 adatot a szervernek, de ezt nem
teszi.
<p />
Bizonyíték? A script, weboldal és szerver teljesen nyílt forráskódú,{' '}
<Link href="/contribute#gitrepo">
<a>ezek repository-ja publikus</a>
</Link>{' '}
(contribute oldal alja), és akármikor felülvizsgálható. A script a te
böngésződben fut, tampermonkey bővítmény menüjében megtekinthető
milyen kód fut pontosan.
</li>
</ul>
</>
)
@ -275,23 +190,45 @@ function WebsiteSaveSection() {
return (
<>
<p>
Ha hibát észlesz, kérlek jelents. Hogy a hibákat a saját gépemen
Ha hibát találsz, kérlek jelents. Hogy a hibákat a saját gépemen
reprodukálni tudjam, és könnyen ki bírjam javítani, sokszor jól jön, ha
egy lementett weboldalt megkapok, amin a hiba történik. Így lehet
menteni egy oldalt:
</p>
<center>
<img
style={{ maxWidth: '90%' }}
src="img/websitesave.png"
alt="img"
className={'manual_img'}
/>
<br />
<a href="/contact" rel="noreferrer">
Ide tudod feltölteni
</a>
</center>
<ul>
<li>
Lementett oldalon jobb klikk, oldal mentése
<br />
<img
src="img/faq/sitesave-1.jpg"
alt="img"
className={'manual_img'}
/>
</li>
<li>
A lementett oldal egy fájlból és mappából áll.
<br />
<img
src="img/faq/sitesave-2.jpg"
alt="img"
className={'manual_img'}
/>
</li>
<li>
A fájlt nyisd meg szövegszerkesztővel (notepad), és keress a
nevedre, majd (csak a neved, ne a sort) töröld ki, és mentsd el. Nem
szoktam megnézni a neveket, nem is tudok velük mit kezdeni, és nem is
adom ki soha. Amit beküldesz, azt csak én látom.{' '}
<Link href="/faq?tab=risk">
<a>Több infó itt</a>
</Link>{' '}
</li>
<li>
<Link href="/contact">
<a>Ide tudod feltölteni</a>
</Link>{' '}
</li>
</ul>
<p>
Mivel nincs hozzáférésem semmilyen egyetemi oldalhoz, így csak így tudom
hatékonyan tesztelni a scriptet. Ezért hatalmas segítség ha feltöltöd
@ -301,45 +238,150 @@ function WebsiteSaveSection() {
)
}
function ScriptReinstallSection() {
function ScriptSection() {
return (
<>
<p>
Jelenleg két helyről lehet telepíteni a scriptet: greasyforkról és a
weboldalról. A greasyforkos telepítési lehetőség megszűnt, így ha onnan
telepítetted, akkor nem lesznek frissítések elérhetők (amik nagyon
fontosak (de tényleg)). Ezért a következő rövid manővert kellene
végrehajtani, hogy minden zökkenőmentesen menjen:
</p>
<div className={'manualBody'}>
<ul>
<li>Böngésző bővítményeidnél kattints a tampermonkey-ra</li>
<li>Válaszd ki alulról második opciót, ami dashboard néven fut</li>
<li>
Ekkor új tabban felugranak telepített scriptjeid. Keresd meg a
Moodle/Elearning/KMOOC test help-et, és a sor végén kattints a kuka
gombra
<b>Hogy kell a scriptet telepíteni, és milyen oldalakon működik? </b>
<Link href="/script">
<a>Ezen az oldalon van leírva</a>
</Link>{' '}
</li>
<li>Ha megkérdezi mondd neki, hogy biztos törölni akarod</li>
<li>
Ezután simán kattints{' '}
<b>Hogyan működik a script?</b>
<ul>
<li>
Az egész folyamat a teszt ellenőrzés oldalon kezdődik, a script
onnan beolvassa, és szervernek beküldi a helyes válaszokat
</li>
<li>
Ezután ha újból kitöltöd a tesztet, vagy ugyanazzal a kérdéssel
találkozol másik tesztben (pl.: gyakorló teszt után zh/vizsga)
akkor ott megjeleníti a választ
</li>
<li>
Más felhasználóknak köszönhetően már valószínűleg lesznek
megoldások a tesztjeidhez.{' '}
<Link href="/allQuestions">
<a>Itt</a>
</Link>{' '}
meg tudod tekinteni, hogy vannak-e válaszok a tárgyadhoz.
</li>
<li>
Ha teszt ellenőrzés oldal nem elérhető, vagy nem egyértelműen
kitalálható a helyes válasz, akkor a script nem tud mit csinálni,
nem ment le semmit
</li>
</ul>
</li>
<li>
<b>
A teszt ellenőrző oldal nem elérhető. Ilyenkor lehet valamit tenni,
hogy mégis el legyenek mentve a válaszok?
</b>
A{' '}
<a
href="http://qmining.frylabs.net/install?man"
href={`${constants.siteUrl}dataeditor`}
target="_blank"
rel="noreferrer"
>
ide
dataeditor
</a>{' '}
a script újratelepítéséhez a weboldalról.
oldal erre is , a <i>Kitöltetlen tesztek</i> részhez a script
automatikusan feltölti a kérdéseket még megoldás közben. Ehhez nincs
lementve helyes válasz, de ezt te utólag bejelölheted, és beküldheted.
</li>
<li>
Kész! Lehet megkérdezi újra, hogy elérheti-e a szervert, de azt csak
egyszer. Szokásos módon engedélyezd, hogy le bírja kérni a helyes
válaszokat
<b>
Olyan helyeken fut le a script, ahol nem kellene, vagy ideiglenesen
ki akarom kapcsolni
</b>
Tampermonkey bővítmény ikon böngészőben -{'>'} click -{'>'} a scriptet
kapcsold ki. Csak ne felejtsd el visszakapcsolni {';)'}
</li>
<li>
<b>
Túl nagy a kérdést és a választ megjelenítő ablak, nem tudok a
válaszra kattintani
</b>
A felugró ablakot ha minden jól megy akkor a szélénél fogva tudod
mozgatni, vagy egeret rajtatartva a görgővel tudod állítani az
áttetszőségét, vagy be tudod zárni jobb felül X-el, vagy egér középső
gombbal.
</li>
<li>
<b>Script felugró ablakon szereplő adatok és gombok értelmezése</b>
<img
className={'manual_img'}
src="img/scriptimg/script-3.jpg"
alt="img"
/>
<ul>
<li>
Felső középső szöveg:
<br />
[Talált kérdés tárgya] - [Talált kérdés adatbázisának neve]
</li>
<li>
Jobb oldalt nyilak:
<br />
Ha több kérdés van egy oldalon, akkor azzal lehet váltogatni
</li>
<li>
Bal oldalt felső szám (5./1.)
<br />
Azt jelöli, hogy éppen hányadik kérdés válasza van megjelenítve.
Itt a 5./1. azt jelenti, hogy a tesztben a 5. kérdés 1. talált
válasza.
</li>
<li>
Bal oldalt %
<br />A szerver szerint hány százalékban egyezik a talált válasz
azzal, amit tényleg keresni kell
</li>
<li>
Középen
<br />
Első sorban kérdés, másodikban válasz (ha a sor hosszú, akkor
megtörhet)
</li>
</ul>
<img
className={'manual_img'}
src="img/scriptimg/script-4.jpg"
alt="img"
/>
<ul>
<li>
Alul nyilak:
<br />
Itt egy kérdésre több találat van, így közöttük neked kell
eldönteni, hogy mi a helyes válasz. Ez akkor van, ha a kérdés
szövege ugyan az, de más válasz is lehet. A nyilak segítségével
válogathatsz a válaszok között.
</li>
<li>
Bal oldalt felső szám (1./3.)
<br />
Itt az 1. azt jelenti hogy az oldalon az első kérdéshez van
megjelenítve a válasz, a 3. pedig azt, hogy a sok talált válaszok
közül a 3.
</li>
<li>
A kérdés mellett lévő [0]
<br />A teszt kérdésben itt épp egy kép van, és azt jelenti a
szögletes zárójelben lévő szám. A tesztben lévő képnél is
megjelenik ez a [0] azonosító, hogy könnyen párosítani lehessen.
<br />
Ez akkor hasznos, ha képekhez tartozik a válasz. Ekkor figyelni
kell, mert a képek nem biztos hogy sorrendben vannak a tesztben
a talált válaszhoz képest, de a []-ben lévő azonosítók segítenek.
</li>
</ul>
</li>
</ul>
Ezzel semmi adat nem vész el, régi jelszó ugyanolyan marad (csak ne
felejtsd azt el)
</>
</div>
)
}
@ -372,19 +414,19 @@ function AddSite() {
</li>
<li>
Böngészőben nyisd meg a Tampermonkey bővítményt <br />
<img className={'manual_img'} src={`img/siteadd/1.png`} />
<img className={'manual_img'} src={`img/faq/siteadd-1.png`} />
<br />
Itt kattints a Dashboard-ra.
</li>
<li>
Keresd meg a scriptet, majd kattints :
<br />
<img className={'manual_img'} src={`img/siteadd/2.png`} />
<img className={'manual_img'} src={`img/faq/siteadd-2.png`} />
</li>
<li>
A felugró szerkesztőben keresd meg a következő sorokat:
<br />
<img className={'manual_img'} src={`img/siteadd/3.png`} />
<img className={'manual_img'} src={`img/faq/siteadd-3.png`} />
</li>
<li>
Itt az egyik <i>@require ...</i> sor után egy új sorban írd be az
@ -399,7 +441,7 @@ function AddSite() {
rajta. Ezek után azon az oldalon amit beírtál meg kell jelennie a
Tampermonkey menüjében is:
<br />
<img className={'manual_img'} src={`img/siteadd/4.png`} />
<img className={'manual_img'} src={`img/faq/siteadd-4.png`} />
</li>
<li>
Ha a tesztek közben mégsem megy, akkor ellenőrizd, hogy a beírt moodle
@ -417,16 +459,19 @@ function AddSite() {
const pages = {
faq: { name: 'Vegyes általános kérdések', component: FAQSection },
script: {
name: 'Script specifikus kérdések',
component: ScriptSection,
},
pw: { name: 'Infó jelszavakról', component: PasswordSection },
risk: { name: 'Kockázatok', component: RiskSection },
risk: {
name: 'Kockázatok, személyes infók kezelése',
component: RiskSection,
},
websitedl: {
name: 'Teszt közbeni hiba jelentése',
component: WebsiteSaveSection,
},
reinstall: {
name: 'Script újratelepítése',
component: ScriptReinstallSection,
},
addsite: {
name: 'Futtatás (még) nem támogatott oldalon',
component: AddSite,