ການຕິດຕັ້ງເທິງ Debian ແລະ Ubuntu

ຄວາມຕ້ອງການດ້ານຮາດແວ

Weblate ຄວນຈະຮັນໄດ້ເທິງຮາດແວສະໄໝໃໝ່ໂດຍບໍ່ມີບັນຫາ, ຕໍ່ໄປນີ້ແມ່ນການຕັ້ງຄ່າຂັ້ນຕ່ຳທີ່ຈຳເປັນເພື່ອຮັນ Weblate ເທິງໂຮສຕ໌ດຽວ (Weblate, ຖານຂໍ້ມູນ ແລະ ເວັບເຊີບເວີ):

• RAM 3 GB

• 2 CPU cores

• ພື້ນທີ່ຈັດເກັບຂໍ້ມູນ 1 GB

Note

ຄວາມຕ້ອງການທີ່ແທ້ຈິງສຳລັບການຕິດຕັ້ງ Weblate ຂອງທ່ານຈະແຕກຕ່າງກັນຢ່າງຫຼວງຫຼາຍໂດຍອີງໃສ່ຂະໜາດຂອງການແປທີ່ຈັດການຢູ່ພາຍໃນນັ້ນ.

ການໃຊ້ງານໜ່ວຍຄວາມຈຳ

ມີໜ່ວຍຄວາມຈຳຫຼາຍເທົ່າໃດກໍຍິ່ງດີ - ມັນຖືກໃຊ້ສຳລັບການ caching ໃນທຸກລະດັບ (ລະບົບໄຟລ໌, ຖານຂໍ້ມູນ ແລະ Weblate). ສຳລັບສ່ວນປະກອບການແປຫຼາຍຮ້ອຍລາຍການ, ແນະນຳໃຫ້ມີ RAM ຢ່າງໜ້ອຍ 4 GB.

Hint

ສຳລັບລະບົບທີ່ມີໜ່ວຍຄວາມຈຳໜ້ອຍກວ່າທີ່ແນະນຳ, ແນະນຳໃຫ້ໃຊ້ ການຕັ້ງຄ່າ Celery ແບບ Single-process.

ການໃຊ້ງານ CPU

ຜູ້ໃຊ້ຫຼາຍຄົນທີ່ໃຊ້ງານພ້ອມກັນຈະເພີ່ມຈຳນວນ CPU cores ທີ່ຈຳເປັນ.

ການໃຊ້ງານພື້ນທີ່ຈັດເກັບຂໍ້ມູນ

ການໃຊ້ພື້ນທີ່ຈັດເກັບຖານຂໍ້ມູນໂດຍທົ່ວໄປແມ່ນປະມານ 300 MB ຕໍ່ 1 ລ້ານຄຳທີ່ຝາກໄວ້.

ພື້ນທີ່ຈັດເກັບຂໍ້ມູນທີ່ຈຳເປັນສຳລັບ cloned repositories ຈະແຕກຕ່າງກັນ, ແຕ່ Weblate ພະຍາຍາມຮັກສາຂະໜາດຂອງມັນໃຫ້ໜ້ອຍທີ່ສຸດໂດຍການເຮັດ shallow clones.

Nodes

ສຳລັບເວັບໄຊຂະໜາດນ້ອຍ ແລະ ຂະໜາດກາງ (ຫຼາຍລ້ານຄຳທີ່ຝາກໄວ້), ສ່ວນປະກອບທັງໝົດຂອງ Weblate (ເບິ່ງ ພາບລວມຂອງສະຖາປັດຕະຍະກຳ) ສາມາດຮັນເທິງ node ດຽວໄດ້.

ເມື່ອທ່ານເຕີບໂຕໄປເຖິງຫຼາຍຮ້ອຍລ້ານຄຳທີ່ຝາກໄວ້, ແນະນຳໃຫ້ມີ node ສະເພາະສຳລັບຖານຂໍ້ມູນ (ເບິ່ງ ການຕັ້ງຄ່າຖານຂໍ້ມູນສຳລັບ Weblate).

ການຕິດຕັ້ງ

ຄວາມຕ້ອງການຂອງລະບົບ

ຕິດຕັ້ງ dependencies ທີ່ຈຳເປັນເພື່ອ build Python modules (ເບິ່ງ ຄວາມຕ້ອງການດ້ານຊອບແວ):

apt install -y \
   libxml2-dev libxslt-dev libfreetype6-dev libjpeg-dev libz-dev libyaml-dev \
   libffi-dev \
   libacl1-dev liblz4-dev libzstd-dev libxxhash-dev libssl-dev libpq-dev libjpeg-dev build-essential \
   python3-gdbm python3-dev git

ຕິດຕັ້ງທາງເລືອກ dependencies ທີ່ຕ້ອງການໂດຍອີງຕາມຟີເຈີທີ່ທ່ານຕັ້ງໃຈຈະໃຊ້ (ເບິ່ງ Python dependencies):

apt install -y \
   libldap2-dev libldap-common libsasl2-dev \
   libxmlsec1-dev

ທາງເລືອກໃນການຕິດຕັ້ງຊອບແວສຳລັບຮັນເຊີບເວີ production, ເບິ່ງ ການແລ່ນເຊີບເວີ, ການຕັ້ງຄ່າຖານຂໍ້ມູນສຳລັບ Weblate, ວຽກງານເບື້ອງຫຼັງໂດຍໃຊ້ Celery. ຂຶ້ນຢູ່ກັບຂະໜາດຂອງການຕິດຕັ້ງຂອງທ່ານ, ທ່ານອາດຕ້ອງການຮັນສ່ວນປະກອບເຫຼົ່ານີ້ເທິງເຊີບເວີສະເພາະ.

ຄຳແນະນຳການຕິດຕັ້ງໃນທ້ອງຖິ່ນ:

# Web server option 1: NGINX and uWSGI
apt install -y nginx uwsgi uwsgi-plugin-python3

# Web server option 2: Apache with ``mod_wsgi``
apt install -y apache2 libapache2-mod-wsgi-py3

# Caching backend: Valkey
apt install -y valkey-server

# Database server: PostgreSQL
apt install -y postgresql postgresql-contrib

# SMTP server
apt install -y exim4

# Gettext tools for gettext POT/PO update add-ons
apt install -y gettext

uv package manager

Hint

ພວກເຮົາກຳລັງໃຊ້ uv package manager ເພື່ອຕິດຕັ້ງ Weblate.

curl -LsSf https://astral.sh/uv/install.sh | sh

See also

ການຕິດຕັ້ງ uv

Python modules

Hint

ພວກເຮົາກຳລັງຕິດຕັ້ງ Weblate ໃນ Python environment ແຍກຕ່າງຫາກ.

1. ສ້າງ Python environment ສຳລັບ Weblate:

   uv venv ~/weblate-env
   

2. ເປີດໃຊ້ Python environment ສຳລັບ Weblate:

   . ~/weblate-env/bin/activate
   

3. ຕິດຕັ້ງ Weblate ລວມທັງທາງເລືອກ dependencies ທັງໝົດ:

   # Install Weblate with all optional dependencies
   uv pip install "weblate[all]"
   

   ກະລຸນາກວດສອບ Python dependencies ສຳລັບການປັບແຕ່ງລະອຽດຂອງທາງເລືອກ dependencies.

See also

• ການໃຊ້ Python environments

• ການແກ້ໄຂບັນຫາ pip install

ການຕັ້ງຄ່າ Weblate

Note

ຕໍ່ໄປນີ້ສົມມຸດວ່າ Python environment ທີ່ໃຊ້ໂດຍ Weblate ຖືກເປີດໃຊ້ງານຢູ່ (ໂດຍການປະຕິບັດ . ~/weblate-env/bin/activate). ຖ້າບໍ່ແມ່ນ, ໃຫ້ລະບຸເສັ້ນທາງເຕັມໄປຍັງຄຳສັ່ງ weblate ເປັນ ~/weblate-env/bin/weblate.

1. ສຳເນົາໄຟລ໌ ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py ໄປຍັງ ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py.

2. ປັບຄ່າໃນໄຟລ໌ settings.py ໃໝ່ ຕາມທີ່ທ່ານຕ້ອງການ. ທ່ານຈະຕ້ອງລະບຸຢ່າງໜ້ອຍຂໍ້ມູນຢັ້ງຢືນຖານຂໍ້ມູນ ແລະ Django secret key, ແຕ່ທ່ານອາດຈະຕ້ອງການການປ່ຽນແປງເພີ່ມເຕີມສຳລັບການຕັ້ງຄ່າ production, ເບິ່ງ ການປັບແຕ່ງການຕັ້ງຄ່າ.

3. ສ້າງຖານຂໍ້ມູນ ແລະ ໂຄງສ້າງສຳລັບ Weblate (ການຕັ້ງຄ່າຕົວຢ່າງໃຊ້ PostgreSQL, ເບິ່ງ ການຕັ້ງຄ່າຖານຂໍ້ມູນສຳລັບ Weblate ສຳລັບການຕັ້ງຄ່າທີ່ພ້ອມສຳລັບ production):

   weblate migrate
   

   See also

   migrate

4. ສ້າງບັນຊີຜູ້ໃຊ້ຜູ້ບໍລິຫານ admin, ສ້າງລະຫັດຜ່ານ, ແລະ ຄັດລອກມັນໄວ້ໃນ clipboard; ຈື່ໄວ້ວ່າໃຫ້ບັນທຶກມັນໄວ້ໃຊ້ໃນພາຍຫຼັງ:

   weblate createadmin
   

   Hint

   ຖ້າທ່ານພາດ/ເຮັດລະຫັດຜ່ານ admin ຫາຍໄປກ່ອນໜ້ານີ້, ທ່ານສາມາດສ້າງອັນໃໝ່ໄດ້ດ້ວຍຄຳສັ່ງຕໍ່ໄປນີ້:

   weblate createadmin --update
   

   See also

   createadmin

5. ເກັບກຳໄຟລ໌ static ສຳລັບເວັບເຊີບເວີຂອງທ່ານ (ເບິ່ງ ການແລ່ນເຊີບເວີ ແລະ ການໃຫ້ບໍລິການໄຟລ໌ Static):

   weblate collectstatic
   

6. ເລີ່ມຕົ້ນ Celery workers. ສິ່ງນີ້ບໍ່ຈຳເປັນສຳລັບຈຸດປະສົງການພັດທະນາ, ແຕ່ແນະນຳຢ່າງຍິ່ງຖ້າບໍ່ແມ່ນ. ວຽກງານເບື້ອງຫຼັງໂດຍໃຊ້ Celery ມີຂໍ້ມູນເພີ່ມເຕີມ:

   celery --app=weblate.utils worker --beat --queues=celery,notify,memory,translate,backup
   

7. ເລີ່ມຕົ້ນເຊີບເວີການພັດທະນາ (ການແລ່ນເຊີບເວີ ມີລາຍລະອຽດການຕັ້ງຄ່າ production):

   weblate runserver
   

ຫຼັງຈາກການຕິດຕັ້ງ

ຂໍສະແດງຄວາມຍິນດີ, ເຊີບເວີ Weblate ຂອງທ່ານກຳລັງແລ່ນຢູ່ແລ້ວ ແລະ ທ່ານສາມາດເລີ່ມໃຊ້ງານໄດ້.

• ດຽວນີ້ທ່ານສາມາດເຂົ້າເຖິງ Weblate ໄດ້ທີ່ http://localhost:8000/.

• ເຂົ້າສູ່ລະບົບດ້ວຍ admin credentials ທີ່ໄດ້ໃນລະຫວ່າງການຕິດຕັ້ງ ຫຼື ລົງທະບຽນດ້ວຍຜູ້ໃຊ້ໃໝ່.

• ດຽວນີ້ທ່ານສາມາດຮັນຄຳສັ່ງ Weblate ໂດຍໃຊ້ຄຳສັ່ງ weblate ເມື່ອ Weblate Python environment ເປີດໃຊ້ງານຢູ່, ເບິ່ງ ຄຳສັ່ງຈັດການ.

• ທ່ານສາມາດຢຸດເຊີບເວີທົດສອບໄດ້ດ້ວຍ Ctrl+C.

• ທົບທວນບັນຫາທີ່ອາດເກີດຂຶ້ນກັບການຕິດຕັ້ງຂອງທ່ານບໍ່ວ່າຈະຢູ່ URL /manage/performance/ (ເບິ່ງ ລາຍງານປະສິດທິພາບ) ຫຼື ໂດຍໃຊ້ weblate check --deploy, ເບິ່ງ ການຕັ້ງຄ່າໃນການຜະລິດ (Production).

ການເພີ່ມການແປ

1. ເປີດ admin interface (http://localhost:8000/create/project/) ແລະ ສ້າງໂປຣເຈັກທີ່ທ່ານຕ້ອງການແປ. ເບິ່ງ ການຕັ້ງຄ່າໂຄງການ ສຳລັບລາຍລະອຽດເພີ່ມເຕີມ.

   ທັງໝົດທີ່ທ່ານຕ້ອງລະບຸທີ່ນີ້ແມ່ນຊື່ໂປຣເຈັກ ແລະ ເວັບໄຊຂອງມັນ.

2. ສ້າງ component ເຊິ່ງເປັນວັດຖຸທີ່ແທ້ຈິງສຳລັບການແປ - ມັນຊີ້ໄປຍັງ VCS repository, ແລະ ເລືອກໄຟລ໌ໃດທີ່ຈະແປ. ເບິ່ງ ການຕັ້ງຄ່າ Component ສຳລັບລາຍລະອຽດເພີ່ມເຕີມ.

   ຊ່ອງຂໍ້ມູນທີ່ສຳຄັນທີ່ນີ້ແມ່ນ: ຊື່ຄອມໂພເນນ, ຄັງເກັບຊອດໂຄ້ດ, ແລະ ໜ້າກາກໄຟລ໌ ສຳລັບການຄົ້ນຫາໄຟລ໌ທີ່ສາມາດແປໄດ້. Weblate ຮອງຮັບຮູບແບບຫຼາກຫຼາຍລວມທັງ GNU gettext PO (Portable Object), Android string resources, Apple iOS strings, Java properties, ຮູບແບບ Stringsdict ຫຼື ຮູບແບບ Fluent, ເບິ່ງ ຮູບແບບໄຟລ໌ການແປພາສາ ສຳລັບລາຍລະອຽດເພີ່ມເຕີມ.

3. ເມື່ອຂັ້ນຕອນຂ້າງເທິງສຳເລັດ (ມັນອາດເປັນຂະບວນການທີ່ຍາວນານຂຶ້ນຢູ່ກັບຂະໜາດຂອງ VCS repository ຂອງທ່ານ, ແລະ ຈຳນວນຂໍ້ຄວາມທີ່ຈະແປ), ທ່ານສາມາດເລີ່ມການແປໄດ້.