Memasang di macOS¶

Persyaratan perangkat keras¶

Weblate seharusnya dapat berjalan pada perangkat keras apa pun saat ini tanpa masalah, berikut ini adalah konfigurasi minimal yang diperlukan untuk menjalankan Weblate pada hos tunggal (Weblate, basis data, dan server web):

RAM 3 GB
2 inti CPU
Ruang penyimpanan 1 GB

Catatan

Persyaratan sebenarnya untuk pemasangan Weblate Anda sangat bervariasi berdasarkan ukuran terjemahan yang dikelola di dalamnya.

Penggunaan memori¶

Semakin besar memori, semakin baik - memori tersebut digunakan untuk penyimpanan di semua tingkatan (sistem berkas, basis data, dan Weblate). Untuk ratusan komponen terjemahan, RAM minimal 4 GB direkomendasikan.

Petunjuk

Untuk sistem dengan memori lebih sedikit dari yang direkomendasikan, Pengaturan Celery proses tunggal direkomendasikan.

Penggunaan CPU¶

Banyak pengguna bersamaan meningkatkan jumlah inti CPU yang diperlukan.

Penggunaan penyimpanan¶

Penggunaan penyimpanan basis data pada umumnya adalah sekitar 300 MB per 1 juta kata yang dihos.

Ruang penyimpanan yang dibutuhkan untuk repositori kloning bervariasi, tetapi Weblate mencoba menjaga ukurannya tetap minimal dengan melakukan kloning dangkal.

Simpul¶

Untuk situs berukuran kecil dan menengah (jutaan kata yang dihos), semua komponen Weblate (lihat Ikhtisar arsitektur) dapat dijalankan pada satu simpul.

Saat jumlah kata yang dihos mencapai ratusan juta, sebaiknya miliki simpul khusus untuk basis data (lihat Pengaturan basis data untuk Weblate).

Pemasangan¶

Persyaratan sistem¶

Pasang dependensi yang diperlukan untuk membangun modul Python (lihat Persyaratan perangkat lunak):

brew install python pango cairo gobject-introspection glib libyaml pkgconf zstd lz4 xxhash libxmlsec1 librsvg uv

Anda dapat memasang perangkat lunak untuk menjalankan server produksi secara opsional, lihat Menjalankan server, Pengaturan basis data untuk Weblate, Tugas latar belakang menggunakan Celery. Tergantung pada ukuran pemasangan Anda, Anda mungkin ingin menjalankan komponen ini di server khusus.

Petunjuk pemasangan lokal:

# 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 for the msgmerge add-on
brew install gettext

Modul Python¶

Petunjuk

We're installing Weblate in a separate Python environment.

Buat lingkungan Python untuk Weblate:
```
uv venv ~/weblate-env
```
Aktifkan lingkungan Python untuk Weblate:
```
. ~/weblate-env/bin/activate
```
Pasang Weblate termasuk semua dependensi opsional:
```
# Install Weblate with all optional dependencies
uv pip install "weblate[all]"
```
Silakan periksa Dependensi Python untuk penyempurnaan dependensi opsional.

Lihat juga

Mengkonfigurasikan Weblate¶

Catatan

The following assumes the Python environment used by Weblate is activated (by executing . ~/weblate-env/bin/activate). If not, specify the full path to the weblate command as ~/weblate-env/bin/weblate.

Salin berkas ~/weblate-env/lib/python3.9/site-packages/weblate/settings_example.py ke ~/weblate-env/lib/python3.9/site-packages/weblate/settings.py.
Sesuaikan nilai dalam berkas settings.py yang baru sesuai keinginan Anda. Anda perlu memberikan setidaknya kredensial basis data dan kunci rahasia Django, tetapi Anda akan memerlukan lebih banyak perubahan untuk pengaturan produksi, lihat Menyesuaikan konfigurasi.
Buat basis data dan strukturnya untuk Weblate (pengaturan contoh menggunakan PostgreSQL, periksa Pengaturan basis data untuk Weblate untuk penyiapan siap produksi):
```
weblate migrate
```
Lihat juga

migrate
Buat akun pengguna administrator admin, buat kata sandinya, dan salin ke papan klip; ingat untuk menyimpannya untuk digunakan nanti:
```
weblate createadmin
```
Petunjuk

Jika sebelumnya Anda lupa/hilang kata sandi admin, Anda dapat membuat kata sandi baru dengan perintah berikut:
```
weblate createadmin --update
```
Lihat juga

createadmin
Kumpulkan berkas statis untuk server web Anda (lihat Menjalankan server dan Menyajikan berkas statis):
```
weblate collectstatic
```
Kompres berkas JavaScript dan CSS (opsional, lihat Mengompres aset klien):
```
weblate compress
```
Jalankan pekerja Celery. Ini tidak wajib untuk tujuan pengembangan, tetapi sangat disarankan untuk tujuan lain. Tugas latar belakang menggunakan Celery memiliki informasi lebih lanjut:
```
celery --app=weblate.utils worker --beat --queues=celery,notify,memory,translate,backup
```
Mulai server pengembangan (Menjalankan server merinci penyiapan produksi):
```
weblate runserver
```

Setelah pemasangan¶

Selamat, server Weblate Anda sekarang sudah berjalan dan Anda dapat mulai menggunakannya.

Anda sekarang dapat mengakses Weblate di http://localhost:8000/.
Masuk dengan kredensial admin yang diperoleh selama pemasangan atau daftar dengan pengguna baru.
You can now run Weblate commands using weblate command when Weblate Python environment is active, see Perintah pengelolaan.
Anda dapat menghentikan server pengujian dengan Ctrl+C.
Tinjau potensi isu dengan pemasangan Anda baik di URL /manage/performance/ (lihat Laporan kinerja) atau menggunakan weblate check --deploy, lihat Pengaturan produksi.

Menambahkan terjemahan¶

Buka antarmuka admin (http://localhost:8000/create/project/) dan buat proyek yang ingin Anda terjemahkan. Lihat Konfigurasi proyek untuk rincian lebih lanjut.

Yang perlu Anda spesifikasikan di sini adalah nama proyek dan situs webnya.
Buat komponen yang merupakan objek sebenarnya untuk terjemahan - komponen ini menunjuk ke repositori VCS, dan memilih berkas mana yang akan diterjemahkan. Lihat Konfigurasi komponen untuk rincian lebih lanjut.

Kolom-kolom penting di sini adalah: Nama komponen, Repositori kode sumber, dan Mask berkas untuk menemukan berkas yang dapat diterjemahkan. Weblate mendukung berbagai format, termasuk GNU gettext PO (Objek Portabel), Sumber daya string Android, String Apple iOS, Properti Java, Format Stringsdict, atau Format Fluent. Lihat Format berkas lokalisasi untuk rincian lebih lanjut.
Setelah hal di atas selesai (proses ini bisa memakan waktu lama tergantung pada ukuran repositori VCS Anda, dan jumlah pesan yang akan diterjemahkan), Anda dapat mulai menerjemahkan.