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?

Szemüveges férfi és nő papírtasak-készítést szemléltet; a vörös asztallapon lapos papír, hajtott köztes minta és kész tasak sorakozik, a nő két mintát tart.
A kód saját elkülönített szoftveres próbája nem emberi tanulási eredmény.

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.

01 / Saját helyi HTML-lecke

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 link
Kö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 kapcsolat
Vé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ő.

JelLátható fejezetcímA cél teljes azonosítójaA hozzá vezető hivatkozási érték
L01Olvasásolvasas#olvasas
L02Rendezésrendezes#rendezes
L03Ellenőrzésellenorzes#ellenorzes
L04Átadásatadas#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.

Könyvekkel teli, rendszerezett polcsorok egy könyvtárban.
A tartalom rendszerezése segít az olvasónak megtalálni a szükséges választ.Illusztráció · Fotó: Ayşe İpek / Pexels

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óbaBemenetElvárt célVisszafuttatott mintakimenetÁllapot
T01Olvasás linkolvasas; Olvasás címA megadott cél és cím megtalálható, aktiválás a megfelelő töredékre vezetMegfelelő
T02Rendezés linkrendezes; Rendezés címA megadott cél és cím megtalálható, aktiválás a megfelelő töredékre vezetMegfelelő
T03Ellenőrzés linkellenorzes; Ellenőrzés címA megadott cél és cím megtalálható, aktiválás a megfelelő töredékre vezetMegfelelő
T04Átadás linkatadas; Átadás címA megadott cél és cím megtalálható, aktiválás a megfelelő töredékre vezetMegfelelő

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.

02 / Egyetlen saját horgonyhiba

A változó címtöredék nem bizonyít létező célpontot

  1. 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.

  2. 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.

  3. 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.

HelyzetTeljes bemenetElvárt jelKapott saját visszafuttatásKövetkező művelet
H01href #ellenorzes-hibas; célazonosító ellenorzesA hivatkozáshoz nincs célNulla megfelelő cél; a töredék ettől még változikHivatkozási érték javítása
H02href #ellenorzes; célazonosító ellenorzesEgyetlen megfelelő célEgy megfelelő cím, helyes töredék és működő kapcsolatT03 ismétlése
H03Helyreállított teljes négyrészes fájlMinden eredeti kapcsolat helyesT01–T04 teljes készlete ismét egyezikJaví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örMegadott bemenetElvárt eredménySaját szoftveres mintaeredményHatár
B01Friss fájlból induló külön próbák; rendre 1, 2, 3, 4 Tab és minden esetben EnterMind 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
B02390 CSS-pixel széles nézetA négy cím és a navigáció olvasható, nincs oldalszintű vízszintes túlfutásA visszafuttatott mintában megfelelNem fizikai telefonos vizsgálat
B03JavaScript letiltvaA négy célkapcsolat működikMind a négy egyezés és aktiválás megmaradNincs 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ő.

03 / Három külön saját ellenhelyzet

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

F01 / Rossz hivatkozási érték#ellenorzes-hibas

0 cél A hibás érték találata

Vissza #ellenorzes alakraÉrtékjavítás
F02 / Átadás id-je is ellenorzesAz eredeti ellenorzes cél megmarad

2 cél Az ellenorzes találata

Az Átadás azonosítóját javítjuk0 atadas
F03 / Felirat Olvasás, érték #rendezesA cél továbbra is a Rendezés fejezete

Eltérő jelentés A működő link is lehet pontatlan

Vissza Rendezés alakraFeliratjavítás
VáltozatPontos saját módosításElvárt ellenőrzési jelKapott elkülönített kimenetHelyreállítás
F01Csak az Ellenőrzés link értéke #ellenorzes-hibasA linkhez nincs megfelelő címNulla ilyen cél találhatóÉrték vissza #ellenorzes alakra
F02Csak az Átadás cím azonosítója is ellenorzes leszAz ellenorzes cél nem egyedi; az atadas hiányzikKét ellenorzes cím és nulla atadas címÁtadás célazonosítója vissza atadas alakra
F03Csak a Rendezés link felirata Olvasás lesz; értéke #rendezes maradA felirat és a megérkezési cím jelentése eltérOlvasás felirat mellett Rendezés cél maradLá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

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