Instal·lació des de fonts

  1. Si us plau, seguiu les instruccions d’instal·lació del vostre sistema abans d’instal·lar Weblate:

  2. Agafeu les últimes fonts de Weblate amb Git (o descarregueu un fitxer tarball i desempaqueteu-lo):

    git clone https://github.com/WeblateOrg/weblate.git weblate-src

    Alternatively you can use released archives. You can download them from our website <https://weblate.org/>. Those downloads are cryptographically signed, please see Verifying release artifacts.

  3. Instal·leu el codi Weblate actual a l’entorn Python:

    . ~/weblate-env/bin/activate
uv pip install -e 'weblate-src[all]'

    Si teniu intenció d’executar el testsuite des de la comprovació d’origen, instal·leu les dependències de desenvolupament tal com es descriu a Local testing of Weblate.

  4. Copieu weblate/settings_example.py a weblate/settings.py.

  5. Adjust the values in the new settings.py file to your liking. You will need to provide at least the database credentials and Django secret key, but you will want more changes for production setup, see Ajust de configuració.

  6. Creeu la base de dades utilitzada per Weblate, vegeu Configuració de la base de dades per a Weblate.

  7. Creeu taules Django, fitxers estàtics i dades inicials (vegeu Omplint la base de dades i Donant arxius estàtics):

    weblate migrate
weblate collectstatic

    Nota

    Aquest pas s’ha de repetir sempre que actualitzeu el repositori.

Packaging Weblate for distributions

The dependency versions in pyproject.toml describe the runtime environment tested by the Weblate project. They are intentionally strict for installs from PyPI and for the Weblate release process, because Weblate cannot validate every dependency-version combination covered by wider version ranges.

Distribution packages can replace those Python packages with versions from the distribution package set. When doing so, run Weblate’s test suite against the packaged dependency set and treat passing tests as the compatibility signal for the distribution package.

Keep Weblate’s tightly coupled companion packages in sync with the Weblate release:

Mismatched versions of these packages are more likely to break at runtime or during tests than other Python dependency substitutions.

Vegeu també

See Local testing of Weblate for test setup and Release cycle for Weblate’s release cadence.