[ English | Indonesia | 日本語 | русский | 한국어 (대한민국) | Deutsch ]
Как проверять переводы¶
Очень важно проверять ваши переводы в реальных ситуациях, чтобы у вас была возможность видеть, в каком контексте используется ваш перевод. На этой странице описаны способы проверки своих переводов для разных категорий документов.
Документация¶
С использованием docs.openstack.org¶
Переведённые документы доступны на ежедневно обновляющемся сайте документации OpenStack. Бо́льшая часть материала на нём доступна по следующему адресу:
http://docs.openstack.org/<lang> содержит опубликованные документы. Кликните по выпадающему списку «Languages» («Языки») на станице http://docs.openstack.org/.
Для сборки переведённого документа, ван нужно будет обновить файл doc-tools-check-languages.conf
в каждом репозитории, и добавить к BOOKS
примерно такую строку: ["ja"]="install-guide"
.
Для документов в стабильной ветке, например для руководства по установке Liberty, вам потребуется обновить файл doc-tools-check-languages.conf
непосредственно в нужной вам ветке.
Вы можете проверить сгенерированный документ для заданной вами ветки, пройдя по ссылке http://docs.openstack.org/<branch>/<language>/<document>. Например, ссылка на японскую «Инструкцию по развёртыванию на Ubuntu» для Liberty будет выглядеть как http://docs.openstack.org/liberty/ja/install-guide-ubuntu/.
Чтобы добавить ссылку на сгенерированный документ, вам нужно будет обновить файл www/<lang>/index.html
в master
ветке репозитория openstack-manuals
. Обратите внимание, что веб странички публикуются из ветки master
, которая содержит страницы для всех релизов, например, для Liberty. Таким образом, вам нет необходимости обновлять файл www/<lang>/index.html
в стабильной ветке.
Так же вы можете посмотреть информацию по следующим ссылкам:
Документация разработчика OpenStack¶
В настоящий момент мы не переводим документацию для разработчиков OpenStack: http://docs.openstack.org/<project>
Панель управления OpenStack¶
Работа с OpenStack-Ansible¶
Проект OpenStack-Ansible (OSA) предоставляет плейбуки и роли Ansible для развёртывания и настройки сред OpenStack. Как часть этого проекта был разработан сервис «Сайт проверки переводов» («Translation Check Site»). Инстанс OSA загружает полежащие переводу строки платформы переводов, компилирует их, и делает их доступными для просмотра в Horizon. Для запуска OSA вам понадобится компьютер с двумя или четырьмя процессорными ядрами, как минимум 8ГБ оперативной памяти, и жёстким диском на 70ГБ.
$ 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
Вы можете настроить компоненты вашей инсталляции AIO в файле tests/vars/bootstrap-aio-vars.yml
. В зависимости от среды, инсталляция займёт 1-2 часа. Дополнительную информацию о настройке AIO вы можете посмотреть в Документации OSA AIO.
Для регулярного обновления переведённых файлов, запускайте эту команду вручную, или через 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"
Запуск DevStack¶
Другим удобным способом проверить перевод панелей управления - это запустить DevStack в вашей локальной среде. Чтобы запустить DevStack, вам нужно будет подготовить файл local.conf
, что сделать совсем не сложно. Несколько разных файлов local.conf
можно найти в Интернете, и минималистичный пример приведён ниже. По нашему опыту, для запуска DevStack вам понадобится компьютер с двумя или четырьмя процесорными ядрами, 8 ГБ оперативной памяти и 20 ГБ жёстким диском. Если вы запускаете только основные компоненты OpenStack, то компьютеру может быть достаточно 2~4 ГБ оперативной памяти.
$ 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>
Замените $BRANCH
именем нужной вам ветки, например master
, stable/newton
или stable/mitaka
.
Ниже приведён пример файла local.conf
для релиза Newton, в котором запускаются основные компоненты (keystone, nova, glance, neutron, cinder), horizon, swift и heat. Выбраны компоненты, которые поддерживаются основным кодом horizon.
[[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
Импортируйте последние выполненные переводы¶
Переводы импортируются в репозитории проектов ежедневно, таким образом, в большинстве случаев, вам нет необходимости загружать переводы с Zanata вручную. Всё, что вам нужно сделать, так это загрузить свежий код панели управления Horizon.
Если у вас есть компьютер, на котором работает DevStack, то у вас есть два варианта действий.
Первый вариант - это обновлять только код панели управления Horizon. Нижеприведённый Shell скрипт загружает свежий код панели управления Horizon, выполняет компиляцию каталогов переводов, и перезагружает веб-сервер Apache httpd. Замените $BRANCH
названием нужной вам ветки, например, master
, stable/newton
или 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
Другой способ - это перезапустить DevStack. Убедитесь, что вы включили параметр RECLONE=True
в ваш файл local.conf
до повторного запуска stack.sh
, и тогда DevStack загрузит свежий код панели управления Horizon и других проектов.
$ cd devstack
$ ./unstack.sh
<Ensure RECLONE=True in your local.conf>
$ ./stack.sh
<It takes 10 or 15 minutes>
CLI (интерфейс командной строки)¶
(будет обновлено позже)
Серверные проекты¶
(будет обновлено позже)