Apache CloudStackJapanese Doc SprintCloudStackユーザー会　千葉 豪

@go_chiba

千葉 豪(Go Chiba)– 某SIerでクラウド系エンジニアやってます

– Apache CloudStackの日本語翻訳担当プライベートでドキュメントの翻訳活動中気づいたらコミッターなってました…

– 連絡先mailto: go.chiba@gmail.comTwitter: @go_chiba

自己紹介

現在以下のプロジェクトが進行中– 公式ドキュメントの日本語化(Apache CloudStack Docs)– GUIの日本語化(Apache CloudStack UI)– Runbook(クイックインストールガイド)の日本語化

(Apache CloudStack Runbook)

翻訳対象

Transifex(https://www.transifex.com)による翻訳

各セクションの表示

オリジナルのドキュメント

翻訳されたドキュメント

翻訳内容のレコメンド

翻訳作業

Publicanで自分が翻訳した内容を確認(CentOS 6.3上で確認)1. 必要なツール群をインストール

2. CloudStackをリポジトリからcloneし4.1をcheckout

3. 共通のコンテンツ(画像など)をインストール

# yum install git rpm-build python-setuptools publican# easy_install transifex-client

# git clone https://git-wip-us.apache.org/repos/asf/cloudstack.git# git checkout 4.1

# cd cloudstack/docs/publican-cloudstack# ./gen_rpm.sh# rpm –i ~/rpmbuild/RPMS/noarch/publican-cloudstack-0.6-1.el6.noarch.rpm

実際に出来たものを確認

実際に出来たものを確認4. transifex の設定とpoファイルのpull

5. publicanを実行

設定ファイル: all, adminguide, devguide, installation, niciranvp, release-noteフォーマット: html, html-single, pdf, epub　　　　　　　　　 　　　

# cd cloudstack/docs# tx init# ./settx.sh# tx pull –l ja_JP

# publican build --config=publican-all.cfg --formats=html,pdf --langs=ja-JP

6.生成物の確認# ls tmp/ja-JP/*

PMCであるSebastienの資料もチェックhttp://www.slideshare.net/sebastiengoasguen/how-to-translate-apache-cloudstack-docs

実際に出来たものを確認

Publicanで見られるエラー– 重複定義

cloudstack/docs/en-USより以下のように重複箇所をコメントアウトしてみましょう

api-throttling.xml:6: validity error : ID api-throttling already defined

とらぶるしゅ〜と

$ grep '<xi:include href="api-throttling.xml"' *api-calls.xml: <xi:include href="api-throttling.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />sys-reliability-and-ha.xml: <xi:include href="api-throttling.xml" xmlns:xi="http://www.w3.org/2001/XInclude" />

api-throttling.xml:6: validity error : ID api-throttling already defined

Publicanで見られるエラー– リンク切れ

定義箇所を特定

configure-package-repository.xml:28: validity error : IDREF attribute linkend references an unknown ID "sect-source-buildrpm"1

とらぶるしゅ〜と

$ grep '<section id="sect-source-buildrpm">' *build-rpm.xml:<section id="sect-source-buildrpm">

コードと同様にJIRAに報告 Typoレベルでもウェルカムです

– Port番号の間違い、スペルミス etc…

ドキュメントバグ

Docsの今後 4.2では…?― 新しいドキュメントが追加中

Midonet Pluginに関してGSoC固有ドキュメント など

レビューワーも募集中?― 単語の統一

VM? 仮想マシン?プライマリー? プライマリ?

― コピペミス&PRODUCT; CloudPlatform

― URL等のチェック