Teknika Zerbitzari-scriptak WCAG 2.2
SVR5Hizkuntza nagusia HTTP Content-Language goiburuan adieraztea
Izen ofiziala W3Cn: Hizkuntza lehenetsia HTTP goiburuan zehaztea
Laburbilduz
Zerbitzariak HTTP Content-Language goiburuan adieraz dezake orria zer hizkuntzatako publikoari zuzenduta dagoen. Balio horrek orriaren hizkuntza nagusiarekin bat etorri behar du. Gomendatutako osagarri bat da: ez du HTMLko lang atributua ordezten.
Zergatik da garrantzitsua
Goiburuak orri bakoitza zer publikori zuzenduta dagoen identifikatzen laguntzen du. Baliagarria da, adibidez, gaztelaniazko eta valentzierazko bertsioa duen udal batean.
Baina pantaila-irakurgailuek (edukia ozen irakurtzen duten programek) ez dute goiburu hori erabiltzen ahoskatzeko. Horretarako, lang atributua behar da html etiketan, eta hori da 3.1.1 irizpideak eskatzen duena.
Nola egiten da
- Jarri lehenik
langatributua orri bakoitzekohtmletiketan; adibidez,lang="es". - Konfiguratu zerbitzaria goiburua kode berarekin bidal dezan:
Content-Language: es. - PHPn, bidali beste edozein edukiren aurretik:
header('Content-Language: es'); - Apache-n
Header set Content-Language eserabiliz finka daiteke (mod_headersmodulua). - Hainbat hizkuntza dituzten webguneetan, bidali bertsio bakoitzean bere hizkuntzaren kodea:
es,ca,eu,gl,en…
Nola egiaztatu
- Ireki nabigatzailearen garapen-tresnak (F12), joan Sarea fitxara eta kargatu berriro orria.
- Hautatu dokumentuaren eskaera eta bilatu
Content-Languageerantzunaren goiburuetan. - Alderatu haren balioa
htmletiketarenlangatributuarekin. Hizkuntza bera adierazi behar dute.
Ikusi W3Cren testu osoa (euskarazko itzulpena)
W3Cren Techniques for WCAG 2.2 dokumentuko SVR5 teknikaren euskarazko itzulpen ez-ofiziala da hau. Akatsak izan ditzake. Dokumentu ofizial eta arauemaile bakarra jatorrizko bertsioa da, ingelesez, W3Cren webgunean argitaratua.
Aplikagarritasuna
Zerbitzariaren aldeko teknologiak, HTTP goiburuak ezartzeko aukera ematen duten zerbitzariko script-lengoaiak eta zerbitzariaren konfigurazio-fitxategiak barne.
Deskribapena
Teknika honen helburua da web-orri baten hizkuntza nagusiari edo nagusiei buruzko informazioa ematea, edukiaren hartzaileak identifikatzeko. HTTP Content-Language goiburuak hizkuntza-kode bat edo gehiagoko zerrenda bat izan dezake, eta erabiltzaile-agente baten eta zerbitzari baten arteko hizkuntza-negoziaziorako erabil daitezke. Erabiltzaile-agentearen hizkuntza-lehentasunak behar bezala konfiguratuta badaude, hizkuntza-negoziazioak erabiltzaileari lagun diezaioke edukiaren bertsio bat bere lehentasunetara egokitzen den hizkuntzan aurkitzen.
Kontuan izan HTTP Content-Language goiburuak ez duela balio edukia prozesatzeko erabiltzen den hizkuntza identifikatzeko. Edukia prozesatzeko hizkuntza beste teknika batzuen bidez identifika daiteke, hala nola markaketa-lengoaien lang eta xml:lang atributuen bidez.
Teknika honek bermatzen du dokumentuaren hizkuntza nagusia, adibidez lang edo xml:lang atributuan zehazten den bezala, HTTP Content-Language goiburuan agertzen dela.
Adibideak
Edukiaren hizkuntza ezartzea Java Servlet eta JSP teknologietan
Java Servlet edo JavaServer Pages (JSP) teknologietan, garatzaileak response.setHeader("Content-Language", lang) erabil dezake, non «lang» hizkuntza-etiketa bat den (adibidez, "en" ingeleserako):
...
public void doGet(HttpServletRequest request, HttpServletResponse response)
throws ServletException, IOException {
...
response.setHeader("Content-Language", "en");
PrintWriter out = response.getWriter();
...
}
Edukiaren hizkuntza ezartzea PHPn
PHPn, garatzaileak HTTP goiburu zuzen bat bidal dezake header metodoarekin. Ondorengo adibideak frantsesa ezartzen du hizkuntza gisa:
<?php header('Content-language: fr'); ... ?>
Probak
Prozedura
- Erabili denbora errealeko HTTP goiburuen ikustaile bat
Content-Languagegoiburuaren balioa jakiteko. - Egiaztatu balio hori web-orriaren hizkuntza lehenetsiarekin bat datorrela.
Espero diren emaitzak
- 2. urratsa egiazkoa da.
Baliabideak
- W3C Internationalization FAQ: HTTP and meta for language information (W3Cren nazioartekotzeari buruzko ohiko galderak, hizkuntza-informaziorako HTTP eta meta erabiltzeari buruz)
- Declaring metadata about the language(s) of the intended audience, Authoring HTML: Language declarations dokumentuan - W3Cren Lan Taldearen Oharra, 2014ko ekainaren 3koa.
- RFC 9110, 8.5. Content-Language
- PHP header (PHPren header funtzioaren dokumentazioa).
Nola egiaztatzen dugun ADDAWn
ADDAWren auditoria bakoitzean teknika hau orriz orri berrikusten dugu, eta akatsak pantaila-argazkiekin eta zuzentzeko moduarekin ematen dizkizugu.
W3Cren SVR5 teknikan oinarritua (WCAG 2.2). Azalpena eta adibideak: ADDAW. W3Cren testuaren itzulpen ez-ofiziala © W3C, W3Cren dokumentu-lizentzia. Akatsen bat ikusi duzu? Idatzi iezaguzu.