Download - Apache CloudStack 日本語ドキュメント翻訳会資料
![Page 1: Apache CloudStack 日本語ドキュメント翻訳会資料](https://reader037.vdocuments.pub/reader037/viewer/2022100507/55781474d8b42ab40c8b489c/html5/thumbnails/1.jpg)
Apache CloudStackJapanese Doc SprintCloudStackユーザー会 千葉 豪
@go_chiba
![Page 2: Apache CloudStack 日本語ドキュメント翻訳会資料](https://reader037.vdocuments.pub/reader037/viewer/2022100507/55781474d8b42ab40c8b489c/html5/thumbnails/2.jpg)
千葉 豪(Go Chiba)– 某SIerでクラウド系エンジニアやってます
– Apache CloudStackの日本語翻訳担当プライベートでドキュメントの翻訳活動中気づいたらコミッターなってました…
– 連絡先mailto: [email protected]: @go_chiba
自己紹介
![Page 3: Apache CloudStack 日本語ドキュメント翻訳会資料](https://reader037.vdocuments.pub/reader037/viewer/2022100507/55781474d8b42ab40c8b489c/html5/thumbnails/3.jpg)
現在以下のプロジェクトが進行中– 公式ドキュメントの日本語化(Apache CloudStack Docs)– GUIの日本語化(Apache CloudStack UI)– Runbook(クイックインストールガイド)の日本語化
(Apache CloudStack Runbook)
翻訳対象
![Page 4: Apache CloudStack 日本語ドキュメント翻訳会資料](https://reader037.vdocuments.pub/reader037/viewer/2022100507/55781474d8b42ab40c8b489c/html5/thumbnails/4.jpg)
Transifex(https://www.transifex.com)による翻訳
各セクションの表示
オリジナルのドキュメント
翻訳されたドキュメント
翻訳内容のレコメンド
翻訳作業
![Page 5: Apache CloudStack 日本語ドキュメント翻訳会資料](https://reader037.vdocuments.pub/reader037/viewer/2022100507/55781474d8b42ab40c8b489c/html5/thumbnails/5.jpg)
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
実際に出来たものを確認
![Page 6: Apache CloudStack 日本語ドキュメント翻訳会資料](https://reader037.vdocuments.pub/reader037/viewer/2022100507/55781474d8b42ab40c8b489c/html5/thumbnails/6.jpg)
実際に出来たものを確認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
![Page 7: Apache CloudStack 日本語ドキュメント翻訳会資料](https://reader037.vdocuments.pub/reader037/viewer/2022100507/55781474d8b42ab40c8b489c/html5/thumbnails/7.jpg)
6.生成物の確認# ls tmp/ja-JP/*
PMCであるSebastienの資料もチェックhttp://www.slideshare.net/sebastiengoasguen/how-to-translate-apache-cloudstack-docs
実際に出来たものを確認
![Page 8: Apache CloudStack 日本語ドキュメント翻訳会資料](https://reader037.vdocuments.pub/reader037/viewer/2022100507/55781474d8b42ab40c8b489c/html5/thumbnails/8.jpg)
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
![Page 9: Apache CloudStack 日本語ドキュメント翻訳会資料](https://reader037.vdocuments.pub/reader037/viewer/2022100507/55781474d8b42ab40c8b489c/html5/thumbnails/9.jpg)
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">
![Page 10: Apache CloudStack 日本語ドキュメント翻訳会資料](https://reader037.vdocuments.pub/reader037/viewer/2022100507/55781474d8b42ab40c8b489c/html5/thumbnails/10.jpg)
コードと同様にJIRAに報告 Typoレベルでもウェルカムです
– Port番号の間違い、スペルミス etc…
ドキュメントバグ
![Page 11: Apache CloudStack 日本語ドキュメント翻訳会資料](https://reader037.vdocuments.pub/reader037/viewer/2022100507/55781474d8b42ab40c8b489c/html5/thumbnails/11.jpg)
Docsの今後 4.2では…?― 新しいドキュメントが追加中
Midonet Pluginに関してGSoC固有ドキュメント など
レビューワーも募集中?― 単語の統一
VM? 仮想マシン?プライマリー? プライマリ?
― コピペミス&PRODUCT; CloudPlatform
― URL等のチェック