Keresés és weboldal
Tutorial: követhető lecke, köztes eredmény és helyreállítás
Hogyan taníts meg egy elvégezhető feladatot lépésről lépésre? Teljes helyi HTML-lecke, megismételhető köztes állapotokkal, szándékos hibával és visszatéréssel.
Művelet, elvárt jel, visszatérés
Gyakorlati lecke
Mit látsz a lépés után? Honnan folytatod, ha eltér?
RövidenA tutorial gyakorlati tanulási lecke, amely konkrét kezdőállapotból, vezetett lépésekkel és ellenőrizhető köztes eredményekkel segít új készséget elsajátítani. A kész feladat mellett a tanuló tapasztalata, a megismételhetőség és a hibából visszatérés is része a tervezésének.
Más elnevezések: oktató tutorial, tutorial lecke, gyakorlati oktatóanyag.
A tutorial vezetett gyakorlati lecke. A használó csinál valamit, és közben ellenőrizhető tapasztalatot szerez. Nem pusztán elolvassa egy funkció leírását, és nem feltétlenül saját, már ismert munkafeladatára keres gyors megoldást. A szerző kijelöli a kezdőállapotot, megmutatja a következő műveletet, elmondja, milyen eredmény várható, és segít, ha az eltér. A feladat megoldása a tanulás eszköze, nem önmagában a teljes tanulási eredmény bizonyítéka.
A cikk saját leckéjében négyrészes helyi HTML-oldalhoz készítünk tartalomjegyzéket, majd szándékosan elrontunk és helyreállítunk egy horgonyt. A teljes fájl másolható, nem kell hozzá fiók, szerver vagy külső könyvtár. A kódot a szerkesztéskor elkülönített Chromium-környezetben visszafuttattuk. Ez szoftveres ellenőrzés: nem állítunk megfigyelt emberi tanulást, fizikai eszközös vizsgálatot vagy minden böngészőre kiterjedő megfelelőséget.
A webshop használati tudásának cikke magyarázhat, a tutorial pedig egy meghatározott feladat végigvitelét tanítja. A wiki külön őrzi a közösen szerkesztett változatot és javítási történetet.
Tutorial, feladatútmutató, referencia és magyarázat
A Diátaxis bevezetője négy dokumentációs szándékot különít el. A tutorial tanulási lecke, a how-to már meglévő készséggel végzett munkát támogat, a referencia a szükséges tényeket írja le, a magyarázat összefüggést és hátteret ad. Ezek egymáshoz kapcsolhatók, de nem szükséges mindet ugyanabba a lépéssorba zsúfolni. A kezdőnek éppen végrehajtható művelet és közeli eredmény kellhet, nem minden választható paraméter.
A saját lecke nem teljes HTML-kézikönyv. A négy cím, a hivatkozás és a célpont kapcsolatát gyakoroltatja. A belső linkelés tágabb tartalmi szerepét külön cikk magyarázza. Itt az olvasó egyetlen kis működést állít össze. Ha már kész tartalomjegyzékének egyik hibáját akarja azonnal javítani, a helyreállítási rész munkafeladatként is hasznos lehet, de a teljes lecke továbbra is vezetett gyakorlási helyzet.
A lecke végére elkészülő eredmény
A cél egy helyben megnyitható oldal, amelynek elején négy felismerhető hivatkozás szerepel. Mindegyik a megfelelő fejezethez vezet. Az oldalon nincs külső betöltés, mérés vagy elküldendő adat. A szövegek egyszerű, kitalált szerkesztési munkalépéseket neveznek meg. Az eredmény nem publikált webhely, és a fájl létrehozása nem bizonyít keresőbeli felfedezést vagy üzleti teljesítményt. A lecke kimenete a kis működés megértéséhez megfigyelhető alapot ad.
Négy ismert címhez négy pontos célkapcsolat készül
KezdetOlvasás, Rendezés, Ellenőrzés, Átadás már látszik; célazonosító és navigáció még nincs.4 cím, 0 linkKöztes állapotAz Olvasás link #olvasas értéke egyetlen olvasas célhoz kapcsolódik. A további három még nem kész.1 kapcsolatVégső állapotA négy felirat a saját egyező céljához vezet. A megadott fájl a szoftveres próbában működött; tanulói megfigyelés nincs.4 kapcsolat

A munka előtt nézd végig a készletet: egy főcím, négy másodszintű cím, négy tartalomjegyzék-link. A fejezetcélok azonosítói rendre az olvasás, rendezés, ellenőrzés és átadás műveletét nevezik meg ékezet nélküli technikai formában. A látható szöveg magyar marad. A lecke során azonosítót nem találunk ki útközben: a teljes megfeleltetést előre megadjuk, ezért az eltérés később pontosan felismerhető.
| Jel | Látható fejezetcím | A cél teljes azonosítója | A hozzá vezető hivatkozási érték |
|---|---|---|---|
| L01 | Olvasás | olvasas | #olvasas |
| L02 | Rendezés | rendezes | #rendezes |
| L03 | Ellenőrzés | ellenorzes | #ellenorzes |
| L04 | Átadás | atadas | #atadas |
Előfeltételek és biztonságos kezdőállapot
Szükséged lesz egyszerű szövegszerkesztőre, amely valóban szöveges fájlt ment, és egy HTML-t megjelenítő böngészőre. A fájlnevet a mentéskor pontosan add meg: a minta neve tartalomjegyzek.html. Ne meglévő üzleti oldal forrását írd át. Új, üres gyakorlófájllal dolgozz egy általad választott helyi mappában. A saját gépeden végzett mentés nem küld semmit külső szolgáltatóhoz; a példa nem kér valódi fiókot vagy személyes adatot.
Ha a szerkesztő automatikusan szöveges kiterjesztést ad a névhez, ellenőrizd a tényleges fájlnevet. A tartalomjegyzek.html.txt nem ugyanaz a név, és a megnyitás más eredményt adhat. A formázott dokumentumszerkesztő sem feltétlenül egyszerű HTML-forrást ment. Ilyen eltérésnél az előfeltételt tisztázd, ne folytasd vakon a következő lépést. A lecke sikeréhez a kezdőállapotnak ugyanazt kell jelentenie a szerzőnek és a tanulónak.
Első lépés: teljes kiinduló oldal megnyitása
Másold a következő teljes kezdőállapotot az új gyakorlófájlba, majd mentsd. A böngészőben nyisd meg a fájlt. Először a Műhelyjegyzet főcímet és a négy fejezetet kell látnod, tartalomjegyzék nélkül. Ez az első megfigyelhető eredmény. A címek itt még nem rendelkeznek külön célazonosítóval. Nem kell kitalálnod a tartalom szövegét, mert az alábbi minta teljes; a feladat most a szerkezeti kapcsolat megfigyelése.
<!doctype html>
<html lang="hu">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Műhelyjegyzet</title>
</head>
<body>
<h1>Műhelyjegyzet</h1>
<main>
<h2>Olvasás</h2>
<p>Olvasd végig a kapott jegyzetet, és nevezd meg a kérdését.</p>
<h2>Rendezés</h2>
<p>A megnevezett kérdéshez tartozó részeket tartsd együtt.</p>
<h2>Ellenőrzés</h2>
<p>Vesd össze a mondatot a megadott forrással.</p>
<h2>Átadás</h2>
<p>Rögzítsd, melyik változatot adod tovább és mi maradt nyitva.</p>
</main>
</body>
</html>
Ha a böngésző szövegként mutatja a HTML-elemek jelölését, előbb a fájlnév és a megnyitási mód ellenőrzése következik. Ha az ékezetek hibásak, nézd meg, hogy a szerkesztő UTF-8 kódolással mentett-e, és a teljes fejléc megmaradt-e. Ebben az állapotban még nem a hivatkozás hibáját keresed. A köztes eredmény pontos megnevezése segít, hogy a javítást a megfelelő rétegen kezdd.
Második lépés: célpont és hivatkozás összekötése
Az első fejezetcímhez rendeld hozzá az olvasas azonosítót az alább látható végső fájl szerint. A főcím után kerül a navigáció, benne az első hivatkozás az Olvasás felirattal. A hivatkozási érték elején álló kettőskereszt az oldalon belüli célra utal. A cél és az érték fennmaradó része egyezik. Az MDN dokumentációja ezt a hivatkozás és célazonosító kapcsolatával mutatja be.
Ments, töltsd újra a böngészőben megnyitott gyakorlófájlt, majd aktiváld az Olvasás linket. A cím részéhez kell érkezned, a címsorban pedig az olvasas töredék jelenhet meg. Ha az egész rövid oldal egy képernyőre fér, a görgetés kevésbé látványos lehet. Ilyenkor a címtöredék és a helyes cél megléte segít az ellenőrzésben. A kis elmozdulás önmagában nem bizonyít hibát.
Harmadik lépés: a teljes négyrészes tartalomjegyzék
A többi három címhez ugyanígy add meg a saját azonosítóját. A négy navigációs elem az előre rögzített megfeleltetést követi. Az ismétlés tudatos része a leckének: ugyanaz a kapcsolat négy konkrét példán megfigyelhető. A feliratot ne azonos „ide” szóra cseréld, mert abból a cél kevésbé ismerhető fel. A működéshez itt nem használunk JavaScriptet, és nincs külön könyvtár, amelyet le kellene töltened.
A teljes végső fájl az alábbi. Ha a részletenkénti szerkesztés után bizonytalan vagy a záró elemekben vagy az elhelyezésben, ezt a teljes változatot hasonlítsd össze a sajátoddal. Az útmutató nem vár el nem közölt köztes kódot. A teljes fájl egyezése azonban csak a másolás ellenőrzésének egyik módja; a működést utána a négy konkrét hivatkozással is végigpróbáljuk.
<!doctype html>
<html lang="hu">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>Műhelyjegyzet</title>
<style>
body { font-family: sans-serif; line-height: 1.6; max-width: 46rem; margin: auto; padding: 1rem; }
a { color: #1a1f26; text-decoration: underline; }
a:focus-visible { outline: 3px solid #1a1f26; outline-offset: 3px; }
nav li { margin-block: .65rem; }
main > h2 { margin-top: 4rem; }
</style>
</head>
<body>
<h1>Műhelyjegyzet</h1>
<nav aria-label="A jegyzet fejezetei">
<ol>
<li><a href="#olvasas">Olvasás</a></li>
<li><a href="#rendezes">Rendezés</a></li>
<li><a href="#ellenorzes">Ellenőrzés</a></li>
<li><a href="#atadas">Átadás</a></li>
</ol>
</nav>
<main>
<h2 id="olvasas">Olvasás</h2>
<p>Olvasd végig a kapott jegyzetet, és nevezd meg a kérdését.</p>
<h2 id="rendezes">Rendezés</h2>
<p>A megnevezett kérdéshez tartozó részeket tartsd együtt.</p>
<h2 id="ellenorzes">Ellenőrzés</h2>
<p>Vesd össze a mondatot a megadott forrással.</p>
<h2 id="atadas">Átadás</h2>
<p>Rögzítsd, melyik változatot adod tovább és mi maradt nyitva.</p>
</main>
</body>
</html>
A stílusrész kizárólag a lecke önálló gyakorlófájljához tartozik. Nem a vállalkozás teljes arculati rendszere, és nem módosít más weboldalt. A sorok egyszerűen olvashatóvá teszik a linkeket és a fókuszt. A cikkben látható kód saját helyi mintája különbözik az itt olvasott lexikon felületétől: a következő ellenőrzés a gyakorlófájlt, nem a lexikon minden hivatkozását vizsgálja.
Négy teljes célpróba az elkészült fájlon
A négy linket azonos körülmények között, frissen megnyitott oldalon vizsgáld. Aktiválás után ellenőrizd a célcím szövegét és az azonosítóját. A link felirata nem feltétlenül azonos technikai alakú az azonosítóval: az ékezetes Olvasás ugyanahhoz az ékezet nélküli olvasas célhoz vezethet. A pontos kapcsolatot a hivatkozási érték és a célazonosító egyezése adja, nem a látható felirat betűinek automatikus átalakítása.
| Próba | Bemenet | Elvárt cél | Visszafuttatott mintakimenet | Állapot |
|---|---|---|---|---|
| T01 | Olvasás link | olvasas; Olvasás cím | A megadott cél és cím megtalálható, aktiválás a megfelelő töredékre vezet | Megfelelő |
| T02 | Rendezés link | rendezes; Rendezés cím | A megadott cél és cím megtalálható, aktiválás a megfelelő töredékre vezet | Megfelelő |
| T03 | Ellenőrzés link | ellenorzes; Ellenőrzés cím | A megadott cél és cím megtalálható, aktiválás a megfelelő töredékre vezet | Megfelelő |
| T04 | Átadás link | atadas; Átadás cím | A megadott cél és cím megtalálható, aktiválás a megfelelő töredékre vezet | Megfelelő |
A négy egyezés a konkrét fájlra és az ellenőrzött szoftveres környezetre szól. Nem ad általános minősítést minden későbbi útmutatóról. A leckében a kimenet azért teljes, mert mind a négy cél meg van nevezve és vizsgálva, nem csupán az első működésből következtetünk a többire. Ha egy új fejezetet később hozzáadsz, annak saját hivatkozási és célpróbája lesz szükséges.
Szándékos hiba és teljes helyreállítás
A végleges fájl másolatában kizárólag az Ellenőrzés link értékét változtasd a hibás #ellenorzes-hibas alakra. A cím azonosítója maradjon ellenorzes. Ments és töltsd újra a saját fájlodat, majd aktiváld ezt a linket. A böngésző címében a hibás töredék megjelenhet attól függetlenül, hogy hozzá tartozó cél nem létezik. Ezért a címsor változása önmagában nem igazolja a megfelelő megérkezést.
A változó címtöredék nem bizonyít létező célpontot
- H01 / Eltérő érték
A link #ellenorzes-hibas, a cím id-je ellenorzes. A hibás értékhez nulla cél tartozik, bár a címtöredék változhat.
- H02 / Pontos visszaállítás
A link újra #ellenorzes, a cél változatlan. Egyetlen megfelelő cím és helyes aktiválás szükséges.
- H03 / Teljes készlet visszaolvasása
A javítás után T01–T04 ismét ellenőrzendő, nem csak a megváltoztatott betűsor.

A helyreállításhoz a hivatkozási értéket írd vissza #ellenorzes alakra. Ne a fejezetcím szövegét találomra módosítsd, és ne adj egy második, hibás azonosítót az oldalhoz a hiba elrejtésére. A kijelölt működés az eredeti négyes megfeleltetés. Mentés és újratöltés után ugyanazt a T03 próbát ismételd meg, amely a végső fájlnál szerepelt. A javítás sikere a visszaállított kapcsolatból, nem a szerkesztőben látható betűcseréből következik.
| Helyzet | Teljes bemenet | Elvárt jel | Kapott saját visszafuttatás | Következő művelet |
|---|---|---|---|---|
| H01 | href #ellenorzes-hibas; célazonosító ellenorzes | A hivatkozáshoz nincs cél | Nulla megfelelő cél; a töredék ettől még változik | Hivatkozási érték javítása |
| H02 | href #ellenorzes; célazonosító ellenorzes | Egyetlen megfelelő cél | Egy megfelelő cím, helyes töredék és működő kapcsolat | T03 ismétlése |
| H03 | Helyreállított teljes négyrészes fájl | Minden eredeti kapcsolat helyes | T01–T04 teljes készlete ismét egyezik | Javított változat megőrzése |
A hiba mesterségesen létrehozott oktatási eset, nem valós webhely incidense. A teljes fájlt bármikor az előző kódblokkra visszacserélheted. Ez a lecke saját visszatérési pontja. Nem kell ismeretlen csomagot telepítened vagy böngészőbeállítást átírnod azért, hogy az eredeti állapot helyreálljon. A javítás után az újrapróbálás ugyanazokat a megfigyelési szempontokat használja, mint az első ellenőrzés.
Billentyűzet, keskeny nézet és JavaScript nélküli működés
A gyakorlófájlt a böngészőben egér nélkül is vizsgáld: a Tab billentyűvel lépj a négy linkre, az Enterrel pedig aktiváld őket. A fókusznak felismerhetően a kiválasztott linken kell lennie az aktiválás előtt. A cikk nem ígéri, hogy minden böngésző ugyanúgy jelöli a célcímet aktiválás után. A saját szoftveres próba azt ellenőrzi, hogy a négy navigációs elem sorban elérhető és aktiválható.
| Kör | Megadott bemenet | Elvárt eredmény | Saját szoftveres mintaeredmény | Határ |
|---|---|---|---|---|
| B01 | Friss fájlból induló külön próbák; rendre 1, 2, 3, 4 Tab és minden esetben Enter | Mind a négy navigációs link elérhető | A négy felirat megfelelő sorrendben fókuszálható és aktiválható | Nem emberi segédtechnológiai kutatás |
| B02 | 390 CSS-pixel széles nézet | A négy cím és a navigáció olvasható, nincs oldalszintű vízszintes túlfutás | A visszafuttatott mintában megfelel | Nem fizikai telefonos vizsgálat |
| B03 | JavaScript letiltva | A négy célkapcsolat működik | Mind a négy egyezés és aktiválás megmarad | Nincs külső szkript a mintában |
A keskeny nézet vizsgálata nem általános mobilbarát minősítés. A teljes saját weboldal más táblázatot, képet vagy kezelőelemet is tartalmazhat. A lecke csak a közölt gyakorlófájl adott tartalmát vizsgálja. Ugyanígy a JavaScript nélküli siker a natív hivatkozások konkrét használatát igazolja. A megadott próbakörtől eltérő változtatás új ellenőrzést igényel.
Mit érdemes észrevenni a gyakorlat közben?
Az első saját megfigyelés a felirat és a technikai cél különbsége. A cím magyar helyesírása megmarad, az azonosító pedig rövid, következetes kapcsolati jel. A második a link és a cél kölcsönös egyezése: önmagában a kattintható szöveg nem elegendő. A harmadik a mentés és újratöltés szerepe. A szerkesztőben javított sor nem változtatja meg a böngészőben már betöltött régi állapotot, amíg az új fájlt nem olvasod be.
Ezeket a felismeréseket a lecke megfigyelési pontokkal támogatja, de nem állítja, hogy mindenki biztosan elsajátította őket. Egy valódi tanulói próba során az derülhetne ki, melyik utasításnál kell segítség. A szoftveres visszafuttatás más bizonyíték: a közölt fájl tényleges működését ellenőrzi. Mindkettő hasznos lehet, de egyik nevét sem szabad a másik eredményére használni.
A lecke fenntartása és átadása
A Diátaxis tutorialokra vonatkozó útmutatója hangsúlyozza a konkrét műveletet, a korai eredményt, az ismétlést és az elvárt kimenet megbízhatóságát. A saját szerkesztési gyakorlatban ebből az következik, hogy a kezdő fájlt, a teljes végső fájlt és a javítási próbát együtt kell gondozni. Ha egy azonosító változik, nem maradhat régi link a következő bekezdésben vagy a képi kivonatban.
Átadáskor nevezd meg a ténylegesen visszafuttatott környezetet, a kapott eredményt és a ki nem próbált helyzetet. A jelen lecke helyi Chromium-próbája nem jelenti az oldal valódi tárhelyre telepítését. Nem történt emberi oktatási vizsgálat sem. A következő szerző a teljes kód és a konkrét próbalap alapján tud újraindulni, ahelyett hogy egy „működik” feliratból próbálná kitalálni a korábbi feltételeket.
A tanulási cél nem azonos az elkészült fájllal
A saját fájl akkor is létrejöhet, ha valaki csak bemásolja a végső kódot. A lecke ennél többet szeretne előkészíteni: a használó észrevegye a hivatkozás és a cél közti kapcsolatot, és felismerje, melyik oldalon érdemes hibát keresni. A puszta másolásnak is lehet szerepe az első siker elérésében, de a működő fájlból nem következik automatikusan e kapcsolat megértése. Ezt külön tanulói megfigyelés mutathatná meg.
Ezért választunk egyszerű és áttekinthető tartalmat. Nem kérünk valódi termékleírást, új arculatot vagy szerverbeállítást ugyanabban a leckében. Ha ezek mind egyszerre változnának, nehezebb lenne megállapítani, miért nem működött a hivatkozás. A gyakorló a négy ismert címet látja, és egyetlen kapcsolati mechanizmust figyel meg. Később ezt más oldalon is kipróbálhatja, de az új környezetben már más előfeltételek is megjelenhetnek.
A kész fájlt bemutató ellenőrzés és a tanulás vizsgálata ezért más kérdést tesz fel. Az első azt kérdezi, létezik-e a négy megfelelő cél, és működik-e az aktiválás. A második azt, hogy a tanuló önállóan felismeri-e egy új hivatkozás felépítését vagy a hibás érték javításának helyét. Az utóbbit nem helyettesíti a szerző gépén lefutott próba. A nyilvános eredményközlésben ezt a határt külön megőrizzük.
A köztes állapotot is meg kell tudni nevezni
Az első összekötött hivatkozás után még nem várunk négy működő navigációs elemet. A gyakorló ekkor egy linket és egy hozzá tartozó célazonosítót hozott létre. A másik három fejezet szövege már látható, de célkapcsolatot még nem kapott. Ez szabályos köztes állapot, nem félrevezető sikerkijelentés. A következő lépés ebből indul, és ugyanazt a mintát ismétli meg a többi fejezeten.
A szerzőnek hasznos külön összeírnia, mi változott az előző mentéshez képest. A kezdőállapotban nincs navigáció; az első kapcsolatnál egy link létezik; a végső állapotban négy saját kapcsolat van. Az összevetés megmutatja, mi az a legkisebb működés, amely már látható eredményt ad. Ha az útmutató csak a teljes kész fájlt mutatná, a kezdő kevésbé látná, melyik művelet milyen következménnyel járt.
A lépésenkénti magyarázatot ugyanakkor nem kell minden HTML-elem történetével megszakítani. A tanuló most kapcsolatot készít, nem teljes szabványt tanulmányoz. A pontos háttérhez a forrás külön elérhető. Ez a szerkesztési döntés nem a részletek jelentőségét tagadja, hanem a leckén belüli helyüket tisztázza. A referencia akkor segít igazán, amikor a használó már tudja, melyik konkrét kérdésére keresi benne a választ.
Három elkülönített hibaváltozat teljes bemenettel
A szándékosan hibás cél mellett más eltérés is lehetséges. A következő három vizsgálat egymástól függetlenül az eredeti teljes végső fájlból indul. Nem kell őket egymásra halmozni. A saját szerkesztői ellenőrzésben mindhárom változatot külön, memóriában állítottuk elő és vizsgáltuk meg. A példák nem véletlenszerű hibakeresést tanítanak: minden bemenet egy konkrét elvárástól tér el, ezért a kapott jel értelmezhető.
A nem létező cél, a nem egyedi cél és a félrevezető felirat eltér
Mindhárom változat az eredeti teljes végső fájlból indul · Nincs egymásra halmozás
0 cél A hibás érték találata
2 cél Az ellenorzes találata
Eltérő jelentés A működő link is lehet pontatlan

| Változat | Pontos saját módosítás | Elvárt ellenőrzési jel | Kapott elkülönített kimenet | Helyreállítás |
|---|---|---|---|---|
| F01 | Csak az Ellenőrzés link értéke #ellenorzes-hibas | A linkhez nincs megfelelő cím | Nulla ilyen cél található | Érték vissza #ellenorzes alakra |
| F02 | Csak az Átadás cím azonosítója is ellenorzes lesz | Az ellenorzes cél nem egyedi; az atadas hiányzik | Két ellenorzes cím és nulla atadas cím | Átadás célazonosítója vissza atadas alakra |
| F03 | Csak a Rendezés link felirata Olvasás lesz; értéke #rendezes marad | A felirat és a megérkezési cím jelentése eltér | Olvasás felirat mellett Rendezés cél marad | Látható felirat vissza Rendezés alakra |
Az F01 a nem létező kapcsolatot, az F02 a célok készletének sérülését, az F03 a jelentésbeli eltérést mutatja. A harmadik változatban a böngésző képes a megadott célhoz navigálni, ezért a puszta kattinthatóság próbája nem jelezné a hibát. Az elfogadási követelménynek a cél tartalmát is meg kell neveznie. A felirat nem díszítő elem: abból választja ki a használó, hová szeretne jutni.
Megállás, mentés és újrakezdés a saját leckében
Ha a gyakorlás közben több, nem követett változtatás történt, nem szükséges találgatással minden betűt külön megjavítani. A teljes végső minta visszamásolható az elkülönített gyakorlófájlba. Előtte a saját próbaváltozatot külön néven megőrizheted, ha később szeretnéd összevetni. A visszatérési pont itt azért biztonságos, mert nem éles üzleti adaton dolgozunk, és a teljes bemenet közölve van. A lecke nem kér törlést vagy mások munkájának felülírását.
Újrakezdés után ismét a négy célpontot ellenőrizd. Nem az a lényeg, hogy korábban melyik sor lett egyszer jó, hanem hogy most melyik fájl van ténylegesen megnyitva. A szerkesztő és a böngésző ugyanahhoz a gyakorlófájlhoz tartozzon. Több hasonló névvel elmentett példánynál különösen könnyű a régit újratölteni, miközben egy másikban végzed a javítást. Ilyenkor a pontos útvonal és a fájlnév tisztázása a következő lépés.
Ez a visszatérési rend a szerzőnek is hasznos. Ha később javítja a leckét, a teljes kezdő és végső állapotból újraindíthatja a próbát. Nem kell egy régi böngészőfül részben módosított tartalmára hagyatkoznia. A megbízhatóság így a közölt bemenetből reprodukálható, nem kizárólag a szerző emlékezetéből. A szoftveres futás ezután is csak a ténylegesen vizsgált körre szól.
Saját lecke készítése egy másik témában
A próbát a ténylegesen közölt változatból futtasd, ne egy külön, jól működő saját példányból. Ha javításkor más lesz egy fájlnév vagy azonosító, a teljes leckében ellenőrizd az előfordulásait. Az egyszer sikeres végrehajtás után is maradhat olyan kör, amelyet nem láttál. Ezeket név szerint jelöld, például más böngésző, más operációs rendszer vagy tényleges kezdő használó. A határ pontos közlése használhatóbb, mint az általános „mindenkinél biztosan működik” ígéret.
A tanulói próba tervezésekor olyan megfigyelést keress, amelyből valódi szerkesztési feladat következik. Hol kellett külön segítség, melyik eredményt nem ismerte fel a használó, és melyik utasítás engedett több értelmezést? Ezek alapján módosítható a lépés és a visszajelzés. A tutorial értékét nem kizárólag az oktatóanyag hossza vagy a videó megtekintési száma adja, hanem az a vezetett gyakorlási út, amelyet a tanuló ténylegesen követni tud.
A lecke érvényességi körét pontosan add át
A saját ellenőrzés a kézirat két teljes HTML-kódblokkjából indult. A böngészős próba a kezdőoldalt, az elkészült négyes navigációt, a hibás célértéket és a helyreállítást vizsgálta. Külön körben futott az első, egyhivatkozásos köztes állapot és a három elkülönített hibaváltozat. A közölt fájlokban nincs külső kép vagy szkript, ezért a lecke működéséhez nem kellett webes szolgáltatás. A próba nem feltételezett olyan további projektfájlt, amelyet az olvasó nem kap meg.
A fókusz ellenőrzésekor külön nevezd meg, melyik állapotot figyeled. A linknek az aktiválás előtt felismerhető fókuszjelre van szüksége. Az Enter után már a célhoz történő navigációt vizsgálod. Ha ekkor a forráslinken keresed ugyanazt a keretet, más állapotot kérsz számon, mint amit a lecke megadott. A jó ellenőrzési lap ezért nem csak a jel nevét, hanem a megfigyelés időpontját és helyét is rögzíti. Ebből az újrapróbáló tudja, mit kell összehasonlítania.
Hasonlóan válaszd külön az oldal meglétét és a megfelelő címhez jutást. Attól, hogy a böngésző megnyitott egy fájlt, a négy célpont valamelyike még hiányozhat. A linkek kattinthatók lehetnek, miközben az F03-ban bemutatott felirat eltér a megérkezési címtől. A teljes kör több külön kérdésből áll össze, és egyik részleges siker sem helyettesíti a többit. A következő saját lecke elkészítésekor ezekből a konkrét megfigyelésekből érdemes kiindulni.
A szerkesztési kutatás megőrzi a tényleges böngészőverziót és a visszafuttatott kör határát. Egy későbbi kódváltozatnál a teljes közölt bemenetből újra kell kezdeni a vizsgálatot. Ha csak a képaláírás módosult, annak jelentése akkor is összevetendő a lépésekkel. Ha az azonosító változott, a teljes kapcsolati készlet érintett lehet. A megismételhető lecke így a konkrét változathoz kötött, ellenőrizhető munkadarab marad, és az átvevő pontosan látja, mit kell tovább gondoznia.
Gyakori kérdések a tutorialról
Kötelező videóban elkészíteni?
Nem. Szöveg, kép, hang és videó is támogathat vezetett gyakorlást. A forma akkor megfelelő, ha a művelet és az elvárt eredmény követhető. Egy videó mellé is szükség lehet pontos kódra vagy szöveges lépésekre, és a formátum önmagában nem bizonyítja a tanulás sikerét.
Ugyanaz, mint egy teljes kézikönyv?
A tutorial egy megtervezett gyakorlási úton vezet végig. A referencia több funkció pontos leírását adhatja, a feladatútmutató pedig már ismert munkában segíthet. A leckében ezekhez hivatkozás kapcsolható, de a kezdőnek nem kell minden lehetőséget egyszerre választania.
Mit bizonyít az újrafuttatott példa?
A közölt bemenet adott környezetben kapott kimenetét. A valódi felhasználó tanulását, minden böngésző működését vagy egy teljes webhely minőségét nem igazolja automatikusan. A próba akkor használható bizonyíték, ha a készlet, az elvárás és a kapott eredmény együtt visszakereshető.
Források és szerkesztési megjegyzés
- Diátaxis: négy dokumentációs szándék
- Diátaxis: a tutorial mint tanulási lecke
- MDN: HTML-hivatkozás és oldalon belüli cél
A forrásokat a feltüntetett frissítéskor ellenőriztük. A számpéldák oktatási minták, a javasolt ellenőrzőlisták szerkesztői útmutatók. A platformok működése és elnevezése változhat.
Vissza az összes fogalomhoz · Szerkesztési elvek · Javítást javaslok ehhez a szócikkhez
