Accessible PDF: návod

Rýchly začiatok

1. Pridajte súbory (Ctrl+O), priečinok (Ctrl+Shift+O) alebo ich pretiahnite do zoznamu.
2. Zvoľte normu: PDF/UA-2 (PDF 2.0, odporúčané) alebo PDF/UA-1. Pri archivácii zvoľte aj úroveň PDF/A.
3. Stlačte Exportovať do prístupného PDF (Ctrl+E alebo F5).
4. Doplňte alternatívne texty obrázkov, ak o ne program požiada, a prečítajte si správu o prístupnosti.

Pôvodný súbor sa nikdy nemení. Výsledok sa uloží ako nový súbor s príponou _pristupne a vedľa neho správa o prístupnosti. Kláves F1 otvorí kapitolu tohto návodu k prvku, na ktorom je zameranie; krátky pomocník je aj v ponuke Pomocník (Rýchly začiatok, Klávesové skratky, Pojmy a skratky, Čo program potrebuje, Ochrana súkromia, Licencia, O programe).

Čo program potrebuje

Nevyhnutné

• Windows 10 alebo 11, 64-bitový. Program je na stiahnutie na GitHube v časti Releases v dvoch podobách: inštalátor (AccessiblePDF-…-win64-setup.exe; pridá program do ponuky Štart, netreba práva správcu) a prenosná verzia (AccessiblePDF-…-win64-portable.zip; stačí rozbaliť a spustiť AccessiblePDF.exe, nastavenia ukladá do priečinka Data vedľa programu, takže funguje aj z USB kľúča). Internet nepotrebuje. 32-bitová verzia nie je: knižnica pikepdf pre 32-bitový Windows už nevychádza a Windows 11 32-bitovú verziu nemá.
• Na súbory PDF nič iné netreba.
• Na prevod dokumentov (Word, Excel, PowerPoint, LibreOffice, Markdown, HTML, TXT, CSV) aspoň jeden z týchto programov:
  • LibreOffice 7.4 alebo novší, zadarmo na libreoffice.org. PDF/UA-2 a PDF/A-4 (PDF 2.0) vyžadujú verziu 25.8 alebo novšiu.
  • Microsoft Office 2016 alebo novší, prípadne Microsoft 365 (Word, Excel, PowerPoint). Súbory Visio vyžadujú aktivovaný Microsoft Visio.

Odporúčané

• veraPDF 1.26 alebo novší na nezávislé overenie súladu s PDF/UA, PDF/A a WTPDF (verapdf.org; inštalátor obsahuje Javu). Program ho hľadá v bežných priečinkoch; cestu zadáte v Predvoľbách.
• PAC 2026 na ručnú kontrolu a čítač obrazovky (NVDA, JAWS, Moderátor) na overenie výsledku.

Čo je na vašom počítači nainštalované, ukáže ponuka Pomocník > Čo program potrebuje alebo príkaz ppdf prostredie.

Podporované formáty

Podporované sú aj formáty s makrami (.docm, .dotm, .xlsm, .xltm, .xlsb, .pptm, .potm, .ppsm, .vsdm, .vstm a staršie binárne formáty). Makrá sa pri exporte nikdy nespustia a do PDF sa neprenesú. Jednotný formát UOF (.uot, .uos, .uop) podporovaný nie je: LibreOffice 26.8 ho síce uloží, ale spätne neotvorí.

Postup exportu

1. Pridajte súbory tlačidlom Pridať súbory, celý priečinok tlačidlom Pridať priečinok (aj s podpriečinkami) alebo súbory pretiahnite do zoznamu.
2. Pri jednotlivom súbore môžete vo Vlastnostiach súboru zadať názov, autora, predmet, kľúčové slová a jazyk dokumentu (pozri Vlastné metadáta dokumentu).
3. V časti Výstup zvoľte normu, úroveň PDF/A, verziu PDF a kam sa má výsledok uložiť; v časti Prevod dokumentov, cez ktorý program sa dokumenty prevedú.
4. Stlačte Exportovať do prístupného PDF. Priebeh sa zobrazuje v stavovom riadku a čítač obrazovky ho oznamuje; export zrušíte klávesom Esc.
5. Ak niektorým obrázkom chýba alternatívny text, program otvorí okno Alternatívne texty.
6. Po skončení prejde zameranie na zoznam súborov (dá sa vypnúť v Predvoľbách). Výsledok vybraného súboru je v poli Podrobnosti výsledku; PDF, správu a priečinok otvoríte tlačidlami pod ním.

Výsledok má meno pôvodného súboru s príponou (predvolene _pristupne). Existujúci súbor sa neprepíše, nový dostane poradové číslo, napríklad správa_pristupne (2).pdf.

Voľby

Súlad s normou

PDF/UA-2 (PDF 2.0) alebo PDF/UA-1 (PDF 1.7, 1.6, 1.5; s PDF/A-1 PDF 1.4).

Archivácia (PDF/A)

Úroveň PDF/A; ponuka obsahuje len úrovne zlučiteľné so zvolenou normou (Archivácia PDF/A).

Deklarovať aj Well-Tagged PDF

Pri PDF/UA-2 pridá deklaráciu WTPDF 1.0 (Well-Tagged PDF).

Priložiť pôvodný dokument

Vloží pôvodný súbor do PDF ako prílohu so vzťahom „zdroj“. Dovoľuje to len PDF bez PDF/A, PDF/A-3 a PDF/A-4f. Pozor: príloha obsahuje celý pôvodný súbor vrátane komentárov, sledovaných zmien a makier.

Uložiť vedľa pôvodného súboru alebo do iného priečinka

Kam sa uloží PDF a správa.

Prípona mena výstupného súboru

Text pridaný k menu pôvodného súboru. Znaky, ktoré nemôžu byť v mene súboru, sa nahradia podčiarkovníkom, takže výsledok sa vždy uloží do zvoleného priečinka.

Predvolený jazyk dokumentu

Použije sa, ak dokument jazyk nemá a program ho nerozpozná z textu. Ak má dokument nastavený iný jazyk, než v akom je text, program jazyk opraví a upozorní na to.

Dokumenty prevádzať cez

Automaticky, LibreOffice alebo Microsoft Office (Prevod).

Overiť vo veraPDF

Nezávislé overenie súladu s PDF/UA, zvolenou úrovňou PDF/A a WTPDF.

Kontrolovať kontrast textu

Porovná farbu každého úseku textu s pozadím na vykreslenej strane: úroveň AA (4,5:1, veľký text 3:1) a AAA (7:1, veľký text 4,5:1).

Vytvoriť záložky z nadpisov

Dokument bez záložiek dostane záložky podľa nadpisov.

Označiť jazyk cudzojazyčných odsekov

Odsek, ktorého jazyk program spoľahlivo rozpozná a líši sa od jazyka dokumentu, dostane vlastný jazyk (WCAG 3.1.2).

PDF s existujúcimi značkami označiť nanovo

Zahodí pôvodné značky PDF a vytvorí nové podľa vzhľadu strán.

Odstrániť JavaScript a spúšťanie programov

Predvolene zapnuté. Akcie, ktoré spúšťajú programy alebo načítajú súbory, sa odstránia vždy. Pri PDF/A sa JavaScript odstráni vždy, lebo ho PDF/A nepovoľuje.

Vyžiadať chýbajúce alternatívne texty

Po exporte otvorí okno na doplnenie alternatívnych textov.

Uložiť správu o prístupnosti

Vedľa PDF uloží správu v HTML (meno PDF + _sprava.html).

PDF/UA-1 alebo PDF/UA-2

PDF/UA-2 (ISO 14289-2:2024) je novšia norma postavená na PDF 2.0. PDF/UA-1 (ISO 14289-1) je postavená na PDF 1.7 a podporuje ju viac nástrojov. Kontrolný nástroj PAC 2026 hodnotí PDF/UA-1, PDF/UA-2 zatiaľ len čiastočne; ak má výsledok prejsť testom v PAC, zvoľte PDF/UA-1. Oba typy program overí vo veraPDF.

Archivácia PDF/A

PDF/A (ISO 19005) je norma na dlhodobú archiváciu: dokument obsahuje všetko, čo potrebuje na zobrazenie (písma, farebný profil), a nesmie obsahovať nič, čo by sa mohlo časom zmeniť alebo nefungovať (skripty, externé odkazy na obsah).

Písmeno úrovne: a znamená úplnú zhodu vrátane štruktúry a textu v Unicode, u vzhľad a Unicode, b len vzhľad. Výsledok programu je vždy označený a v Unicode (PDF/UA), takže pri úrovni b alebo u je rovnako prístupný; úroveň len určuje, čo deklaruje.

Program pri PDF/A: vloží výstupný zámer s profilom sRGB (profil vytvorí sám), ak dokument používa farby CMYK, doplní k nim profil, vloží alebo nahradí chýbajúce písma, odstráni JavaScript, zakázané akcie a anotácie, upraví metadáta (deklarácia, súlad so slovníkom Info, opis schémy PDF/UA) a pri PDF/A-1 odstráni priehľadnosť (polopriehľadné plochy a text zmieša s bielym pozadím, mäkké masky obrázkov zlúči), prekóduje obrázky JPEG 2000 a doplní zoznam znakov písiem. Prílohy, ktoré zvolená úroveň nedovoľuje, odstráni a upozorní na to. Pri dokumentoch Office a LibreOffice použije aj vlastný export PDF/A daného programu.

Well-Tagged PDF

Well-Tagged PDF (WTPDF 1.0) je špecifikácia PDF Association pre dobre označené PDF 2.0. Má dve úrovne: prístupnosť a opakované použitie obsahu. Voľba Deklarovať aj Well-Tagged PDF (len pri PDF/UA-2) zapíše do metadát deklarácie oboch úrovní; veraPDF ich overí profilmi WTPDF.

Prevod cez LibreOffice alebo Microsoft Office

V časti Prevod dokumentov zvolíte, ktorý program prevedie dokument do PDF so značkami:

• Automaticky: LibreOffice, ak je nainštalované a vie zvolenú verziu PDF, inak Microsoft Office.
• LibreOffice: beží bez okna s vlastným dočasným profilom; nevadí, ak máte LibreOffice otvorené. Vie aj vyplniteľné formuláre z polí dokumentu.
• Microsoft Office: Word, Excel, PowerPoint a Visio. Rozloženie strán je rovnaké ako v Office. Word nevie do PDF exportovať vyplniteľné polia formulára (program na to upozorní) a webový archív MHT vie previesť len Word.

Microsoft Office beží vo vlastnej skrytej inštancii, takže dokumenty, ktoré máte otvorené, sa nezatvoria; PowerPoint, ktorý už beží, sa nikdy neukončí. Makrá sa nespustia, dokument sa otvára len na čítanie, bez aktualizácie prepojení a prepočtu vzorcov. Ak Office zobrazí okno (napríklad aktiváciu produktu alebo opravu dokumentu), na ktoré by čakal, program jeho inštanciu ukončí a oznámi to.

Vlastné metadáta dokumentu

V okne Vlastnosti súboru (vyberte súbor a stlačte Alt+Enter alebo Enter) môžete pre každý súbor zadať názov, autora, predmet, kľúčové slová a jazyk. Prázdne pole znamená hodnotu zo zdrojového dokumentu; tú okno zobrazí v poli Vlastnosti v zdrojovom dokumente. Viacerých autorov oddeľte bodkočiarkou, kľúčové slová čiarkou. Zadané hodnoty sa zapíšu do PDF (XMP aj slovník Info) a do správy; program si ich nepamätá.

Názov, autor a zobrazenie pri otvorení

Ak ich nezadáte vo Vlastnostiach súboru, názov, autor, predmet a kľúčové slová sa preberú zo zdrojového dokumentu (Word: Súbor, Informácie, Vlastnosti; LibreOffice: Súbor, Vlastnosti; Markdown: hlavička YAML title, author; webová stránka: title a meta). Ak dokument názov nemá, program ho navrhne z titulku na prvej strane alebo z prvého nadpisu a upozorní na to. Autor, ktorý je len menom programu alebo predvoleným menom (napríklad Windows User), sa do PDF nezapíše.

Výsledné PDF sa otvorí s názvom dokumentu v titulku okna (WCAG 2.4.2), s otvoreným panelom záložiek (ak má dokument záložky) a s prvou stranou celou v okne.

Alternatívne texty obrázkov

Alternatívny text opisuje, čo obrázok zobrazuje a prečo je v dokumente; pri grafe stačí hlavné zistenie. Najlepšie je zadať ho v zdrojovom dokumente. Ak chýba, program po exporte otvorí okno Alternatívne texty: v zozname Obrázky vyberte obrázok (zobrazí sa náhľad a strana), v poli Text nájdený v obrázku je text z obrázka (popisky grafu), do poľa Alternatívny text napíšte opis alebo začiarknite Dekoratívny obrázok a stlačte Uložiť do PDF. Okno sa dá otvoriť aj neskôr tlačidlom Alternatívne texty obrázkov. Program upozorní aj na texty vygenerované umelou inteligenciou a na texty, ktoré sú len menom súboru.

Grafy

• Graf z Wordu, Excelu, PowerPointu alebo LibreOffice bez alternatívneho textu dostane text zostavený z jeho údajov (druh grafu, názov, osi, hodnoty sérií). Text overte; hlavné zistenie uveďte aj v texte dokumentu.
• Program upozorní na graf, ktorý rozlišuje série len farbou (WCAG 1.4.1), a na farby s kontrastom pod 3:1 (WCAG 1.4.11).
• Graf, ktorý Calc rozdelí na viac strán, je v PDF jeden obrázok.
• V PDF bez značiek program rozpozná vektorový graf, schému alebo diagram a označí ho ako obrázok.

Matematické vzorce

Podľa príručky PDF Association „Best Practice Guide: Math in PDF“: vzorec je prvok Formula s alternatívnym textom a pri PDF/UA-2 aj so zápisom MathML ako pridruženým súborom, ktorý vedia čítať čítače obrazovky.

• Word (Microsoft 365) dá vzorcom alternatívny text (anglickú reč vzorca) a MathML sám; program textu doplní jazyk angličtina, ak je dokument v inom jazyku.
• LibreOffice alternatívny text vzorcom nedá: program ho zostaví zo vzorcov dokumentu ako lineárny zápis, napríklad „a² + b² = c²“ alebo „x = (−b ± √(b² − 4ac))/(2a)“, a pri PDF/UA-2 priloží MathML.
• Samostatný vzorec LibreOffice Math (.odf, .mml) sa označí ako jeden prvok Formula.
• PDF/A-1, 2, 4 a 4e prílohy, ktoré nie sú PDF/A, nepovoľujú; MathML sa vtedy nepriloží (alternatívny text ostane).

Formuláre

Vyplniteľné polia vzniknú z ovládacích prvkov obsahu Wordu a polí LibreOffice (pri prevode cez LibreOffice) a z formulára AcroForm vo vstupnom PDF. Program doplní každému poľu popis podľa menovky, skupine prepínačov popis skupiny, povinnému poľu slovo „povinné“, zaradí pole za menovku, doplní popis widgetu (PDF/UA-2), nahradí nevložené písmo polí a odstráni dynamický formulár XFA. Staré polia formulára Wordu sa prenesú len ako text.

Markdown, webové stránky a text

• Markdown (.md) program prevedie na HTML sám: nadpisy, odseky, zoznamy aj vnorené, tabuľky s hlavičkou, citáty, kód, odkazy a obrázky s alternatívnym textom; názov a autora vezme z hlavičky YAML.
• Webová stránka (.html) sa pred prevodom vyčistí: skripty, rámce a obrázky či štýly z internetu sa odstránia (vzdialený obrázok nahradí jeho alternatívny text), miestne obrázky z priečinka stránky sa použijú.
• Webový archív (.mht) vie previesť len Microsoft Word.
• TXT a CSV: program rozpozná kódovanie (UTF-8, UTF-16) a oddeľovač CSV (bodkočiarka, čiarka).

Spracovanie PDF

PDF so značkami program opraví a prevedie na zvolenú normu. PDF bez značiek označí automaticky podľa vzhľadu strán; výsledok treba skontrolovať, najmä poradie čítania a tabuľky. Program nerobí OCR: strany, ktoré sú len obrázkom, neprevedie. Zabezpečené (šifrované) PDF treba najprv odomknúť v programe, v ktorom vzniklo.

Správa o prístupnosti

Správa (HTML) obsahuje zhrnutie jednoduchými vetami, údaje o dokumente, zoznam toho, čo treba opraviť (s návrhom opravy), výsledok pre každé kritérium WCAG 2.2 s článkom EN 301 549 V4.1.1, výsledok veraPDF, vykonané úpravy a vysvetlenie použitých skratiek. Výsledky: Splnené, Nesplnené, Pravdepodobný problém, Overiť ručne a Netýka sa. Názvy kritérií sú podľa metodického usmernenia MIRRI. Správa sama spĺňa WCAG 2.2 úrovne AAA a EN 301 549 V4.1.1.

EN 301 549 V4.1.1 vyžaduje pre dokumenty kritériá WCAG 2.2 úrovne A a AA (kapitola 10) a článok 10.7. Kritériá úrovne AAA sú v správe navyše; súlad s nimi potvrdí až ručné posúdenie položiek „Overiť ručne“.

Bezpečnosť

Program spracúva dokumenty, ktoré mohol pripraviť ktokoľvek, preto dokument nemôže spustiť kód, čítať iné súbory ani komunikovať so sieťou:

• Bez siete. Program nič neodosiela, nekontroluje aktualizácie a nezbiera údaje o používaní.
• Originál sa nemení. Úpravy sa robia v kópii v dočasnom priečinku, ktorý sa zmaže.
• Makrá sa nespustia v LibreOffice (vypnuté makrá, Java, automatizácia OLE, prepojenia, prepočet vzorcov) ani v Microsoft Office (vynútené vypnutie makier, bez aktualizácie prepojení a obnovenia pripojení údajov).
• Externé zdroje sa nenačítajú. Z kópie sa odstránia obrázky, objekty, šablóny a polia (INCLUDEPICTURE, INCLUDETEXT, LINK, DDE) prepojené na internet, sieťový priečinok alebo iný súbor (aj v RTF), skripty a vzdialené zdroje webových stránok a obnovenie pripojení údajov Excelu. Bránia sa tak úniku prihlasovacích údajov Windows (NTLM) a sledovaniu otvorenia dokumentu.
• Bezpečné čítanie XML a ZIP (ochrana pred XXE, „billion laughs“ a „ZIP bombou“).
• Aktívny obsah PDF: akcie Launch a ImportData sa odstránia vždy, JavaScript predvolene; na nebezpečné prílohy program upozorní.
• Bez príkazového interpretera, programy sa volajú plnou cestou a nehľadajú sa v aktuálnom priečinku.
• Server MCP pre AI asistentov číta a zapisuje len v povolených priečinkoch, nepovoľuje sieťové cesty, zariadenia ani alternatívne prúdy súborov a nikdy neprepíše existujúci súbor.
• Správa a návod majú Content-Security-Policy, ktorá zakazuje skripty.
• Kontrolné súčty. Správa uvádza SHA-256 výsledného PDF; pri programe je súbor SHA256SUMS.txt (overenie: Get-FileHash AccessiblePDF.exe).

Odporúčania: program, LibreOffice a Office udržiavajte aktuálne, spúšťajte program pod bežným používateľským účtom z priečinka, do ktorého nemôžu zapisovať iní, a výsledné PDF otvárajte v aktuálnom prehliadači PDF.

Ochrana súkromia

• Program nezbiera, neukladá ani neodosiela osobné údaje. Nekomunikuje so sieťou, nemá účet ani registráciu a neposiela štatistiky používania.
• Dokumenty a výsledné PDF sa nikde inde neukladajú ani neodosielajú. Program pracuje s dočasnou kópiou dokumentu v dočasnom priečinku Windows, ktorú po spracovaní zmaže; kópie, ktoré by ostali po páde programu, zmaže pri ďalšom spustení. Výsledné PDF a správa sa uložia len tam, kam určíte.
• Word, Excel a Visio otvárajú kópiu bez pridania medzi naposledy otvorené súbory; LibreOffice používa dočasný profil, ktorý sa po skončení programu zmaže.
• Metadáta zadané vo Vlastnostiach súboru sa zapíšu len do výsledného PDF a správy; program si ich nepamätá.
• Na počítači sa ukladajú len nastavenia (%APPDATA%\AccessiblePDF\settings.json: voľby, jazyk, klávesové skratky, veľkosť okna, cesty k programom, naposledy použitý a výstupný priečinok) a záznam chýb (%LOCALAPPDATA%\AccessiblePDF\accessible-pdf.log: dátum, mená súborov a chybové hlásenia, nie obsah dokumentov). Záznam a naposledy použitý priečinok vymažete v ponuke Pomocník > Ochrana súkromia; oba súbory môžete kedykoľvek zmazať aj ručne.
• Ak program použijete cez AI asistenta (server MCP), údaje, ktoré mu nástroj odovzdá (zistenia, texty a náhľady obrázkov z dokumentu), spracúva tento asistent podľa svojich podmienok; program sám nič neodosiela.
• Prenosná verzia (súbor PORTABLE.txt vedľa programu) ukladá nastavenia aj záznam do priečinka Data vedľa programu a v profile používateľa nič nenechá.
• Položky Nahlásiť chybu a Zdrojový kód na GitHube v ponuke Pomocník otvoria stránku vo vašom prehliadači; program sám sa na internet nepripája. Hlásenie chyby na GitHube je verejné: ak k nemu priložíte dokument alebo záznam chýb, najprv z nich odstráňte osobné a citlivé údaje.

Klávesové skratky

Skratky zmeníte alebo vypnete v ponuke Nastavenia > Klávesové skratky: do poľa akcie napíšte skratku (napríklad Ctrl+Shift+E alebo F6); prázdne pole skratku vypne. Skratka musí obsahovať Ctrl alebo Alt, alebo to musí byť funkčný kláves, aby nekolidovala s písaním. Tlačidlo Obnoviť predvolené skratky vráti pôvodné nastavenie. Prehľad aktuálnych skratiek je v ponuke Pomocník > Klávesové skratky.

Predvoľby

Cesta k LibreOffice a priečinok veraPDF

Prázdne pole znamená automatické hľadanie.

Po exporte otvoriť správu o prístupnosti v prehliadači

Pri jednom súbore otvorí správu automaticky.

Oznamovať čítaču obrazovky začiatok spracovania každého súboru

Vypnite, ak vás oznamy počas exportu vyrušujú; výsledok exportu sa oznámi vždy.

Po exporte presunúť zameranie na zoznam s výsledkami

Vypnite, ak chcete, aby zameranie ostalo, kde je.

Jazyk rozhrania

Slovenčina alebo angličtina; zmení sa hneď. Jazyk prepnete aj v ponuke Nastavenia alebo skratkou Ctrl+Shift+L.

Príkazový riadok (ppdf.exe)

Konzolový program ppdf.exe je v rovnakom priečinku ako AccessiblePDF.exe. Čaká na dokončenie a vypisuje výsledok do konzoly; voľba --json vypíše strojovo čitateľný JSON. Starší zápis AccessiblePDF.exe --cli … funguje ďalej.

ppdf export SÚBOR alebo PRIEČINOK… [voľby]       (export netreba písať)
ppdf kontrola SÚBOR.pdf [--ua 1|2] [--pdfa …]   kontrola PDF bez úprav
ppdf obrazky SÚBOR.pdf [--vsetky] [--nahlady PRIEČINOK]
ppdf alt SÚBOR.pdf TEXTY.json [-o NOVÝ.pdf]     alternatívne texty do novej kópie
ppdf prostredie                                 nájdené programy a cesty
ppdf formaty                                    podporované formáty
ppdf mcp [--priecinok PRIEČINOK]…               server MCP pre AI asistentov
ppdf ai [--konfiguracia NÁSTROJ] [--uloz-skill] návod pre AI asistentov

Voľby exportu: --ua 1|2, --pdfa 1a|1b|2a|2b|2u|3a|3b|3u|4|4e|4f (pri PDF/A-1 až 3 sa PDF/UA-1 zvolí samo), --wtpdf, --verzia, --konvertor auto|libreoffice|office, -o PRIEČINOK, --pripona, --nazov, --autor, --predmet, --klucove-slova, --jazyk, --predvoleny-jazyk, --prilozit-zdroj, --znackovat-nanovo, --bez-verapdf, --bez-kontrastu, --bez-zaloziek, --bez-jazyka-casti, --bez-spravy, --ponechat-javascript, --prepisat, --json, --json-subor SÚBOR.json, --ticho, --jazyk-rozhrania sk|en. Anglické aliasy: check, images, alt-text, env, formats, --output, --title, --author, --subject, --keywords, --lang, --converter, --attach-source, --no-verapdf. Pomocník: ppdf --help a ppdf PRÍKAZ --help.

Súbor s alternatívnymi textmi: {"12 0": "Stĺpcový graf …", "15 0": null} (null = dekoratívny obrázok); označenia obrázkov vypíše príkaz ppdf obrazky. Návratový kód: 0 bez chýb, 1 chyby prístupnosti alebo nesúlad vo veraPDF, 2 zlyhanie alebo chybné voľby.

AI asistenti a server MCP

AI asistenti s podporou MCP (napríklad OpenAI Codex CLI, Gemini CLI, GitHub Copilot vo VS Code alebo Cursor) môžu program používať dvoma spôsobmi:

• Príkazový riadok s JSON: asistent spustí ppdf … --json. Návod pre asistenta vypíše ppdf ai; príkaz ppdf ai --uloz-skill PRIEČINOK ho uloží ako skill (SKILL.md) do priečinka skillov vášho asistenta (existujúci súbor neprepíše).
• Server MCP (Model Context Protocol): ppdf mcp --priecinok PRIEČINOK sprístupní nástroje export_accessible_pdf, check_pdf, list_images (aj s náhľadmi obrázkov, aby asistent navrhol alternatívne texty), set_alt_texts, get_environment a list_formats.

Nastavenie pre jednotlivé nástroje vypíše ppdf ai --konfiguracia codex (prípadne gemini, vscode, cursor); ppdf ai --konfiguracia json vypíše všeobecné nastavenie, ktoré používa väčšina klientov MCP:

{
  "mcpServers": {
    "accessible-pdf": {
      "command": "C:\\Programy\\AccessiblePDF\\ppdf.exe",
      "args": ["mcp", "--priecinok", "C:\\Users\\meno\\Documents"]
    }
  }
}

Bezpečnosť servera: číta a zapisuje len v povolených priečinkoch (--priecinok, viackrát; bez neho aktuálny priečinok, ak nie je systémový), nepovoľuje sieťové cesty (--povolit-sietove-cesty ich povolí), zariadenia ani alternatívne prúdy súborov, nikdy neprepíše existujúci súbor a JavaScript z PDF odstraňuje vždy. Text z dokumentov odovzdáva ako údaje, nie ako pokyny. Alternatívne texty, ktoré navrhne AI, overte.

Prístupnosť programu

Program je navrhnutý v súlade s WCAG 2.2 úrovne AAA a EN 301 549 V4.1.1 (kapitola 11 pre softvér vrátane 11.8 pre nástroje na tvorbu obsahu a kapitola 12 pre dokumentáciu):

• natívne ovládacie prvky Windows, ktoré poznajú čítače obrazovky NVDA, JAWS a Moderátor; každé pole má popis (11.5 Interoperabilita s asistenčnými technológiami),
• celé ovládanie klávesnicou bez výnimky; klávesové skratky sa dajú zmeniť aj vypnúť (WCAG 2.1.3, 2.1.4),
• stavové správy čítač obrazovky oznámi bez presunu zamerania (4.1.3); oznamy počas exportu a presun zamerania po exporte sa dajú vypnúť (2.2.4 Prerušenia, 3.2.5 Zmena na požiadanie),
• systémové farby vrátane vysokého kontrastu, systémové písmo, veľkosť textu a zväčšenie obrazovky (11.7 Používateľské nastavenia); okno sa dá zmenšiť a zväčšiť, text sa zalamuje a obsah sa posúva zvisle,
• tlačidlá majú veľkosť aspoň 44 × 44 bodov (2.5.5 Veľkosť cieľa),
• kontextový pomocník F1 a pomocník v ponuke vrátane vysvetlenia pojmov a skratiek (3.3.5 Pomoc, 3.1.3, 3.1.4),
• bez časových limitov a bez blikania; export sa dá zrušiť a nič sa neprepíše (3.3.6 Prevencia chýb),
• program ako nástroj na tvorbu obsahu vytvára prístupné PDF, zachováva informácie o prístupnosti zo zdroja a ku každému problému uvádza návrh opravy (11.8.2, 11.8.3, 11.8.4),
• správa o prístupnosti a tento návod spĺňajú WCAG 2.2 úrovne AAA (12.1.2 Prístupná dokumentácia); prístupnostné funkcie opisuje táto kapitola (12.1.1).

Známe obmedzenia: náhľad obrázka v okne Alternatívne texty je len vizuálny (čítač obrazovky ohlási jeho číslo a stranu, text v obrázku je v samostatnom poli); automatické značkovanie PDF bez značiek vyžaduje ručnú kontrolu. Problém s prístupnosťou programu oznámte autorovi.

Pojmy a skratky

PDF

Portable Document Format – formát dokumentu (ISO 32000), ktorý vyzerá rovnako na každom zariadení.

PDF/UA-1, PDF/UA-2

PDF Universal Accessibility – normy prístupného PDF (ISO 14289-1, ISO 14289-2:2024).

PDF/A

PDF Archive – normy na dlhodobú archiváciu (ISO 19005); úrovne a, b, u, e, f.

WTPDF

Well-Tagged PDF – špecifikácia PDF Association pre dobre označené PDF 2.0.

WCAG 2.2

Web Content Accessibility Guidelines – pravidlá prístupnosti obsahu od W3C; úrovne A, AA, AAA.

EN 301 549

európska norma požiadaviek na prístupnosť produktov a služieb informačných a komunikačných technológií (V4.1.1).

MIRRI

Ministerstvo investícií, regionálneho rozvoja a informatizácie SR; jeho metodické usmernenie obsahuje slovenské názvy kritérií WCAG.

Značky (tagy)

štruktúra PDF, ktorá čítaču obrazovky povie, čo je nadpis, odsek, zoznam, tabuľka alebo obrázok.

Alternatívny text

krátky opis obrázka alebo vzorca, ktorý čítač obrazovky prečíta namiesto obrázka.

Artefakt

obsah bez významu (čiara, číslo strany, hlavička), ktorý čítač obrazovky preskočí.

Čítač obrazovky

program, ktorý číta obsah obrazovky hlasom alebo na Braillovom riadku (NVDA, JAWS, Moderátor).

veraPDF

nezávislý overovací nástroj súladu s PDF/A, PDF/UA a WTPDF.

PAC

PDF Accessibility Checker – nástroj na ručnú kontrolu prístupnosti PDF.

OOXML, ODF

formáty Office Open XML (.docx, .xlsx, .pptx) a OpenDocument (.odt, .ods, .odp).

HTML, MHT, Markdown

webová stránka, webový archív a textový zápis dokumentu so značkami.

RTF, TXT, CSV

formát Rich Text, obyčajný text a tabuľka s hodnotami oddelenými čiarkou alebo bodkočiarkou.

XMP

Extensible Metadata Platform – metadáta dokumentu.

ICC, sRGB, CMYK

farebné profily a modely (sRGB pre obrazovku, CMYK pre tlač).

MathML

Mathematical Markup Language – zápis vzorcov, ktorý vedia čítať čítače obrazovky.

OCR

optické rozpoznávanie znakov; program ho nerobí.

Makro, VBA

program v dokumente (Visual Basic for Applications); pri exporte sa nespustí.

JavaScript

programovací jazyk, ktorým PDF môže spúšťať skripty.

NTLM, UNC

prihlasovanie Windows a sieťová cesta \\server\zdieľanie; cez podstrčenú sieťovú cestu by mohli uniknúť prihlasovacie údaje, preto ich program nepoužíva.

XXE

útok cez externé entity XML; program XML číta bez nich.

SHA-256

kontrolný súčet súboru.

CLI

príkazový riadok (ppdf.exe).

JSON

strojovo čitateľný textový formát výsledkov.

MCP

Model Context Protocol – rozhranie, cez ktoré AI asistenti používajú nástroje programu.

AI

umelá inteligencia.

AGPL

GNU Affero General Public License – licencia programu.

Riešenie problémov

LibreOffice ani Microsoft Office sa nenašli

Nainštalujte jeden z nich alebo zadajte cestu k soffice.exe v Predvoľbách. Súbory PDF sa spracujú aj bez nich.

Microsoft Office zobrazil okno a export sa ukončil

Office čakal na odpoveď (aktivácia produktu, oprava dokumentu). Otvorte dokument v Office ručne, okno vyriešte a export zopakujte, alebo zvoľte prevod cez LibreOffice.

Iný vzhľad ako vo Worde

LibreOffice môže zalomiť riadky a strany inak; zvoľte prevod cez Microsoft Office.

Obrázok prepojený na internet chýba

Prepojené obrázky sa z bezpečnostných dôvodov nenačítajú; vložte ich do dokumentu priamo.

PDF/A-4f hlási chýbajúcu prílohu

Zapnite Priložiť pôvodný dokument alebo zvoľte PDF/A-4.

Formulár nie je vyplniteľný

Použite prevod cez LibreOffice a ovládacie prvky obsahu namiesto starých polí.

Písmo nie je vložené

Štandardné písma program nahradí; iné nevložené písmo treba vložiť v programe, v ktorom PDF vzniklo.

veraPDF hlási chybu

Pravidlá a ich popis sú v správe; najčastejšie chýba alternatívny text obrázka.

Záznam programu

Podrobnosti o chybách sú v %LOCALAPPDATA%\AccessiblePDF\accessible-pdf.log (v prenosnej verzii v priečinku Data vedľa programu).

Našli ste chybu alebo máte návrh na zlepšenie?

Pridajte hlásenie (issue) na GitHube alebo v ponuke Pomocník > Nahlásiť chybu. Uveďte verziu programu, postup, ktorým chyba vznikla, a čo ste očakávali; ak môžete, priložte vzorový dokument bez osobných údajov.

Licencia a autor

Autor programu: Radoslav Ďurač. © 2026 Radoslav Ďurač.

Program je otvorený softvér pod licenciou GNU Affero General Public License verzie 3 alebo novšej (AGPL-3.0-or-later). Môžete ho používať, šíriť a upravovať. Dodatočná podmienka (článok 7 písm. b a c licencie): každá kópia a upravená verzia musí zachovať uvedenie autora „Radoslav Ďurač“ v informáciách o programe, dokumentácii, vlastnostiach súboru programu a v poznámkach o autorských právach v zdrojovom kóde; upravená verzia musí byť označená ako upravená. Pri šírení treba sprístupniť zdrojový kód. Úplný text je v súboroch LICENSE a NOTICE.md a v ponuke Pomocník > Licencia.

Zdrojový kód je na GitHube (rraddatch/accessible-pdf), autor na github.com/rraddatch. Opravy a vylepšenia sú vítané ako pull request; postup je v súbore CONTRIBUTING.md v repozitári.

Celý program je pod licenciou AGPL, lebo používa knižnicu PyMuPDF (GNU AGPL 3.0, Artifex). Ďalšie súčasti: pikepdf (MPL 2.0) s qpdf (Apache 2.0), wxPython (wxWindows Library Licence), lxml (BSD), pywin32 a Python (PSF). LibreOffice (MPL 2.0), Microsoft Office a veraPDF (GPL 3 / MPL 2.0) sa inštalujú samostatne. Náhradné písma Windows sa vkladajú len vtedy, ak to ich licencia dovoľuje.