# Nasadenie na Hostinger [Hostinger](https://hostinger.com) je obľúbený poskytovateľ zdieľaného hostingu. Tento návod popisuje nasadenie BentoPDF na zdieľaný hosting Hostinger. ## Predpoklady - Hostingový plán Hostinger s prístupom k správcovi súborov - Lokálne nainštalovaný Node.js na zostavenie ## Krok 1: Zostavenie projektu ```bash git clone https://github.com/alam00000/bentopdf.git cd bentopdf npm install npm run build ``` Zostavené súbory budú v priečinku `dist`. ## Krok 2: Nahranie na Hostinger ### Nasadenie na koreňovú doménu 1. Prihláste sa do svojho účtu Hostinger 2. Prejdite do **File Manager** → **public_html** 3. **Odstráňte** existujúce súbory (v prípade potreby si ich zálohujte) 4. **Nahrajte** celý obsah lokálneho priečinka `dist` do `public_html` ### Nasadenie do podadresára Pri nasadení do podadresára (napr. `yourdomain.com/pdf-tools/`): 1. Zostavte so správnou základnou URL: ```bash BASE_URL=/pdf-tools/ npm run build ``` 2. Vytvorte priečinok v Hostinger: - Prejdite do **File Manager** → **public_html** - Vytvorte nový priečinok: `pdf-tools` 3. Nahrajte celý obsah `dist` do `public_html/pdf-tools/` ## Krok 3: Vytvorenie súboru .htaccess Vytvorte súbor `.htaccess` v koreni priečinka nasadenia (`public_html` alebo `public_html/pdf-tools/`): ::: warning Dôležité Pri nasadení do podadresára zmeňte `RewriteBase /` na `RewriteBase /pdf-tools/` (alebo názov vášho priečinka). ::: ```apache RewriteEngine On RewriteBase / # ============================================ # 1. SECURITY HEADERS (CRITICAL FOR WASM) # ============================================ Header always set X-Frame-Options "SAMEORIGIN" Header always set X-Content-Type-Options "nosniff" Header always set X-XSS-Protection "1; mode=block" Header always set Referrer-Policy "strict-origin-when-cross-origin" Header always set Permissions-Policy "geolocation=(), microphone=(), camera=()" # REQUIRED for soffice.js (SharedArrayBuffer) Header always set Cross-Origin-Opener-Policy "same-origin" Header always set Cross-Origin-Embedder-Policy "require-corp" # ============================================ # 2. BROWSER CACHING # ============================================ ExpiresActive On ExpiresByType image/jpeg "access plus 1 year" ExpiresByType image/png "access plus 1 year" ExpiresByType image/gif "access plus 1 year" ExpiresByType image/webp "access plus 1 year" ExpiresByType image/svg+xml "access plus 1 year" ExpiresByType image/x-icon "access plus 1 year" ExpiresByType font/woff2 "access plus 1 year" ExpiresByType font/woff "access plus 1 year" ExpiresByType font/ttf "access plus 1 year" ExpiresByType text/css "access plus 1 month" ExpiresByType application/javascript "access plus 1 month" ExpiresByType application/wasm "access plus 1 year" ExpiresByType application/gzip "access plus 1 year" ExpiresByType text/html "access plus 0 seconds" # ============================================ # 3. COMPRESSION (STANDARD) # ============================================ # Prevent server from double-compressing files SetEnvIfNoCase Request_URI "\.gz$" no-gzip SetEnvIfNoCase Request_URI "\.br$" no-gzip SetEnvIfNoCase Request_URI "\.wasm$" no-gzip AddOutputFilterByType DEFLATE text/plain AddOutputFilterByType DEFLATE text/html AddOutputFilterByType DEFLATE text/xml AddOutputFilterByType DEFLATE text/css AddOutputFilterByType DEFLATE application/xml AddOutputFilterByType DEFLATE application/xhtml+xml AddOutputFilterByType DEFLATE application/rss+xml AddOutputFilterByType DEFLATE application/javascript AddOutputFilterByType DEFLATE application/x-javascript AddOutputFilterByType DEFLATE application/json AddOutputFilterByType DEFLATE image/svg+xml AddOutputFilterByType DEFLATE font/woff AddOutputFilterByType DEFLATE font/ttf # ============================================ # 4. MIME TYPES & SPECIAL FILE HANDLING # ============================================ AddType application/javascript .js .mjs AddType application/wasm .wasm AddType font/woff2 .woff2 AddType font/woff .woff AddType image/webp .webp # Handle soffice.wasm.gz correctly ForceType application/wasm Header set Content-Encoding "gzip" Header set Cross-Origin-Resource-Policy "cross-origin" Header append Vary Accept-Encoding # Handle data.gz ForceType application/octet-stream Header set Content-Encoding "gzip" Header append Vary Accept-Encoding # ============================================ # 5. REDIRECTS & ROUTING # ============================================ # Canonical WWW (update domain as needed) RewriteCond %{HTTP_HOST} ^bentopdf\.com [NC] RewriteRule ^(.*)$ https://www.bentopdf.com/$1 [L,R=301] # Force HTTPS RewriteCond %{HTTPS} off RewriteRule ^(.*)$ https://%{HTTP_HOST}%{REQUEST_URI} [L,R=301] # Remove trailing slash (except for language root directories) RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_URI} !^/(de|es|zh|zh-TW|vi|it|id|tr|fr|pt)/$ RewriteCond %{REQUEST_URI} (.+)/$ RewriteRule ^ %1 [R=301,L] # Existing files/dirs - serve directly RewriteCond %{REQUEST_FILENAME} -f [OR] RewriteCond %{REQUEST_FILENAME} -d RewriteRule ^ - [L] # ============================================ # 5.1. LANGUAGE ROUTES # ============================================ # Supported languages: de, es, zh, zh-TW, vi, it, id, tr, fr, pt # English has no prefix - served from root # English prefix redirects to root (for SEO consistency) RewriteRule ^en/?$ / [R=301,L] RewriteRule ^en/(.+)$ /$1 [R=301,L] # Language prefix root (e.g., /de/ -> /de/index.html) RewriteCond %{DOCUMENT_ROOT}/$1/index.html -f RewriteRule ^(de|es|zh|zh-TW|vi|it|id|tr|fr|pt)/?$ /$1/index.html [L] # Language prefix with path (e.g., /de/merge-pdf -> /de/merge-pdf.html) RewriteCond %{DOCUMENT_ROOT}/$1/$2.html -f RewriteRule ^(de|es|zh|zh-TW|vi|it|id|tr|fr|pt)/([^/]+)/?$ /$1/$2.html [L] # ============================================ # 5.5. DOCS ROUTING (VitePress) # ============================================ RewriteCond %{REQUEST_URI} ^/docs RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME}\.html -f RewriteRule ^(.*)$ $1.html [L] # ============================================ # 6. ADD .HTML EXTENSION IF FILE EXISTS (ROOT LEVEL ONLY) # ============================================ RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME}.html -f RewriteRule ^([^/]+)$ $1.html [L] # ============================================ # 7. ERROR PAGES # ============================================ ErrorDocument 404 /404.html ``` ## Príklad .htaccess pre podadresár Pre `yourdomain.com/pdf-tools/` upravte tieto riadky: ```apache RewriteBase /pdf-tools/ # ... (same content as above, but update paths) ... # Language prefix root RewriteCond %{DOCUMENT_ROOT}/pdf-tools/$1/index.html -f RewriteRule ^(de|es|zh|zh-TW|vi|it|id|tr|fr|pt)/?$ /pdf-tools/$1/index.html [L] # Language prefix with path RewriteCond %{DOCUMENT_ROOT}/pdf-tools/$1/$2.html -f RewriteRule ^(de|es|zh|zh-TW|vi|it|id|tr|fr|pt)/([^/]+)/?$ /pdf-tools/$1/$2.html [L] # Root level .html extension RewriteCond %{REQUEST_FILENAME} !-f RewriteCond %{REQUEST_FILENAME} !-d RewriteCond %{REQUEST_FILENAME}.html -f RewriteRule ^([^/]+)$ $1.html [L] ErrorDocument 404 /pdf-tools/404.html ``` ## Riešenie problémov ### Súbory WASM sa nenačítajú Uistite sa, že MIME typy sú v `.htaccess` správne nastavené: ```apache AddType application/wasm .wasm ``` ### Nástroje LibreOffice nefungujú Bezpečnostné hlavičky sú pre SharedArrayBuffer kľúčové: ```apache Header always set Cross-Origin-Opener-Policy "same-origin" Header always set Cross-Origin-Embedder-Policy "require-corp" ``` Ak sa hlavičky neuplatňujú, požiadajte podporu Hostinger o zapnutie `mod_headers`. ### Chyby 404 pri obnovení stránky Uistite sa, že pravidlo pre príponu `.html` a jazykové trasy sú správne nastavené. BentoPDF používa statické HTML súbory, nie smerovanie SPA: ```apache # Language routes serve actual files from language directories RewriteCond %{DOCUMENT_ROOT}/$1/$2.html -f RewriteRule ^(de|es|zh|zh-TW|vi|it|id|tr|fr|pt)/([^/]+)/?$ /$1/$2.html [L] # Root level pages RewriteCond %{REQUEST_FILENAME}.html -f RewriteRule ^([^/]+)$ $1.html [L] ``` ### Limity nahrávania súborov Hostinger môže mať limity veľkosti súborov. Ak hromadné nahrávanie zlyhá, nahrajte súbory WASM samostatne.