Apache CloudStack 日本語ドキュメント翻訳会で利用した資料になります

1. Apache CloudStack
Japanese Doc Sprint
CloudStackユーザー会 千葉 豪
@go_chiba

2.  千葉 豪(Go Chiba)
– 某SIerでクラウド系エンジニアやってます
– Apache CloudStackの日本語翻訳担当
プライベートでドキュメントの翻訳活動中
気づいたらコミッターなってました…
– 連絡先
mailto: go.chiba@gmail.com
Twitter: @go_chiba
自己紹介

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

4.  Transifex(https://www.transifex.com)による翻訳
各セクション
の表示
オリジナルの
ドキュメント
翻訳された
ドキュメント
翻訳内容の
レコメンド
翻訳作業

5.  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
実際に出来たものを確認

6. 実際に出来たものを確認
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

7. 6.生成物の確認
# ls tmp/ja-JP/*
PMCであるSebastienの資
料もチェック
http://
www.slideshare.net/seba
stiengoasguen/how-to-tr
anslate-apache-cloudsta
ck-docs
実際に出来たものを確認

8.  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

9.  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">

10.  コードと同様にJIRAに報告
 Typoレベルでもウェルカムです
– Port番号の間違い、スペルミス etc…
ドキュメントバグ

11. Docsの今後
 4.2では…?
― 新しいドキュメントが追加中
Midonet Pluginに関して
GSoC固有ドキュメント など
 レビューワーも募集中?
― 単語の統一
VM? 仮想マシン?
プライマリー? プライマリ?
― コピペミス
&PRODUCT; CloudPlatform
― URL等のチェック