# Inštalácia na macOS ## Hardvérové požiadavky Weblate by mal bez problémov bežať na akomkoľvek súčasnom hardvéri, nasledujúca je minimálna konfigurácia potrebná na spustenie Weblate na jednom hostiteľovi (Weblate, databáza a webový server): * 3 GB RAM * 2 jadrá CPU * 1 GB úložného priestoru #### NOTE Skutočné požiadavky pre vašu inštaláciu Weblate sa výrazne líšia v závislosti od veľkosti prekladov v nej spravovaných. ### Využitie pamäte Čím viac pamäte, tým lepšie - používa sa na cacheovanie na všetkých úrovniach (súborový systém, databáza a Weblate). Pre stovky prekladových komponentov sa odporúča aspoň 4 GB RAM. #### HINT Pre systémy s menším množstvom pamäte, než sa odporúča, sa odporúča [Nastavenie Celery s jedným procesom](https://docs.weblate.org/sk/latest/admin/install.md#minimal-celery). ### Využitie CPU Veľa súbežných používateľov zvyšuje počet potrebných jadier CPU. Weblate 2026.8 zaviedol NumPy ako povinnú závislosť. Na systémoch x86-64 vyžaduje optimalizovaný build NumPy pribalený v obraze Docker CPU kompatibilné s x86-64-v2. Bez požadovaných funkcií CPU sa NumPy nepodarí načítať a Weblate sa nespustí. Pred aktualizáciou skontrolujte požadovanú funkciu CPU SSE4.2 na Linux systéme spúšťajúcom Docker: ```sh grep sse4_2 /proc/cpuinfo ``` Prázdny výstup indikuje, že požadovaná funkcia CPU nie je dostupná. Toto je predbežná kontrola; nájdenie SSE4.2 neoveruje všetky funkcie CPU x86-64-v2. Ak Docker beží vo virtuálnom stroji, spustite kontrolu vnútri hosťa. Virtuálne stroje môžu skrývať funkcie CPU podporované hostiteľom. Nakonfigurujte virtuálny stroj tak, aby vystavoval požadované funkcie CPU hostiteľa, potom reštartujte hosťa. Ak fyzický CPU nemá požadované funkcie, povyšte hardvér. ### Využitie úložiska Typické využitie úložiska databázy je okolo 300 MB na 1 milión hosťovaných slov. Potrebný úložný priestor pre klonované repozitáre sa líši, ale Weblate sa snaží udržiavať ich veľkosť minimálnu pomocou plytkých klonov. ### Výkon úložiska Operácie správy verzií vykonávajú množstvo vyhľadávaní metadátových súborov. Podadresár `vcs` v [`DATA_DIR`](https://docs.weblate.org/sk/latest/admin/config.md#std-setting-DATA_DIR) preto potrebuje nízku latenciu čítania; úložisko s pomalým prístupom k metadátam môže spôsobiť, že operácie ako **git status** budú trvať dlho, aj keď je jeho priepustnosť pre hromadné dáta dobrá. Ak je to možné, uchovávajte [`CACHE_DIR`](https://docs.weblate.org/sk/latest/admin/config.md#std-setting-CACHE_DIR) na lokálnom alebo dočasnom úložisku s nízkou latenciou. Kontroly nasadenia merajú latenciu vyhľadávania metadát pre obe umiestnenia a varujú, ak medián latencie presiahne 10 milisekúnd. Ide o približné meranie v danom časovom bode ovplyvnené záťažou súborového systému a systému. Pred zmenou konfigurácie úložiska znova spustite **weblate check --deploy**. ### Uzly Pre malé a stredne veľké stránky (milióny hosťovaných slov) môžu byť všetky komponenty Weblate (pozrite [Prehľad architektúry](https://docs.weblate.org/sk/latest/admin/install.md#architecture)) spustené na jednom uzle. Keď narastiete na stovky miliónov hosťovaných slov, odporúča sa mať vyhradený uzol pre databázu (pozrite [Nastavenie databázy pre Weblate](https://docs.weblate.org/sk/latest/admin/install.md#database-setup)). ## Inštalácia ### Systémové požiadavky Nainštalujte závislosti potrebné na zostavenie Python modulov (pozrite [Softvérové požiadavky](https://docs.weblate.org/sk/latest/admin/install.md#requirements)): ```sh # Use Python 3.14 until all dependencies support Python 3.15. brew install python@3.14 libyaml pkgconf zstd lz4 xxhash libxmlsec1 uv export UV_PYTHON="$(brew --prefix python@3.14)/bin/python3.14" ``` Voliteľne nainštalujte softvér na spúšťanie produkčného servera, pozrite [Spúšťanie servera](https://docs.weblate.org/sk/latest/admin/install.md#server), [Nastavenie databázy pre Weblate](https://docs.weblate.org/sk/latest/admin/install.md#database-setup), [Úlohy na pozadí pomocou Celery](https://docs.weblate.org/sk/latest/admin/install.md#celery). V závislosti od veľkosti vašej inštalácie môžete chcieť spustiť tieto komponenty na vyhradených serveroch. Lokálne inštalačné inštrukcie: ```sh # Web server option 1: NGINX and uWSGI brew install nginx uwsgi # Web server option 2: Apache with ``mod_wsgi`` brew install httpd # Caching backend: Valkey brew install valkey # Database server: PostgreSQL brew install postgresql # Gettext tools for gettext POT/PO update add-ons brew install gettext ``` ### Python moduly #### HINT Inštalujeme Weblate v samostatnom Python prostredí. 1. Vytvorte Python prostredie pre Weblate: ```sh uv venv ~/weblate-env ``` 2. Aktivujte Python prostredie pre Weblate: ```sh . ~/weblate-env/bin/activate ``` 3. Nainštalujte Weblate vrátane všetkých voliteľných závislostí: ```sh # Install Weblate with all optional dependencies uv pip install "weblate[all]" ``` Prosím, skontrolujte [Závislosti Pythonu](https://docs.weblate.org/sk/latest/admin/install.md#python-deps) pre jemné doladenie voliteľných závislostí. #### SEE ALSO * [Používanie Python prostredí](https://docs.astral.sh/uv/pip/environments/) * [Riešenie problémov s inštaláciou pip](https://docs.weblate.org/sk/latest/admin/install.md#troubleshoot-pip-install) ### Konfigurácia Weblate #### NOTE Nasledujúce predpokladá, že Python prostredie používané Weblate je aktivované (vykonaním `. ~/weblate-env/bin/activate`). Ak nie, špecifikujte celú cestu k príkazu **weblate** ako `~/weblate-env/bin/weblate`. 1. Skopírujte súbor `~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py` do `~/weblate-env/lib/python3.9/site-packages/weblate/settings.py`. 2. Upravte hodnoty v novom súbore `settings.py` podľa svojich preferencií. Budete musieť poskytnúť aspoň prihlasovacie údaje k databáze a tajný kľúč Django, ale pre produkčné nastavenie budete chcieť viac zmien, pozrite [Úprava konfigurácie](https://docs.weblate.org/sk/latest/admin/install.md#configuration). 3. Vytvorte databázu a jej štruktúru pre Weblate (príkladové nastavenia používajú PostgreSQL, skontrolujte [Nastavenie databázy pre Weblate](https://docs.weblate.org/sk/latest/admin/install.md#database-setup) pre produkčne pripravené nastavenie): ```sh weblate migrate ``` #### SEE ALSO [`migrate`](https://docs.weblate.org/sk/latest/admin/management.md#weblate-admin-migrate) 4. Vytvorte administrátorský účet `admin`, vygenerujte jeho heslo a skopírujte ho do schránky; nezabudnite si ho uložiť na neskoršie použitie: ```sh weblate createadmin ``` #### HINT Ak ste predtým prehliadli/stratili administrátorské heslo, môžete vygenerovať nové pomocou nasledujúceho príkazu: ```sh weblate createadmin --update ``` #### SEE ALSO [`createadmin`](https://docs.weblate.org/sk/latest/admin/management.md#weblate-admin-createadmin) 5. Zhromaždite statické súbory pre váš webový server (pozrite [Spúšťanie servera](https://docs.weblate.org/sk/latest/admin/install.md#server) a [Obsluha statických súborov](https://docs.weblate.org/sk/latest/admin/install.md#static-files)): ```sh weblate collectstatic ``` 6. Spustite pracovníkov Celery. Toto nie je potrebné pre vývojárske účely, ale inak sa dôrazne odporúča. [Úlohy na pozadí pomocou Celery](https://docs.weblate.org/sk/latest/admin/install.md#celery) obsahuje viac informácií: ```sh celery --app=weblate.utils worker --beat \ --queues=celery,notify,memory,translate,backup \ --prefetch-multiplier=1 ``` 7. Spustite vývojársky server ([Spúšťanie servera](https://docs.weblate.org/sk/latest/admin/install.md#server) podrobne popisuje produkčné nastavenie): ```sh weblate runserver ``` ## Po inštalácii Gratulujeme, váš server Weblate je teraz spustený a môžete ho začať používať. * Teraz môžete pristupovať k Weblate na `http://localhost:8000/`. * Prihláste sa s administrátorskými údajmi získanými počas inštalácie alebo zaregistrujte nových používateľov. * Teraz môžete spúšťať príkazy Weblate pomocou príkazu **weblate**, keď je aktívne Python prostredie Weblate, pozrite [Manažérske príkazy](https://docs.weblate.org/sk/latest/admin/management.md#manage). * Testovací server môžete zastaviť pomocou `Ctrl`+`C`. * Skontrolujte potenciálne problémy s vašou inštaláciou buď na URL `/manage/performance/` (pozrite [Výkonnostná správa](https://docs.weblate.org/sk/latest/admin/admin.md#manage-performance)) alebo pomocou **weblate check --deploy**, pozrite [Produkčné nastavenie](https://docs.weblate.org/sk/latest/admin/install.md#production). ### Pridanie prekladu 1. Otvorte administrátorské rozhranie (`http://localhost:8000/create/project/`) a vytvorte projekt, ktorý chcete prekladať. Viac podrobností nájdete v [Konfigurácia projektu](https://docs.weblate.org/sk/latest/admin/projects.md#project). Všetko, čo tu musíte špecifikovať, je názov projektu a jeho webstránka. 2. Vytvorte komponent, ktorý je skutočným objektom na preklad - ukazuje na repozitár VCS a vyberá, ktoré súbory prekladať. Viac podrobností nájdete v [Konfigurácia komponentu](https://docs.weblate.org/sk/latest/admin/projects.md#component). Dôležité polia tu sú: [Názov komponentu](https://docs.weblate.org/sk/latest/admin/projects.md#component-name), [Repozitár zdrojového kódu](https://docs.weblate.org/sk/latest/admin/projects.md#component-repo) a [Maska súboru](https://docs.weblate.org/sk/latest/admin/projects.md#component-filemask) na nájdenie preložiteľných súborov. Weblate podporuje širokú škálu formátov vrátane [GNU gettext PO (Portable Object)](https://docs.weblate.org/sk/latest/formats/gettext.md#gettext), [Zdroje reťazcov pre Android](https://docs.weblate.org/sk/latest/formats/android.md#aresource), [Reťazce Apple iOS](https://docs.weblate.org/sk/latest/formats/apple.md#apple), [Vlastnosti Java](https://docs.weblate.org/sk/latest/formats/java.md#javaprop), [Formát Stringsdict](https://docs.weblate.org/sk/latest/formats/stringsdict.md#stringsdict) alebo [Formát Fluent](https://docs.weblate.org/sk/latest/formats/fluent.md#fluent), viac podrobností nájdete v [Formáty lokalizačných súborov](https://docs.weblate.org/sk/latest/formats.md#formats). 3. Po dokončení vyššie uvedeného (môže to byť zdĺhavý proces v závislosti od veľkosti vášho VCS repozitára a počtu správ na preklad) môžete začať prekladať.