Why it matters
- A PDF is often the most important thing on a site: reports, terms, contracts, catalogues. Its text does not reach search or AI assistants if it is reversed, has no map, or is a picture.
- Copy and paste breaks: someone who copies a paragraph gets reversed letters or symbols, and a screen reader cannot read the page.
- The problem comes from how the file was exported, not from its content, so it is fixed by exporting again with the right settings.
How to fix
- From Word: Save as PDF, choose «Best for electronic distribution and accessibility», do not use «Print to PDF», and check that the font is embedded.
- From InDesign: use the Middle Eastern (ME) edition with the World-Ready Paragraph Composer, and export «Adobe PDF (Interactive/Print)» with «Create Tagged PDF» on and the fonts embedded.
- Do not convert text to outlines when exporting.
- From a scan: run Arabic OCR, with Tesseract (
ara), Adobe Acrobat or ABBYY. - Keep fonts embedded with a ToUnicode map (modern programs do it by themselves with OpenType and TrueType fonts).
- After exporting, select a paragraph and paste it into a text file: if it comes out right, the file is sound.
How we detect
- We fetch up to 3 PDFs the page links (15 MB each at most) the way we fetch the page, as ArablyzerBot, after reading the robots.txt of each file's own host; and we open a file only after it starts with
%PDF-. - We read its text with the pdf.js library in an isolated thread with a heap and time limit, the first 20 pages only, running no script.
- Reversed: words from a short list of common Arabic words appear backwards (3 at least and twice as many as the right ones), or three words begin with a ta marbuta, which no Arabic word does.
- Presentation forms: 20% or more of the Arabic letters are in U+FB50–FDFF and U+FE70–FEFF.
- No Unicode map: 5% or more of the characters are in the private-use range (U+E000–F8FF) or replacement characters, or 30% accented Latin letters (U+00C0–00FF) in a file linked from an Arabic page, with no Arabic letters. An estimate that cannot see the font itself.
- Image: half of the pages read, or more, have no text.
- We report each file and each problem, at moderate severity.