Hezkuntzako AA Egunkariaren estilo-liburua
Egunkariak nola idazten duen. Publikoak irakurriko duen zerbait idazten, berrikusten, itzultzen edo laburtzen duen agente guztiek (artikuluak, albiste laburrak, erreportajeak, «Duela urtebete», asteko iruzkinak, abisuak, sareetarako eta bideoetarako testuak) eta egunkaria mantentzen duten pertsonek bete behar dute. Hasi aurretik osorik irakurtzen da.
Gaztelaniazko jatorrizkoa AArekin itzulia, automatikoki.
Hemen dago komuna. Zeregin bakoitzak, gainera, bere gida du encargos karpetan, berezkoarekin (neurriak, formatua, abisuen tonua, binetak...); hemengo arau bat zeregin batean ez bada baliagarria, bere gidak esaten du. Estilokoak ez diren arauak (zer den albiste, zer eramaten duen zenbaki bakoitzak eta albisterik gabeko egunetarako gordetako artikuluak) «Egunkaria nola egiten den» dokumentuan daude, docs/como-se-hace.md.
Nori idazten zaion
- Taldeetan ez dauden irakasleei eta hezkuntzako AAn interesa duten pertsonei. Testu bakoitza bere kabuz ulertzen da, mezuak edo beste artikulurik irakurri gabe: zer den, zergatik axola zaion irakasle bati eta non aurki daitekeen.
- Publiko oso zabalarentzat, ez adituentzat: edozein irakasgaitako irakasle, familia, AArekin hasten ari den pertsona. Gaia dagoeneko ezagutzen dutenek bakarrik ulertzen badute zerbait, berridatzi egiten da.
- Irakurleari interesatzen zaiona, ez egunkariak barrutik nola funtzionatzen duen: argitaratzen denean ez dago agenterik, fitxategirik, programarik ez zerbitzaririk, artikuluak berak egunkaria edo Anthropic jorratzen ez badu («Zehaztasuna» atala).
Tonua
- Formala, informatiboa eta inpertsonala. Inoiz ez publizitarioa («harrigarria», «ezinbestekoa», «iraultzen du») ez alarmista. Harridura-markarik eta emojirik gabe.
- Abisuen eta binetaren gidek tonu hurbilagoa onartzen dute; inoiz ez iragarki-tonua.
Hizkuntza
- Gaztelania zuzena eta naturala. Itzulpenak, beren atalean.
- Hizkuntza inklusiboa, baina naturala: «el profesorado», «el alumnado», «las familias» bezalako forma kolektiboak; bikoiztuketarik eta ikur arrarorik gabe.
- Gaztelaniazko «quien» edo «quienes» erlatiboa saihestu, «la persona que» zentzuarekin: «la persona que», kolektibo bat («el profesorado») edo gaia aurretik duen esapide bat («separar la creación de la revisión», eta ez «separar a quien crea de quien revisa»). Galdetzailea, azentuarekin («¿quién?»), bai; hitzez hitzeko aipua dagoen bezala uzten da.
- Egunkariak argitaratzen duena «artikuluak» dira, ez «piezak» («pieza» hitza barnekoa da soilik, fitxategien eremuetan). Artikulu bat albiste bat, albiste labur bat edo erreportaje bat izan daiteke.
- Egunkariak gai batekin egiten duena: «argitaratu» egiten du, «jaso» egiten du edo gaia egunkarian «ateratzen da»; ez du «kontatzen» («el diario cuenta»). «Egunkariak azaroaren 3an argitaratu zuen...», «egunkariak jaso zuenez...».
- AAk ez du pentsatzen ez nahi izaten. Programa bati adimena edo asmoa ematen dioten aditzik ez («piensa», «entiende», «quiere», «miente»): eredu batek sortzen du, erantzuten du edo emaitza bat ematen du. Erabakitzen duena enpresa bat edo pertsona bat da: «OpenAIk mugatu egin du...», eta ez «ChatGPTk erabaki du...». Eredu batek asmatzen duena «asmatutako erantzuna» da; «haluzinazioa», azalduta bakarrik.
- Hiztegia: «adimen artifiziala», minuskulaz, eta bere sigla, AA, inoiz ez AI, izen berezietan izan ezik («Google AI Studio»). «Txatbota» eta «haluzinatu», komatxorik gabe. «Aplikazioa» «app» baino hobe, «lineako» «online» baino hobe, «esteka» «link» baino hobe eta «ikaste automatikoa» «machine learning» baino hobe. Prompt, etzanean. Irakurleak ezagutzen ez duen termino bat lehen aldian azaltzen da.
- Siglak: gutxi ezagutzen den bat lehen aldian garatzen da («Espainiako Datuak Babesteko Agentzia (AEPD)»); ingelesezko sigla tekniko bat (LLM, API, MCP) zer den azalduta joaten da («hizkuntza-eredu bat (LLM), ChatGPTren atzean dagoen programa mota»). Berriz erabiliko ez bada, ez da jartzen.
- Zurrumurruaren baldintzazkorik ez: ez «OpenAIk jaulki omen zuen...», baizik «[iturriaren] arabera, OpenAIk jaulki du...» edo «litekeena da...».
- Esaldi argiak: ideia bat esaldiko, hitz arrunta teknikoaren aurretik eta kanpoan metafora higatuak («paradigma-aldaketa», «AAren garaian»).
- Laburra baino hobe argia. Berriz irakurtzera behartzen duten adierazpen konprimiturik ez: izen-kateak («multimodal sorkuntza-fluxua egiaztapen gurutzatuarekin»), taldeen jargoia, jakintzat ematen diren hitzak edo aditza falta zaien esaldiak. Esaldi labur bat ulertzeko zailagoa bada zertxobait luzeagoa baino, luzea sartzen da: «irudiak eta bideoa sortzen dituen eta emaitza beste eredu batekin egiaztatzen duen sistema bat».
- Produktuen, aplikazioen, taldeen eta dokumentuen izenak, enpresak edo egileak idazten dituen bezala («ChatGPT», «Vibe Coding Educativo»). Katalanezko edo beste hizkuntza bateko baliabide bat gaztelaniaz deskribatzen da eta bere izena gordetzen du; obra baten izenburua bere hizkuntzan geratzen da.
Titularrak, aurretitulu eta sarrerak
- Titularra: argia, aditzarekin, galderarik eta amuarik gabe («ez duzu sinetsiko...»). Jasotzen duenak zer ekarpen egiten duen esaten du, ez soilik tresnaren edo dokumentuaren izena. Gehienez 90 karaktere, zuriuneak barne: sartzen ez dena aurretitulura edo sarrerara doa.
- Aurretitulua: bi eta bost hitz artean, aditzik gabe: gauza motak edo esparruak («Gida ofiziala», «Biltegiko berria», «EduMediaren funtsetik»).
- Sarrera: artikulua laburbiltzen duten esaldi bat edo bi (hiru edo bi erreportajean). Ez du titularra errepikatzen: hurrengoa ekartzen du.
- Titularrak eta sarrerak ez dute gorputzak baino gehiago esaten, ezta iturriak baino gehiago ere. Gorputzak zehazten duena («enpresaren arabera», «ordainpeko planetan», «egilearen hipotesia da») ez da goian desagertzen. Alderatzeko ezer ez duen proba batek ez du kausa bat «frogatzen» ez «iradokitzen».
- Egun hauetakoa ez denak bere data eramaten du titularrean: abuztuko txosten bat ez da gaur «argitaratzen», «Abuztuko txosten bat...» da.
Pertsonak
- Gaiak, ez pertsonak. Ez da taldeetan iritzia ematen edo galdetzen dutenen izenik aipatzen, ezta «kide batek esan zuen...» ere: jarrerak jasotzen dira.
- Baliabide baten egilea izendatzen da, berak argitaratu badu (aplikazio bat, gida bat, dokumentu bat), kreditu gisa («...-k sortua»), baliabide beraren izenarekin edo hura argitaratzen duen pertsonaren izen osoarekin. Izen soil batek ez du inor identifikatzen: baliabideak nork egiten duen esaten ez badu, «bere egilea», eta webak ez duela adierazten. Inoiz ez da abizena osatzen.
- Nor den nor, materialaren markak esaten du, ez izenak (ADR 0066): egunkariaren egileak
[autor del diario: …]markatutako mezuak dira soilik; izen bera duen beste pertsona bat beste pertsona bat da. Markak ez dira argitaratzen. - Egunkariaren egileak, edonor bezala: beren baliabideen kreditu gisa izendatzen dira beste guztiak bezala, egunkarian sinatzen duten izen osoarekin, taldeetan beste bat erabili arren.
- Karguak, albistearekin zerikusia dutenean soilik (talde bat administratzea, egunkariaren egilekidea izatea): bestela, pertsona irakasle bat gehiago da.
- Artikuluak egunkaria bera jorratzen badu, hala esaten du hitz horiekin («egunkari hau»).
- Ikasleak: ez da argitaratzen identifikatzen dituen ezer (izena, irudia, ezta ikastetxea eta maila batera ere), partekatutako materialean agertu arren. Ikasgelarako tresna baten kasuan, bere baldintzen arabera, esaten da ikasleen daturik eskatzen duen eta bere ereduak entrenatzeko erabiltzen dituen; jakiten ez bada, hala esaten da.
Zehaztasuna
- Baieztapen bakoitza iturri originalean egiaztatzen da: iragarpen ofizialean, produktuaren orrian, administrazioaren dokumentuan. Taldeko mezu batek, X-rako esteka batek edo bideo batek ez dute aski.
- Egiaztatu ezin dena, kendu egiten da edo baieztatu gabe gisa esaten da. Ez asmatu datarik, zifrarik, egilerik ez funtziorik.
- Enpresa batek iragartzen duena, bere baldintzekin: zein planetan, zer prezioan, noiz arte, zein herrialdetan. «Doan» edo «guztientzat» bere baldintzekin alderatzen da.
- Enpresen hizkera, egotzita edo kanpoan: «iraultzailea», «indartsua» edo «aurrekaririk gabea», egotzitako aipu baten barruan soilik; testuak produktuak zer egiten duen esaten du. Ikerketa bat edo inkesta bat nork egiten duen eta nork ordaintzen duen esanez aurkezten da, eta enpresarena bada, esaten da («OpenAIren beraren ikerketa baten arabera»). Prentsa-ohar bat ez da erreproduzitzen: identifikatu eta berridazten da.
- Artikulu batek Anthropic edo Claude jorratzen duenean, esaldi batek gogorarazten du egunkaria Clauderen agenteek idazten dutela, irakurleak kontuan izan dezan. Pasa-pasa, zerrenda batean aipatzeak ez du eskatzen.
- Zifrak, iturriaren zehaztasunarekin (iturriak ematen ez dituen dezimalik gabe) eta proportzio bat bere kopuru absolutuarekin («bikoitza, 10etik 20 ikastetxetara»). Iturriak zifra desberdinak ematen baditu bertsioaren edo planaren arabera, zein dagokion bakoitzari esaten da. % 20tik % 30era 10 puntu gehiago dira, ez % 10 gehiago. «Zortzi irakasletik bat» % 12,5 baino hobe.
- Aldatzen diren datuak datatzen dira («2026ko azaroaren 1ean»); gainerakoak ez dute datarik.
- Orri ofizial bat zaharkituta egon daiteke: egunkariak dokumentua aurrean zuela argitaratutakoaren aurka badago, argitaratutakoak agintzen du, eta hala esaten da.
- Esteka bat epaitu aurretik, ireki egiten da: helbideak ez du esaten orrian zer dagoen ez zer datatakoa den.
- Egunkariak jada argitaratutakoa, berdin: jada jorratutako gai bati buruzko artikulu batek aurrekoaren zifra eta data berberak ematen ditu, estekatzen du eta, zerbait aldatu bada, hala esaten du.
Aipuak eta beste hizkuntzak
- Aipu laburrak eta zehatzak, komatxo artean, eta gutxi: artikuluak azaltzen du, ez kopiatzen.
- Komatxo artean doana iturrian berdin bilatzen da; agertzen ez bada, kendu egiten da edo parafraseatzen da. Iturri batetik hartutako esaldi bat komatxo artean doa edo berridazten da.
- Ez da aipurik ingelesez soilik: edo itzulita, edo itzulpena alboan parentesi artean.
- Kanpoko gauza ofiziala (arau baten, txosten baten izenburua) jatorrizko hizkuntzan geratzen da.
Iturriak eta estekak
Xehetasunak encargos/enlaces.md fitxategian daude; funtsezkoena:
- Izendatzen dena izendatzen den tokian estekatzen da, lehen aipamenean eta bere izena estekaren testu gisa; amaieran,
fuenteseremuan, guztiak. - Iturri originalera eta ofizialera, gaztelaniaz (edo katalanez) bertsio hori badago; tresna bat, irakurleak erabiliko duen webera, ez bere kode-biltegira.
- Jada argitaratutakoa, argi erlazionatuta badago, estekatuta, bere gakoarekin (
pieza:AAAA-MM-DD/id), zertaz den esaten duen testu batekin, inoiz ez «hemen». - Estekaren testua ez da inoiz «123. mezua» ez eta helbide hutsa.
- Fitxategi bat deskargatzen duen esteka batek hala esaten du: «gida (PDF)».
Forma
- Komatxo espainiarrak («»); haien barruan, ingelesak (“”).
- Ehunekoa, ikurra aurrean eta zuriunearekin (% 25); milakoak, zuriunearekin (1 200); monetak, beren izenarekin («10 dolar», «4 euro»).
- Hiru eta sei esaldi arteko paragrafoak testu luzeetan (gida bakoitzak bere neurria ematen du). Letra lodiak neurriz: bi edo hiru ideia testu luze batean.
- Estekak Markdown-en (
[texto](url)); abisuetarako eta sareetarako testuetan, testu laua (beren gidek esaten dute). - Inoiz ez «gaur», «atzo» ez «aste honetan»: data edo eguna («ostegun 12an»). Zenbakia elkarrizketen hurrengo egunean ateratzen da eta hemerotekan geratzen da; beste egun baterako gordetzen denak (erreserba, aurrez idatzitako «Duela urtebete») ere ez du «oraintxe» esaten.
Grafikoak
- Grafiko bat, testuak begirada batean ikusten uzten ez duena azaltzen duenean soilik: iturri berberaren hiru zifra konparagarri edo gehiago (ikerketa baten emaitzak, inkesta bat, denboran zeharreko bilakaera). Ez apaintzeko ez zifra batentzat edo biri, testuan esaten direnak.
- Egunkariaren programak marrazten du datuetatik abiatuta (artikuluaren edo erreportajeko ataleko
graficoeremua, ADR 0084), inoiz ez agente batek eskuz: barra horizontalak (barras, alderatzeko), zutabeak (columnas, kategoria gutxirako eta etiketa laburrekin) edo lerroak (lineas, bilakaera baterako). - Datuak, zehatzak eta iturri bakarrekoak: iturriak ematen dituen balio berberak, bere zehaztasunarekin, eta unitate bera guztientzat. Barrak beti zeroan hasten dira (programak berak egiten du); ez nahastu grafiko batean iturri desberdinetako zifrak.
- Zer neurtzen den esaten duen izenburua, ez ondorioa («Detektagailuek AAtzat hartutako giza idazlanak»), eta etiketa laburrak.
- Iturria, beti, estekatuta; eta oharrean, ondo irakurtzeko behar dena: zenbat pertsona edo kasu, nondik eta noiz, eta datuak enpresarenak diren («enpresaren arabera»).
Itzulpenak
Edizio bakoitza katalanera, galegora, euskarara eta ingelesera itzultzen da, gaztelaniaren irizpide berarekin eta hizkuntza bakoitzaren erregistro naturalean, ez kalkatua. Hizkuntza bakoitzean nola egiten den (araua, non kontsultatu, formatuak, AAren hiztegia eta Espainiari berezkoa) itzultzailearen liburuan dago, encargos/traduccion.md.
Zuzenketak
- Akats bat inork eskatu arte itxaron gabe zuzentzen da, artikulu berean eta bost hizkuntzetan, amaieran bere oharrarekin (ADR 0055): «Corregido el…» (akats bat zegoen), «Actualización del…» (datua zuzena zen eta aldatu egin da) edo «Nota añadida el…» (zerbait falta zen). Zentzua aldatzen ez duen akats bat oharrik gabe zuzentzen da.
- Akatsa titularrean, abisuetan edo sareetan bazegoen, zuzenketa hara ere iristen da.
- Ez da artikulu oso bat kentzen, zati bat aldatzea aski bada.
IArik gabe egiaztatzen dena
Programa batzuek gau bakoitzean arau hauetako batzuk berrikusten dituzte (ADR 0056, 0059 eta 0067), baina ez dute berrikuslea ordezkatzen:
scripts/revisar-estilo.py: «quien» erlatiboa, ingelesez soilik dauden aipuak eta bilatu daitezkeen hiztegi- eta forma-arauak («hoy», «pieza», «el diario cuenta», «app», zurrumurruaren baldintzazkoa, ehunekoa); aurkitzen duena agente batek zuzentzen du.scripts/comprobar-corrector.py: estilo-zuzentzaileak, egunaren artikuluen idazkera gau bakoitzean berrikusten duen agente batek, daturik aldatu ez duela.scripts/corregir-erratas.py: «e» «i»ren aurrean, «u» «o»ren aurrean, komatxo espainiarrak ingelesean, eta 90 karaktere baino gehiagoko titularrak jakinarazten ditu.scripts/revisar-idiomas.py: itzulpen batean sartu zaion gaztelania.scripts/revisar-autoria.py: egunkariaren egile bati egozten zaiona eta beste kontu batena dena.