Përmbajtje

Raporti tekst–HTML

Sa përqind e bajteve të faqes janë tekst i dukshëm; tregues i përafërt i fryrjes së shabllonit.

Çfarë është

Raporti tekst–HTML është gjatësia e tekstit të dukshëm pjesëtuar me gjatësinë e plotë të dokumentit HTML, shprehur në përqindje.

Një faqe me 5% raport ka njëzet herë më shumë kod sesa tekst. Kjo ndodh kur shablloni prodhon shtresa të panevojshme <div>, kur CSS-ja dhe JavaScript-i janë futur brenda dokumentit, ose kur një ndërtues faqesh shton atribute në çdo element.

Ky nuk është faktor renditjeje dhe asnjë motor nuk ka thënë ndonjëherë se e mat. Është tregues diagnostikues: një numër shumë i ulët zakonisht do të thotë se diçka tjetër nuk shkon.

Pse ka rëndësi

Kur raporti është shumë i ulët, zakonisht një nga tri gjërat është e vërtetë. Ose faqja ka pak përmbajtje — dhe atëherë problemi është përmbajtja, jo raporti. Ose HTML-ja është e fryrë nga kod i panevojshëm — dhe atëherë faqja shkarkohet më ngadalë dhe renderohet më vonë. Ose teksti ndërtohet me JavaScript dhe nuk gjendet fare në dokumentin fillestar — rasti më i rëndë, sepse çdo mjet që lexon vetëm HTML-në e sheh faqen bosh.

Peshë e tepërt në HTML ka kosto reale në lidhje të ngadalta: çdo kilobajt shtesë është kohë shtesë para se teksti i parë të shfaqet.

Anasjelltas, një raport i lartë nuk është qëllim në vetvete. Një faqe me tekst të thjeshtë pa asnjë strukturë do të kishte raport të shkëlqyer dhe do të ishte faqe e keqe.

Si rregullohet

Nxirr CSS-në dhe JavaScript-in jashtë dokumentit në skedarë të veçantë që ruhen në cache.
Hiq shtresat e panevojshme `<div>`. Shumë shabllone mbështjellin çdo element tri herë pa arsye.
Aktivizo ngjeshjen (gzip ose brotli). Nuk e ndryshon raportin, por e zhduk koston e tij reale.
Kontrollo nëse teksti është në HTML. Hap burimin e faqes me Ctrl+U dhe kërko një fjali nga teksti. Nëse nuk gjendet aty, ajo përmbajtje po ndërtohet nga JavaScript-i.
Mos e ndiq numrin si qëllim. Mos shto tekst për ta ngritur; ndreq shkakun.

Si e mat ky mjet

ContentAnalyzer::calculateTextToHtmlRatio() (services/ContentAnalyzer.php:215) pjesëton gjatësinë e tekstit të nxjerrë me gjatësinë e HTML-së së plotë dhe e shumëzon me 100. checkTextRatio() (:236) e klasifikon: nën 10% (:240, paralajmërim), 10–24% (:243, informativ), 25% e lart (kaluar pa konstatim).

Çfarë NUK e mat

Ka një mospërputhje midis pragut dhe mesazhit: paralajmërimi jepet vetëm nën 10%, por teksti i tij thotë *"Should be above 25%"*. Pra një faqe me 12% merr vetëm një shënim informativ ndonëse mesazhi i vetë mjetit e quan të pamjaftueshme. Kjo mospërputhje është e regjistruar te kontrollet/index.json.

Matja bëhet mbi bajtet e papërpunuara, para ngjeshjes, prandaj nuk pasqyron atë që udhëton vërtet në rrjet. Dhe nuk dallon dot midis tri shkaqeve krejt të ndryshme që japin të njëjtin numër të ulët.

Mospërputhje midis tekstit të analizuesit dhe matjes

Kjo faqe ndjek matjen, jo tekstin që prodhon analizuesi.
Teksti i analizuesit	Çfarë ndodh	Si u mat	Burimi
Low text-to-HTML ratio — Text ratio is X%. Should be above 25%.	Paralajmërimi aktivizohet vetëm nën 10%, ndërsa teksti i tij citon 25%. Vlerat 10–24% marrin vetëm shënim informativ.	Dega e parë te :239 kontrollon `< 10`; mesazhi te :240 thotë 'above 25%'. — `matur gjatë 5.10`	`services/ContentAnalyzer.php:240`

Kodi që e kryen matjen

services/ContentAnalyzer.php:215 — ContentAnalyzer::calculateTextToHtmlRatio
services/ContentAnalyzer.php:236 — ContentAnalyzer::checkTextRatio