Upotreba pravila preusmjeravanja pri migraciji i restrukturiranju web stranica
Tokom migracije web stranice, restrukturiranja strukture URL-ova ili čišćenja starog sadržaja, održavanje kontinuiteta i očuvanje SEO autoriteta su ključni zadaci za svakog webmastera ili programera. Kada se stranice premještaju na nove adrese, preusmjeravanja osiguravaju da posjetitelji i pretraživači ne naiđu na nepostojeće stranice.
Ovaj proces se oslanja na HTTP statusne kodove koji pretraživačima signaliziraju prirodu promjene:
- 301 Trajno (Permanent): Koristi se kada se sadržaj trajno preselio na novu lokaciju. Pretraživači prenose SEO vrijednost (link juice) sa starog URL-a na novi.
- 302 Privremeno (Temporary): Koristi se kada je preusmjeravanje privremeno. Pretraživači zadržavaju indeksiranu izvornu stranicu i ne prenose trajno SEO autoritet na odredišni URL.
Ručno pisanje sintakse za servere kao što su Nginx, Apache ili platforme poput Vercela može biti podložno greškama, posebno kada se radi o stotinama ili hiljadama adresa. Generator pravila preusmjeravanja automatizuje ovaj proces pretvaranjem jednostavne CSV tabele u tačan kod spreman za implementaciju na serveru.
Priprema i formatiranje CSV datoteke
Da bi generator uspješno obradio podatke, ulazna CSV datoteka mora biti pravilno formatirana. Datoteka mora sadržavati tačno definisane kolone i pratiti sljedeća pravila:
- Struktura zaglavlja: Prvi red u datoteci mora biti zaglavlje koje sadrži kolone
sourceitarget(ilidestination). Ako ove kolone nedostaju, sistem prikazuje grešku: Red sa zaglavljem mora sadržavati kolone 'source' i 'target' (ili 'destination'). - Izvorni URL (Source): Može biti potpun HTTP ili HTTPS URL ili putanja koja počinje kosom crtom
/. Hostname (naziv domene) se automatski uklanja iz izvora tokom obrade. - Odredišni URL (Destination/Target): Može biti potpun HTTP ili HTTPS URL ili relativna putanja koja počinje sa
/. - Ograničenja veličine i broja redova: Maksimalna veličina datoteke je ograničena na 5 MB, a alat podržava obradu do 2.000 mapiranja odjednom.
Primjer ispravnog CSV formata
source,target
/stari-artikal,/novi-artikal
https://mojadomena.com/stara-kategorija,https://mojadomena.com/nova-kategorija
/stari-proizvod,https://drugadomena.com/proizvod
Pravila obrade i tehnička ograničenja
Generator primjenjuje stroga pravila validacije kako bi osigurao da generisani kod ne uzrokuje greške na vašem serveru. Tokom analize datoteke primjenjuju se sljedeća pravila:
- Tačno podudaranje (Exact Match): Generisana pravila su striktno vezana za tačnu izvornu putanju. Nginx i Apache izlazi su sidreni (anchored) za tačnu putanju, dok Vercel prima identičnu doslovnu putanju.
- Zabranjeni elementi u izvoru: Izvorni URL-ovi ne smiju sadržavati upitne nizove (query strings), fragmente (sidra sa znakom
#) niti zamjenske znakove (wildcards poput*). Ako se ovi elementi detektuju, alat će odbiti red jer različita serverska okruženja tretiraju ove znakove na nekompatibilne načine. - Duplikati: Svaka izvorna putanja može se pojaviti samo jednom u cijeloj datoteci. Dupliranje iste izvorne putanje rezultira greškom.
- Dužina URL-a: Maksimalna dozvoljena dužina bilo kojeg URL-a u tabeli je 2.048 znakova.
Sintaksa preusmjeravanja prema okruženjima
Zavisno o odabranom okruženju, generator kreira specifičnu sintaksu prilagođenu konfiguraciji servera:
Nginx
Nginx pravila koriste rewrite direktivu sa sidrima ^ i $ kako bi se osiguralo tačno podudaranje putanje, sprečavajući neželjeno preusmjeravanje podstranica koje samo počinju istim nazivom. Na kraju pravila se dodaje permanent za 301 ili redirect za 302 statusni kod.
Apache
Za Apache servere, pravila se generišu u formatu za .htaccess datoteku, koristeći Redirect direktivu. Pravila su konfigurisana tako da se odnose na tačne putanje, koristeći odgovarajući statusni kod (301 ili 302).
Vercel
Vercel koristi JSON konfiguraciju unutar vercel.json datoteke. Standardne Vercel instalacije imaju limit od ukupno 2.048 ruta, zbog čega je ovaj alat ograničen na maksimalno 2.000 mapiranja.
Vercelovo podrazumijevano trajno preusmjeravanje ("permanent": true) vraća HTTP status 308, dok privremeno ("permanent": false) vraća 307. Kako bi se osiguralo da klijent dobije tačan 301 ili 302 statusni kod, generisani izlaz koristi eksplicitni parametar statusCode.
Privatnost i lokalna obrada podataka
Vaša privatnost je u potpunosti zaštićena načinom na koji je ovaj alat tehnički dizajniran. Vaša CSV datoteka i generisana pravila ostaju u vašem pregledniku. Kompletan proces parsiranja, validacije i generisanja koda izvršava se lokalno na vašem uređaju. Ništa se ne šalje na BroBroGo, što znači da vaši interni URL-ovi i struktura stranice nikada ne napuštaju vaš računar.
Česte greške i rješavanje problema
Tokom uvoza i generisanja pravila, sistem može prikazati specifične poruke o greškama ako podaci ne zadovoljavaju tehničke kriterije:
- Nevažeći izvor ili odredište: Ako red sadrži neispravan format, sistem javlja: Red
{line}ima nevažeći izvor. Koristite HTTP(S) URL ili putanju koja počinje sa /. ili Red{line}ima nevažeće odredište. Koristite HTTP(S) URL ili putanju koja počinje sa /. - Prisustvo upitnih nizova: Ako izvor sadrži znak
?ili#, prikazuje se poruka: Red{line}sadrži upitni niz ili fragment u izvoru. Koristite samo izvornu putanju. - Korištenje zamjenskih znakova: Ako pokušate unijeti regularne izraze ili zamjenske znakove, sistem ispisuje: Red
{line}koristi zamjenske znakove ili obrasce ruta. Ovaj generator prihvata samo tačne izvorne putanje. - Nedostajući podaci: Ako je neki red polovičan, pojavit će se poruka: Red
{line}mora sadržavati i izvor i odredište. - Duplirani izvori: U slučaju ponavljanja iste adrese, sistem javlja: Red
{line}ponavlja izvornu putanju{source}. Svaki izvor se može pojaviti samo jednom.
Često postavljana pitanja (FAQ)
Kako trebam formatirati CSV datoteku?
Koristite zaglavlje s kolonama 'source' i 'target' (ili 'destination'). Svaki naredni red može sadržavati potpun HTTP ili HTTPS izvorni URL ili putanju koja počinje sa /, kao i potpuno ili relativno odredište.
Da li su generisana preusmjeravanja tačna podudaranja?
Da. Nginx i Apache izlazi su vezani za tačnu izvornu putanju, a Vercel prima istu doslovnu putanju. Izvorni host se uklanja; izvorni upitni nizovi, fragmenti i zamjenski znakovi (wildcards) se odbijaju jer ih ova tri okruženja tretiraju različito.
Zašto Vercel izlaz koristi statusCode?
Vercelovo trajno preusmjeravanje proizvodi kod 308, a privremeno 307. Koristi se 'statusCode' kako bi vaš izbor ostao tačno 301 ili 302. Standardne Vercel instalacije dozvoljavaju ukupno 2.048 ruta, pa ovaj alat prihvata do 2.000 mapiranja.
Koje je maksimalno ograničenje za broj preusmjeravanja?
Alat može obraditi do 2.000 pojedinačnih mapiranja preusmjeravanja po jednoj CSV datoteci, uz maksimalnu veličinu datoteke do 5 MB.