[ English | русский | 日本語 | 中文 (简体, 中国) | English (United Kingdom) | Deutsch | Indonesia | 한국어 (대한민국) ]

Bagaimana cara memeriksa terjemahan

It is important to validate your translations by applying them in a real situation where they are rendered and visualized. This page describes how to check your translations.

Catatan

translation check refers to build OpenStack artifacts with translated strings and check how the translated strings are shown on an actual screen as part of the translation process.

Dokumentasi

Translated documents are available at the OpenStack Documentation site. It is updated daily. Most contents are linked from:

The documents are maintained in the doc directory using reStructuredText and built by Sphinx. Translated strings are stored as Gettext PO file format in locale/<lang>/LC_MESSAGES directory.

Documents on openstack-manuals

For OpenStack documentation, openstack-manuals git repository hosts essential OpenStack documents such as Installation Guide, and Virtual Machine Image Guide.

To build a translated document on this repository, you need to update the file doc-tools-check-languages.conf in each repository, and add an entry to BOOKS like ["ja"]="install-guide".

Untuk dokumen di branch stabil, seperti panduan instalasi untuk Liberty, Anda perlu memperbarui file doc-tools-check-languages.conf di branch stabil target secara langsung.

You can check a generated document for a specified branch on https://docs.openstack.org/<branch>/<language>/<document>. For example, the link of Japanese Ubuntu Installation Guide for Liberty is https://docs.openstack.org/liberty/ja/install-guide-ubuntu/.

Untuk menambahkan link ke dokumen yang dihasilkan, Anda perlu memperbarui file `` www / <lang> / index.html`` di cabang master dari repository `` openstack-manuals``. Perhatikan bahwa halaman web diterbitkan dari cabang `` master``, yang berisi halaman untuk semua rilis, seperti Liberty. Oleh karena itu, Anda tidak perlu mengupdate file `` www / <lang> / index.html`` di cabang yang stabil.

Anda juga dapat memeriksa:

OpenStack project documentation

Currently, we support translations for small set of OpenStack project documentations like Horizon, OpenStack-Ansible, and OpenStack-Helm upon requests and available bandwidth. Top-level directory structure on doc/source/ follows with Documentation Contributor Guide - Project guide setup and the corresponding generated documents for master branch are available at https://docs.openstack.org/<project>/latest/<language>/<document> URL. For project team documents in stable branch, you can check the documents with https://docs.openstack.org/<project>/<branch>/<language>/<document> URL.

Here are sample document links as examples:

Dasbor OpenStack

Menjalankan OpenStack-Ansible

OpenStack-Ansible (OSA) menyediakan playbook dan peran Ansible untuk penyebaran dan konfigurasi lingkungan OpenStack. Sebagai bagian dari proyek, sebuah fitur bernama 'Translation Check Site' dikembangkan. Instance OSA akan mengambil string terjemahan dari ``translation platform <https://translate.openstack.org/>` __, mengkompilasi dan melayani string ini di Horizon. Anda memerlukan mesin dengan dua atau empat core CPU, setidaknya 8 GB memori dan 70 GB disk untuk menjalankan OSA.

$ BRANCH=master
$ git clone -b ${BRANCH} https://github.com/openstack/openstack-ansible /opt/openstack-ansible
$ cd /opt/openstack-ansible
$ ./scripts/gate-check-commit.sh translations

Anda dapat mengatur komponen instalasi AIO Anda dalam tests/vars/bootstrap-aio-vars.yml. Tergantung pada lingkungan Anda, instalasi membutuhkan waktu 1-2 jam. Untuk detail lebih lanjut tentang konfigurasi AIO, silakan lihat OSA AIO documentation <https://docs.openstack.org/openstack-ansible/latest/user/aio/quickstart.html#building-an-aio> _.

Untuk mengambil file yang diterjemahkan secara teratur, jalankan perintah ini secara manual atau sebagai cron:

$ cd /opt/openstack-ansible/playbooks; \
  openstack-ansible os-horizon-install.yml \
  -e horizon_translations_update=True \
  -e horizon_translations_project_version=master \
  --tags "horizon-config"

Menjalankan DevStack

Cara lain yang mudah adalah dengan mengecek dashboard translations yaitu dengan menjalankan DevStack di lingkungan lokal anda. Untuk menjalankan DevStack, Anda perlu menyiapkan file local.conf, tapi jangan khawatir. Beberapa file local.conf dibagikan di Internet dan contoh minimum ditunjukkan di bawah ini. Dari pengalaman kami, Anda memerlukan mesin dengan dua atau empat core CPU, memori 8 GB dan 20 GB disk untuk menjalankan DevStack dengan nyaman. Jika Anda hanya mengaktifkan proyek OpenStack utama, persyaratan mesin akan jauh lebih kecil seperti memori 2 ~ 4GB.

$ BRANCH=master
$ git clone https://opendev.org/openstack/devstack.git
$ cd devstack
$ git checkout $BRANCH
<prepare local.conf>
$ ./stack.sh
<wait and wait... it takes 20 or 30 minutes>

Ganti $BRANCH dengan cabang yang sesuai seperti master, stable/newton atau stable/mitaka.

Berikut ini adalah contoh local.conf untuk pelepasan Newton yang menjalankan komponen inti (keystone, nova, glance, neutron, cinder), horizon, swift and heat. Komponen dipilih adalah komponen yang mendukung kode horizon utama.

[[local|localrc]]
BRANCH=stable/newton
# NOTE: We need to specify a branch explicitly until DevStack stable branch
# is prepared. At now, swift has no stable/newton branch.
CINDER_BRANCH=$BRANCH
GLANCE_BRANCH=$BRANCH
HEAT_BRANCH=$BRANCH
HORIZON_BRANCH=$BRANCH
KEYSTONE_BRANCH=$BRANCH
NEUTRON_BRANCH=$BRANCH
NOVA_BRANCH=$BRANCH
SWIFT_BRANCH=master

# When OS_CLOUD envvar is set, DevStack will be confused.
unset OS_CLOUD

# Ensure to fetch the latest repository when rerunning DevStack
RECLONE=True

# Translation check site usually does not use tempest.
disable_service tempest

enable_service heat h-api h-api-cfn h-api-cw h-eng
enable_service s-proxy s-object s-container s-account

enable_plugin neutron https://git.openstack.org/openstack/neutron $BRANCH
enable_service q-qos

enable_plugin neutron-vpnaas https://git.openstack.org/openstack/neutron-vpnaas $BRANCH

LOGFILE=$DEST/logs/devstack.log
SCREEN_HARDSTATUS="%{= rw} %H %{= wk} %L=%-w%{= bw}%30L> %n%f %t*%{= wk}%+Lw%-17< %-=%{= gk} %y/%m    /%d %c"
LOGDAYS=2
IDENTITY_API_VERSION=3

ADMIN_PASSWORD=change_me
MYSQL_PASSWORD=change_me
RABBIT_PASSWORD=change_me
SERVICE_PASSWORD=change_me

Impor terjemahan terbaru

Terjemahan sedang diimpor ke repositori proyek setiap hari, jadi dalam kebanyakan kasus Anda tidak perlu menarik terjemahan dari Zanata secara manual. Yang Anda butuhkan adalah menarik kode horizon terbaru.

Jika Anda memiliki mesin yang menjalankan DevStack, ada dua cara.

Salah satunya adalah dengan mengupdate kode horizon saja. Skrip shell berikut mengambil kode horizon terbaru, menyusun katalog pesan terjemahan dan memuat kembali server httpd apache. Ganti $BRANCH dengan cabang yang sesuai seperti master, stable/newton atau stable/mitaka.

#!/bin/bash

# Target branch: master, stable/pike, ...
BRANCH=stable/pike

cd /opt/stack/horizon

# Remove stale compiled python files
find horizon -name '*.pyc' | xargs rm
find openstack_dashboard -name '*.pyc' | xargs rm

# Fetch the latest code from git
git checkout $BRANCH
git remote update origin
git merge origin/$BRANCH

python manage.py compilemessages
python manage.py collectstatic --noinput
python manage.py compress --force
sudo service apache2 reload

Cara lain adalah dengan memutarkan kembali DevStack. Pastikan untuk menyertakan RECLONE=True di `` local.conf`` Anda sebelum menjalankan stack.sh lagi sehingga DevStack mengambil kode horizon dan proyek terbaru lainnya.

$ cd devstack
$ ./unstack.sh
<Ensure RECLONE=True in your local.conf>
$ ./stack.sh
<It takes 10 or 15 minutes>

CLI (command line interface)

TBD

Proyek server

TBD